diff --git a/keyboards/keychron/common/common.mk b/keyboards/keychron/common/common.mk
new file mode 100644
index 0000000000..d7610bce69
--- /dev/null
+++ b/keyboards/keychron/common/common.mk
@@ -0,0 +1,4 @@
+COMMON_DIR = common
+SRC += $(COMMON_DIR)/matrix.c
+
+VPATH += $(TOP_DIR)/keyboards/keychron/$(COMMON_DIR)
diff --git a/keyboards/keychron/common/factory_test.c b/keyboards/keychron/common/factory_test.c
new file mode 100644
index 0000000000..655e6b10aa
--- /dev/null
+++ b/keyboards/keychron/common/factory_test.c
@@ -0,0 +1,450 @@
+/* Copyright 2021 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "raw_hid.h"
+#include "via.h"
+
+#include "keychron_task.h"
+#ifdef LK_WIRELESS_ENABLE
+# include "transport.h"
+# include "battery.h"
+# include "lpm.h"
+# include "lkbt51.h"
+# include "indicator.h"
+#endif
+#include "config.h"
+#include "version.h"
+
+#ifndef RAW_EPSIZE
+# define RAW_EPSIZE 32
+#endif
+
+#ifndef BL_CYCLE_KEY
+# define BL_CYCLE_KEY KC_RIGHT
+#endif
+
+#ifndef BL_TRIG_KEY
+# define BL_TRIG_KEY KC_HOME
+#endif
+
+#ifndef P2P4G_CELAR_MASK
+# define P2P4G_CELAR_MASK P2P4G_CLEAR_PAIRING_TYPE_C
+#endif
+
+enum {
+ BACKLIGHT_TEST_OFF = 0,
+ BACKLIGHT_TEST_WHITE,
+ BACKLIGHT_TEST_RED,
+ BACKLIGHT_TEST_GREEN,
+ BACKLIGHT_TEST_BLUE,
+ BACKLIGHT_TEST_MAX,
+};
+
+enum {
+ KEY_PRESS_FN = 0x01 << 0,
+ KEY_PRESS_J = 0x01 << 1,
+ KEY_PRESS_Z = 0x01 << 2,
+ KEY_PRESS_BL_KEY1 = 0x01 << 3,
+ KEY_PRESS_BL_KEY2 = 0x01 << 4,
+ KEY_PRESS_FACTORY_RESET = KEY_PRESS_FN | KEY_PRESS_J | KEY_PRESS_Z,
+ KEY_PRESS_BACKLIGTH_TEST = KEY_PRESS_FN | KEY_PRESS_BL_KEY1 | KEY_PRESS_BL_KEY2,
+};
+
+enum {
+ FACTORY_TEST_CMD_BACKLIGHT = 0x01,
+ FACTORY_TEST_CMD_OS_SWITCH,
+ FACTORY_TEST_CMD_JUMP_TO_BL,
+ FACTORY_TEST_CMD_INT_PIN,
+ FACTORY_TEST_CMD_GET_TRANSPORT,
+ FACTORY_TEST_CMD_CHARGING_ADC,
+ FACTORY_TEST_CMD_RADIO_CARRIER,
+ FACTORY_TEST_CMD_GET_BUILD_TIME,
+ FACTORY_TEST_CMD_GET_DEVICE_ID
+};
+
+enum {
+ P2P4G_CLEAR_PAIRING_TYPE_A = 0x01 << 0,
+ P2P4G_CLEAR_PAIRING_TYPE_C = 0x01 << 1,
+};
+
+enum {
+ OS_SWITCH = 0x01,
+};
+
+static uint32_t factory_reset_timer = 0;
+static uint8_t factory_reset_state = 0;
+static uint8_t backlight_test_mode = BACKLIGHT_TEST_OFF;
+
+static uint32_t factory_reset_ind_timer = 0;
+static uint8_t factory_reset_ind_state = 0;
+static bool report_os_sw_state = false;
+static bool keys_released = true;
+
+void factory_timer_start(void) {
+ factory_reset_timer = timer_read32();
+}
+
+static inline void factory_timer_check(void) {
+ if (timer_elapsed32(factory_reset_timer) > 3000) {
+ factory_reset_timer = 0;
+
+ if (factory_reset_state == KEY_PRESS_FACTORY_RESET) {
+ factory_reset_ind_timer = timer_read32();
+ factory_reset_ind_state++;
+ keys_released = false;
+
+ clear_keyboard(); // Avoid key being pressed after NKRO state changed
+ layer_state_t default_layer_tmp = default_layer_state;
+ eeconfig_init();
+ keymap_config.raw = eeconfig_read_keymap();
+ default_layer_set(default_layer_tmp);
+#ifdef LED_MATRIX_ENABLE
+ if (!led_matrix_is_enabled()) led_matrix_enable();
+ led_matrix_init();
+#endif
+#ifdef RGB_MATRIX_ENABLE
+ if (!rgb_matrix_is_enabled()) rgb_matrix_enable();
+ rgb_matrix_init();
+#endif
+#ifdef LK_WIRELESS_ENABLE
+ lkbt51_factory_reset(P2P4G_CELAR_MASK);
+#endif
+ } else if (factory_reset_state == KEY_PRESS_BACKLIGTH_TEST) {
+#ifdef LED_MATRIX_ENABLE
+ if (!led_matrix_is_enabled()) led_matrix_enable();
+#endif
+#ifdef RGB_MATRIX_ENABLE
+ if (!rgb_matrix_is_enabled()) rgb_matrix_enable();
+#endif
+ backlight_test_mode = BACKLIGHT_TEST_WHITE;
+ }
+
+ factory_reset_state = 0;
+ }
+}
+
+static inline void factory_reset_ind_timer_check(void) {
+ if (factory_reset_ind_timer && timer_elapsed32(factory_reset_ind_timer) > 250) {
+ if (factory_reset_ind_state++ > 6) {
+ factory_reset_ind_timer = factory_reset_ind_state = 0;
+ } else {
+ factory_reset_ind_timer = timer_read32();
+ }
+ }
+}
+
+bool process_record_factory_test(uint16_t keycode, keyrecord_t *record) {
+ switch (keycode) {
+#if defined(FN_KEY_1) || defined(FN_KEY_2)
+# if defined(FN_KEY_1)
+ case FN_KEY_1: /* fall through */
+# endif
+# if defined(FN_KEY_2)
+ case FN_KEY_2:
+# endif
+# if defined(FN_KEY_3)
+ case FN_KEY_3:
+# endif
+ if (record->event.pressed) {
+ factory_reset_state |= KEY_PRESS_FN;
+ } else {
+ factory_reset_state &= ~KEY_PRESS_FN;
+ factory_reset_timer = 0;
+ }
+ break;
+#endif
+ case KC_J:
+ if (record->event.pressed) {
+ factory_reset_state |= KEY_PRESS_J;
+ if (factory_reset_state == 0x07) factory_timer_start();
+ if (factory_reset_state & KEY_PRESS_FN) return false;
+ } else {
+ factory_reset_state &= ~KEY_PRESS_J;
+ factory_reset_timer = 0;
+ }
+ break;
+ case KC_Z:
+#if defined(FN_Z_KEY)
+ case FN_Z_KEY:
+#endif
+ if (record->event.pressed) {
+ factory_reset_state |= KEY_PRESS_Z;
+ if (factory_reset_state == 0x07) factory_timer_start();
+ if ((factory_reset_state & KEY_PRESS_FN) && keycode == KC_Z) return false;
+ } else {
+ factory_reset_state &= ~KEY_PRESS_Z;
+ factory_reset_timer = 0;
+ /* Avoid changing backlight effect on key released if FN_Z_KEY is mode*/
+
+ if (!keys_released && keycode >= QK_BACKLIGHT_ON && keycode <= RGB_MODE_TWINKLE) {
+ keys_released = true;
+ return false;
+ }
+ }
+ break;
+#if defined(BL_CYCLE_KEY) || defined(BL_CYCLE_KEY_2)
+# if defined(BL_CYCLE_KEY)
+ case BL_CYCLE_KEY:
+# endif
+# if defined(FN_BL_CYCLE_KEY)
+ case FN_BL_CYCLE_KEY:
+# endif
+ if (record->event.pressed) {
+ if (backlight_test_mode) {
+ if (++backlight_test_mode >= BACKLIGHT_TEST_MAX) {
+ backlight_test_mode = BACKLIGHT_TEST_WHITE;
+ }
+ } else {
+ factory_reset_state |= KEY_PRESS_BL_KEY1;
+ if (factory_reset_state == 0x19) {
+ factory_timer_start();
+ }
+ }
+ } else {
+ factory_reset_state &= ~KEY_PRESS_BL_KEY1;
+ factory_reset_timer = 0;
+ }
+ break;
+#endif
+#if defined(BL_TRIG_KEY) || defined(BL_TRIG_KEY_2)
+# if defined(BL_TRIG_KEY)
+ case BL_TRIG_KEY:
+# endif
+# if defined(FN_BL_TRIG_KEY)
+ case FN_BL_TRIG_KEY:
+# endif
+ if (record->event.pressed) {
+ if (backlight_test_mode) {
+ backlight_test_mode = BACKLIGHT_TEST_OFF;
+ } else {
+ factory_reset_state |= KEY_PRESS_BL_KEY2;
+ if (factory_reset_state == 0x19) {
+ factory_timer_start();
+ }
+ }
+ } else {
+ factory_reset_state &= ~KEY_PRESS_BL_KEY2;
+ factory_reset_timer = 0;
+ }
+ break;
+#endif
+ }
+
+ return true;
+}
+
+#ifdef LED_MATRIX_ENABLE
+bool factory_test_indicator(void) {
+ if (factory_reset_ind_state) {
+ led_matrix_set_value_all(factory_reset_ind_state % 2 ? 0 : 255);
+ return false;
+ }
+
+ return true;
+}
+#endif
+
+#ifdef RGB_MATRIX_ENABLE
+bool factory_test_indicator(void) {
+ if (factory_reset_ind_state) {
+ backlight_test_mode = BACKLIGHT_TEST_OFF;
+ rgb_matrix_set_color_all(factory_reset_ind_state % 2 ? 0 : 255, 0, 0);
+ return false;
+ } else if (backlight_test_mode) {
+ switch (backlight_test_mode) {
+ case BACKLIGHT_TEST_WHITE:
+ rgb_matrix_set_color_all(255, 255, 255);
+ break;
+ case BACKLIGHT_TEST_RED:
+ rgb_matrix_set_color_all(255, 0, 0);
+ break;
+ case BACKLIGHT_TEST_GREEN:
+ rgb_matrix_set_color_all(0, 255, 0);
+ break;
+ case BACKLIGHT_TEST_BLUE:
+ rgb_matrix_set_color_all(0, 0, 255);
+ break;
+ }
+ return false;
+ }
+
+ return true;
+}
+#endif
+
+bool factory_reset_indicating(void) {
+ return factory_reset_ind_timer;
+}
+
+bool factory_test_task(void) {
+ if (factory_reset_timer) factory_timer_check();
+ if (factory_reset_ind_timer) factory_reset_ind_timer_check();
+
+ return true;
+}
+
+void factory_test_send(uint8_t *payload, uint8_t length) {
+#ifdef RAW_ENABLE
+ uint16_t checksum = 0;
+ uint8_t data[RAW_EPSIZE] = {0};
+
+ uint8_t i = 0;
+ data[i++] = 0xAB;
+
+ memcpy(&data[i], payload, length);
+ i += length;
+
+ for (uint8_t i = 1; i < RAW_EPSIZE - 3; i++)
+ checksum += data[i];
+ data[RAW_EPSIZE - 2] = checksum & 0xFF;
+ data[RAW_EPSIZE - 1] = (checksum >> 8) & 0xFF;
+
+ raw_hid_send(data, RAW_EPSIZE);
+#endif
+}
+
+void factory_test_rx(uint8_t *data, uint8_t length) {
+ if (data[0] == 0xAB) {
+ uint16_t checksum = 0;
+
+ for (uint8_t i = 1; i < RAW_EPSIZE - 3; i++) {
+ checksum += data[i];
+ }
+ /* Verify checksum */
+ if ((checksum & 0xFF) != data[RAW_EPSIZE - 2] || checksum >> 8 != data[RAW_EPSIZE - 1]) return;
+
+#ifdef LK_WIRELESS_ENABLE
+ uint8_t payload[32];
+ uint8_t len = 0;
+#endif
+
+ switch (data[1]) {
+ case FACTORY_TEST_CMD_BACKLIGHT:
+ backlight_test_mode = data[2];
+ factory_reset_timer = 0;
+ break;
+ case FACTORY_TEST_CMD_OS_SWITCH:
+ report_os_sw_state = data[2];
+ if (report_os_sw_state) {
+ // dip_switch_read(true);
+ }
+ break;
+ case FACTORY_TEST_CMD_JUMP_TO_BL:
+ // if (memcmp(&data[2], "JumpToBootloader", strlen("JumpToBootloader")) == 0) bootloader_jump();
+ break;
+#ifdef LK_WIRELESS_ENABLE
+ case FACTORY_TEST_CMD_INT_PIN:
+ switch (data[2]) {
+ /* Enalbe/disable test */
+ case 0xA1:
+ lkbt51_int_pin_test(data[3]);
+ break;
+ /* Set INT state */
+ case 0xA2:
+ kc_printf("pin %d\n\r", data[3]);
+ gpio_write_pin(LKBT51_INT_OUTPUT_PIN, data[3]);
+ break;
+ /* Report INT state */
+ // case 0xA3:
+ // payload[len++] = FACTORY_TEST_CMD_INT_PIN;
+ // payload[len++] = 0xA3;
+ // payload[len++] = gpio_read_pin(LKBT51_INT_INPUT_PIN);
+ // factory_test_send(payload, len);
+ // break;
+ }
+ break;
+ case FACTORY_TEST_CMD_GET_TRANSPORT:
+ payload[len++] = FACTORY_TEST_CMD_GET_TRANSPORT;
+ payload[len++] = get_transport();
+ payload[len++] = gpio_read_pin(USB_POWER_SENSE_PIN);
+ factory_test_send(payload, len);
+ break;
+#endif
+#ifdef BATTERY_CHARGE_DONE_DETECT_ADC
+ case FACTORY_TEST_CMD_CHARGING_ADC:
+ case 0xA1:
+ battery_charging_monitor(data[3]);
+ break;
+ case 0xA2:
+ payload[len++] = FACTORY_TEST_CMD_CHARGING_ADC;
+ payload[len++] = battery_adc_read_charging_pin();
+ factory_test_send(payload, len);
+ break;
+#endif
+#ifdef LK_WIRELESS_ENABLE
+ case FACTORY_TEST_CMD_RADIO_CARRIER:
+ if (data[2] < 79) lkbt51_radio_test(data[2]);
+ break;
+
+# ifdef WERELESS_PRESSURE_TEST
+ case 0x70:
+ switch (data[2]) {
+ /* Enalbe/disable test */
+ case 0xB1:
+ SEND_STRING("abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqrstuvwxyz1234567890\n");
+ break;
+ case 0xB2:
+ payload[len++] = 0x70;
+ payload[len++] = 0xB2;
+ payload[len++] = wireless_get_state();
+ factory_test_send(payload, len);
+ break;
+ }
+ break;
+# endif
+#endif
+ case FACTORY_TEST_CMD_GET_BUILD_TIME: {
+ payload[len++] = FACTORY_TEST_CMD_GET_BUILD_TIME;
+ payload[len++] = 'v';
+ if ((DEVICE_VER & 0xF000) != 0) itoa((DEVICE_VER >> 12), (char *)&payload[len++], 16);
+ itoa((DEVICE_VER >> 8) & 0xF, (char *)&payload[len++], 16);
+ payload[len++] = '.';
+ itoa((DEVICE_VER >> 4) & 0xF, (char *)&payload[len++], 16);
+ payload[len++] = '.';
+ itoa((DEVICE_VER >> 4) & 0xF, (char *)&payload[len++], 16);
+ payload[len++] = ' ';
+ memcpy(&payload[len], QMK_BUILDDATE, sizeof(QMK_BUILDDATE));
+ len += sizeof(QMK_BUILDDATE);
+ factory_test_send(payload, len);
+ } break;
+#if 0
+ case FACTORY_TEST_CMD_GET_DEVICE_ID:
+ payload[len++] = FACTORY_TEST_CMD_GET_DEVICE_ID;
+ payload[len++] = 12; // UUID length
+ memcpy(&payload[len], (uint32_t *)UID_BASE, 4);
+ memcpy(&payload[len+4], (uint32_t *)UID_BASE+4, 4);
+ memcpy(&payload[len+8], (uint32_t *)UID_BASE+8, 4);
+
+ len += 12;
+ factory_test_send(payload, len);
+ break;
+#endif
+ }
+ }
+}
+
+bool dip_switch_update_user(uint8_t index, bool active) {
+ if (report_os_sw_state) {
+#ifdef INVERT_OS_SWITCH_STATE
+ active = !active;
+#endif
+ uint8_t payload[3] = {FACTORY_TEST_CMD_OS_SWITCH, OS_SWITCH, active};
+ factory_test_send(payload, 3);
+ }
+
+ return true;
+}
diff --git a/keyboards/keychron/common/factory_test.h b/keyboards/keychron/common/factory_test.h
new file mode 100644
index 0000000000..559663e98a
--- /dev/null
+++ b/keyboards/keychron/common/factory_test.h
@@ -0,0 +1,34 @@
+/* Copyright 2022 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#define FACTORY_RESET_CHECK process_record_factory_test
+#define FACTORY_RESET_TASK factory_test_task
+
+void factory_test_init(void);
+
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+bool factory_test_indicator(void);
+#endif
+
+//void process_record_factory_test(uint16_t keycode, keyrecord_t *record);
+bool factory_reset_indicating(void);
+void factory_test_task(void);
+void factory_test_rx(uint8_t *data, uint8_t length);
+
+bool process_record_factory_test(uint16_t keycode, keyrecord_t *record);
+
diff --git a/keyboards/keychron/common/keychron_common.c b/keyboards/keychron/common/keychron_common.c
new file mode 100644
index 0000000000..bc01bbd56c
--- /dev/null
+++ b/keyboards/keychron/common/keychron_common.c
@@ -0,0 +1,239 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+#include "raw_hid.h"
+#include "version.h"
+
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+#endif
+
+bool is_siri_active = false;
+uint32_t siri_timer = 0;
+
+static uint8_t mac_keycode[4] = {
+ KC_LOPT,
+ KC_ROPT,
+ KC_LCMD,
+ KC_RCMD,
+};
+
+// clang-format off
+static key_combination_t key_comb_list[] = {
+ {2, {KC_LWIN, KC_TAB}},
+ {2, {KC_LWIN, KC_E}},
+ {3, {KC_LSFT, KC_LCMD, KC_4}},
+ {2, {KC_LWIN, KC_C}},
+#ifdef WIN_LOCK_SCREEN_ENABLE
+ {2, {KC_LWIN, KC_L}},
+#endif
+#ifdef MAC_LOCK_SCREEN_ENABLE
+ {3, {KC_LCTL, KC_LCMD, KC_Q}},
+#endif
+};
+// clang-format on
+
+bool process_record_keychron_common(uint16_t keycode, keyrecord_t *record) {
+ switch (keycode) {
+ case KC_MCTRL:
+ if (record->event.pressed) {
+ register_code(KC_MISSION_CONTROL);
+ } else {
+ unregister_code(KC_MISSION_CONTROL);
+ }
+ return false; // Skip all further processing of this key
+ case KC_LNPAD:
+ if (record->event.pressed) {
+ register_code(KC_LAUNCHPAD);
+ } else {
+ unregister_code(KC_LAUNCHPAD);
+ }
+ return false; // Skip all further processing of this key
+ case KC_LOPTN:
+ case KC_ROPTN:
+ case KC_LCMMD:
+ case KC_RCMMD:
+ if (record->event.pressed) {
+ register_code(mac_keycode[keycode - KC_LOPTN]);
+ } else {
+ unregister_code(mac_keycode[keycode - KC_LOPTN]);
+ }
+ return false; // Skip all further processing of this key
+ case KC_SIRI:
+ if (record->event.pressed) {
+ if (!is_siri_active) {
+ is_siri_active = true;
+ register_code(KC_LCMD);
+ register_code(KC_SPACE);
+ }
+ siri_timer = timer_read32();
+ } else {
+ // Do something else when release
+ }
+ return false; // Skip all further processing of this key
+ case KC_TASK:
+ case KC_FILE:
+ case KC_SNAP:
+ case KC_CTANA:
+#ifdef WIN_LOCK_SCREEN_ENABLE
+ case KC_WLCK:
+#endif
+#ifdef MAC_LOCK_SCREEN_ENABLE
+ case KC_MLCK:
+#endif
+ if (record->event.pressed) {
+ for (uint8_t i = 0; i < key_comb_list[keycode - KC_TASK].len; i++) {
+ register_code(key_comb_list[keycode - KC_TASK].keycode[i]);
+ }
+ } else {
+ for (uint8_t i = 0; i < key_comb_list[keycode - KC_TASK].len; i++) {
+ unregister_code(key_comb_list[keycode - KC_TASK].keycode[i]);
+ }
+ }
+ return false; // Skip all further processing of this key
+ default:
+ return true; // Process all other keycodes normally
+ }
+}
+
+void keychron_common_task(void) {
+ if (is_siri_active && timer_elapsed32(siri_timer) > 500) {
+ unregister_code(KC_LCMD);
+ unregister_code(KC_SPACE);
+ is_siri_active = false;
+ siri_timer = 0;
+ }
+}
+
+#ifdef ENCODER_ENABLE
+static void encoders_pins_cb(void *param) {
+ uint8_t index = (uint32_t)param;
+ extern void encoder_quadrature_handle_inerrupt_read(uint8_t index);
+ encoder_quadrature_handle_inerrupt_read(index);
+}
+
+void encoder_cb_init(void) {
+ pin_t encoders_pin_a[] = ENCODER_A_PINS;
+ pin_t encoders_pin_b[] = ENCODER_B_PINS;
+ for (uint32_t i=0; i> 12), (char *)&data[i++], 16);
+ itoa((DEVICE_VER >> 8) & 0xF, (char *)&data[i++], 16);
+ data[i++] = '.';
+ itoa((DEVICE_VER >> 4) & 0xF, (char *)&data[i++], 16);
+ data[i++] = '.';
+ itoa(DEVICE_VER & 0xF, (char *)&data[i++], 16);
+ data[i++] = ' ';
+ memcpy(&data[i], QMK_BUILDDATE, sizeof(QMK_BUILDDATE));
+ i += sizeof(QMK_BUILDDATE);
+ raw_hid_send(data, length);
+ } break;
+
+ case kc_get_support_feature:
+ get_support_feature(&data[1]);
+ raw_hid_send(data, length);
+ break;
+
+ case kc_get_default_layer:
+ data[1] = get_highest_layer(default_layer_state);
+ raw_hid_send(data, length);
+ break;
+
+#ifdef ANANLOG_MATRIX
+ case 0xA9:
+ analog_matrix_rx(data, length);
+ break;
+#endif
+#ifdef LK_WIRELESS_ENABLE
+ case 0xAA:
+ lkbt51_dfu_rx(data, length);
+ break;
+#endif
+#ifdef FACTORY_TEST_ENABLE
+ case 0xAB:
+ factory_test_rx(data, length);
+ break;
+#endif
+ default:
+ return false;
+ }
+
+ return true;
+}
+
+#if defined(VIA_ENABLE)
+bool via_command_kb(uint8_t *data, uint8_t length) {
+ return kc_raw_hid_rx(data, length);
+}
+#else
+void raw_hid_receive(uint8_t *data, uint8_t length) {
+ kc_raw_hid_rx(data, length);
+}
+#endif
+
diff --git a/keyboards/keychron/common/keychron_common.h b/keyboards/keychron/common/keychron_common.h
new file mode 100644
index 0000000000..c72667c9f2
--- /dev/null
+++ b/keyboards/keychron/common/keychron_common.h
@@ -0,0 +1,107 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include "stdint.h"
+
+// clang-format off
+enum {
+ KC_LOPTN = QK_KB_0,
+ KC_ROPTN,
+ KC_LCMMD,
+ KC_RCMMD,
+ KC_MCTRL,
+ KC_LNPAD,
+ KC_TASK_VIEW,
+ KC_FILE_EXPLORER,
+ KC_SCREEN_SHOT,
+ KC_CORTANA,
+#ifdef WIN_LOCK_SCREEN_ENABLE
+ KC_WIN_LOCK_SCREEN,
+ __KC_WIN_LOCK_SCREEN_NEXT,
+#else
+ __KC_WIN_LOCK_SCREEN_NEXT = KC_CORTANA + 1,
+#endif
+#ifdef MAC_LOCK_SCREEN_ENABLE
+ KC_MAC_LOCK_SCREEN = __KC_WIN_LOCK_SCREEN_NEXT,
+ __KC_MAC_LOCK_SCREEN_NEXT,
+#else
+ __KC_MAC_LOCK_SCREEN_NEXT = __KC_WIN_LOCK_SCREEN_NEXT,
+#endif
+ KC_SIRI = __KC_MAC_LOCK_SCREEN_NEXT,
+#ifdef LK_WIRELESS_ENABLE
+ BT_HST1,
+ BT_HST2,
+ BT_HST3,
+#if defined(P2P4_MODE_ENABLE) || defined(P24G_MODE_SELECT_PIN)
+ P2P4G,
+ __P2P4G_NEXT,
+#else
+ P2P4G = _______,
+ __P2P4G_NEXT = BT_HST3 + 1,
+#endif
+#if defined(TRANSPORT_SOFT_SWITCH_ENABLE)
+ TP_USB = __P2P4G_NEXT,
+ __TP_USB_NEXT,
+#else
+ __TP_USB_NEXT = __P2P4G_NEXT,
+#endif
+ BAT_LVL = __TP_USB_NEXT,
+ __BAT_LVL_NEXT = BAT_LVL + 1,
+#else
+ BT_HST1 = _______,
+ BT_HST2 = _______,
+ BT_HST3 = _______,
+#if defined(TRANSPORT_SOFT_SWITCH_ENABLE)
+ MD_USB = _______,
+#endif
+ BAT_LVL = _______,
+ __BAT_LVL_NEXT = KC_SIRI + 1,
+#endif
+#ifdef ANANLOG_MATRIX
+ PROF1 = __BAT_LVL_NEXT,
+ PROF2,
+ PROF3,
+ __PROF3_NEXT = PROF3 + 1,
+#else
+ PROF1 = _______,
+ PROF2 = _______,
+ PROF3 = _______,
+ __PROF3_NEXT = __BAT_LVL_NEXT,
+#endif
+ NEW_SAFE_RANGE = __PROF3_NEXT
+};
+
+#define KC_TASK KC_TASK_VIEW
+#define KC_FILE KC_FILE_EXPLORER
+#define KC_SNAP KC_SCREEN_SHOT
+#define KC_CTANA KC_CORTANA
+#define KC_WLCK KC_WIN_LOCK_SCREEN
+#define KC_MLCK KC_MAC_LOCK_SCREEN
+
+typedef struct PACKED {
+ uint8_t len;
+ uint8_t keycode[3];
+} key_combination_t;
+
+bool process_record_keychron_common(uint16_t keycode, keyrecord_t *record);
+void keychron_common_task(void);
+
+#ifdef ENCODER_ENABLE
+void encoder_cb_init(void);
+#endif
+
diff --git a/keyboards/keychron/common/keychron_common.mk b/keyboards/keychron/common/keychron_common.mk
new file mode 100644
index 0000000000..26ab362f3a
--- /dev/null
+++ b/keyboards/keychron/common/keychron_common.mk
@@ -0,0 +1,10 @@
+OPT_DEFS += -DFACTORY_TEST_ENABLE -DAPDAPTIVE_NKRO_ENABLE
+
+KEYCHRON_COMMON_DIR = common
+SRC += \
+ $(KEYCHRON_COMMON_DIR)/keychron_task.c \
+ $(KEYCHRON_COMMON_DIR)/keychron_common.c \
+ $(KEYCHRON_COMMON_DIR)/factory_test.c
+
+VPATH += $(TOP_DIR)/keyboards/keychron/$(KEYCHRON_COMMON_DIR)
+
diff --git a/keyboards/keychron/common/keychron_task.c b/keyboards/keychron/common/keychron_task.c
new file mode 100644
index 0000000000..18617188ab
--- /dev/null
+++ b/keyboards/keychron/common/keychron_task.c
@@ -0,0 +1,117 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include
+#include "keychron_task.h"
+#include "quantum.h"
+#include "keychron_common.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+#endif
+
+__attribute__((weak)) bool process_record_keychron_kb(uint16_t keycode, keyrecord_t *record) {
+ return true;
+}
+
+bool process_record_keychron(uint16_t keycode, keyrecord_t *record) {
+#ifdef LK_WIRELESS_ENABLE
+ extern bool process_record_wireless(uint16_t keycode, keyrecord_t * record);
+ if (!process_record_wireless(keycode, record)) return false;
+#endif
+#ifdef FACTORY_TEST_ENABLE
+ if (!process_record_factory_test(keycode, record)) return false;
+#endif
+ // extern bool process_record_keychron_kb(uint16_t keycode, keyrecord_t *record);
+
+ if (!process_record_keychron_kb(keycode, record)) return false;
+
+ return true;
+}
+
+#if defined(LED_MATRIX_ENABLE)
+bool led_matrix_indicators_keychron(void) {
+# ifdef LK_WIRELESS_ENABLE
+ extern bool led_matrix_indicators_bt(void);
+ led_matrix_indicators_bt();
+# endif
+# ifdef FACTORY_TEST_ENABLE
+ factory_test_indicator();
+# endif
+ return true;
+}
+#endif
+
+#if defined(RGB_MATRIX_ENABLE)
+bool rgb_matrix_indicators_keychron(void) {
+# ifdef LK_WIRELESS_ENABLE
+ extern bool rgb_matrix_indicators_bt(void);
+ rgb_matrix_indicators_bt();
+# endif
+# ifdef FACTORY_TEST_ENABLE
+ factory_test_indicator();
+# endif
+ return true;
+}
+#endif
+
+__attribute__((weak)) bool keychron_task_kb(void) {
+ return true;
+}
+
+void keychron_task(void) {
+#ifdef LK_WIRELESS_ENABLE
+ extern void wireless_tasks(void);
+ wireless_tasks();
+#endif
+#ifdef FACTORY_TEST_ENABLE
+ factory_test_task();
+#endif
+ keychron_common_task();
+
+ keychron_task_kb();
+}
+
+bool process_record_kb(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_user(keycode, record)) return false;
+
+ if (!process_record_keychron(keycode, record)) return false;
+
+ return true;
+}
+
+#ifdef RGB_MATRIX_ENABLE
+bool rgb_matrix_indicators_kb(void) {
+ if (!rgb_matrix_indicators_user()) return false;
+
+ rgb_matrix_indicators_keychron();
+
+ return true;
+}
+#endif
+
+#ifdef LED_MATRIX_ENABLE
+bool led_matrix_indicators_kb(void) {
+ if (!led_matrix_indicators_user()) return false;
+
+ led_matrix_indicators_keychron();
+
+ return true;
+}
+#endif
+
+void housekeeping_task_kb(void) {
+ keychron_task();
+}
diff --git a/keyboards/keychron/common/keychron_task.h b/keyboards/keychron/common/keychron_task.h
new file mode 100644
index 0000000000..a2f31e5cc2
--- /dev/null
+++ b/keyboards/keychron/common/keychron_task.h
@@ -0,0 +1,25 @@
+/* Copyright 2022 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include "stdint.h"
+#include "action.h"
+
+bool keychron_task_kb(void);
+bool process_record_keychron_kb(uint16_t keycode, keyrecord_t *record);
+
+void keychron_task(void);
diff --git a/keyboards/keychron/common/matrix.c b/keyboards/keychron/common/matrix.c
new file mode 100644
index 0000000000..93796d9ca7
--- /dev/null
+++ b/keyboards/keychron/common/matrix.c
@@ -0,0 +1,218 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+#ifndef HC595_STCP
+# define HC595_STCP B0
+#endif
+#ifndef HC595_SHCP
+# define HC595_SHCP A1
+#endif
+#ifndef HC595_DS
+# define HC595_DS A7
+#endif
+
+#ifndef HC595_START_INDEX
+# define HC595_START_INDEX 0
+#endif
+#ifndef HC595_END_INDEX
+# define HC595_END_INDEX 15
+#endif
+#ifndef HC595_OFFSET_INDEX
+# define HC595_OFFSET_INDEX 0
+#endif
+
+#if defined(HC595_START_INDEX) && defined(HC595_END_INDEX)
+# if ((HC595_END_INDEX - HC595_START_INDEX + 1) > 16)
+# define SIZE_T uint32_t
+# define UNSELECT_ALL_COL 0xFFFFFFFF
+# define SELECT_ALL_COL 0x00000000
+# elif ((HC595_END_INDEX - HC595_START_INDEX + 1) > 8)
+# define SIZE_T uint16_t
+# define UNSELECT_ALL_COL 0xFFFF
+# define SELECT_ALL_COL 0x0000
+# else
+# define SIZE_T uint8_t
+# define UNSELECT_ALL_COL 0xFF
+# define SELECT_ALL_COL 0x00
+# endif
+#endif
+
+pin_t row_pins[MATRIX_ROWS] = MATRIX_ROW_PINS;
+pin_t col_pins[MATRIX_COLS] = MATRIX_COL_PINS;
+
+static inline uint8_t readMatrixPin(pin_t pin) {
+ if (pin != NO_PIN) {
+ return gpio_read_pin(pin);
+ } else {
+ return 1;
+ }
+}
+
+static inline void setPinOutput_writeLow(pin_t pin) {
+ gpio_set_pin_output_push_pull(pin);
+ gpio_write_pin_low(pin);
+}
+
+static inline void setPinOutput_writeHigh(pin_t pin) {
+ gpio_set_pin_output_push_pull(pin);
+ gpio_write_pin_high(pin);
+}
+
+static inline void HC595_delay(uint16_t n) {
+ while (n-- > 0) {
+ asm volatile("nop" ::: "memory");
+ }
+}
+
+static void HC595_output(SIZE_T data, bool bit_flag) {
+ uint8_t n = 1;
+
+ ATOMIC_BLOCK_FORCEON {
+ for (uint8_t i = 0; i < (HC595_END_INDEX - HC595_START_INDEX + 1); i++) {
+ if (data & 0x1) {
+ gpio_write_pin_high(HC595_DS);
+ } else {
+ gpio_write_pin_low(HC595_DS);
+ }
+ gpio_write_pin_high(HC595_SHCP);
+ HC595_delay(n);
+ gpio_write_pin_low(HC595_SHCP);
+ HC595_delay(n);
+ if (bit_flag) {
+ break;
+ } else {
+ data = data >> 1;
+ }
+ }
+ gpio_write_pin_high(HC595_STCP);
+ HC595_delay(n);
+ gpio_write_pin_low(HC595_STCP);
+ HC595_delay(n);
+ }
+}
+
+static void select_col(uint8_t col) {
+ if (col < HC595_START_INDEX || col > HC595_END_INDEX) {
+ setPinOutput_writeLow(col_pins[col]);
+ } else {
+ if (col == HC595_START_INDEX) {
+ HC595_output(0x00, true);
+ if (col < HC595_OFFSET_INDEX) {
+ HC595_output(0x01, true);
+ }
+ }
+ }
+}
+
+static void unselect_col(uint8_t col) {
+ if (col < HC595_START_INDEX || col > HC595_END_INDEX) {
+#ifdef MATRIX_UNSELECT_DRIVE_HIGH
+ setPinOutput_writeHigh(col_pins[col]);
+#else
+ gpio_set_pin_input_high(col_pins[col]);
+#endif
+ } else {
+ HC595_output(0x01, true);
+ }
+}
+
+static void unselect_cols(void) {
+ for (uint8_t col = 0; col < MATRIX_COLS; col++) {
+ if (col < HC595_START_INDEX || col > HC595_END_INDEX) {
+#ifdef MATRIX_UNSELECT_DRIVE_HIGH
+ setPinOutput_writeHigh(col_pins[col]);
+#else
+ gpio_set_pin_input_high(col_pins[col]);
+#endif
+ } else {
+ if (col == HC595_START_INDEX) {
+ HC595_output(UNSELECT_ALL_COL, false);
+ }
+ break;
+ }
+ }
+}
+
+void select_all_cols(void) {
+ for (uint8_t col = 0; col < MATRIX_COLS; col++) {
+ if (col < HC595_START_INDEX || col > HC595_END_INDEX) {
+ setPinOutput_writeLow(col_pins[col]);
+ } else {
+ if (col == HC595_START_INDEX) {
+ HC595_output(SELECT_ALL_COL, false);
+ }
+ break;
+ }
+ }
+}
+
+static void matrix_read_rows_on_col(matrix_row_t current_matrix[], uint8_t current_col, matrix_row_t row_shifter) {
+ // Select col
+ select_col(current_col); // select col
+ HC595_delay(200);
+
+ // For each row...
+ for (uint8_t row_index = 0; row_index < MATRIX_ROWS; row_index++) {
+ // Check row pin state
+ if (readMatrixPin(row_pins[row_index]) == 0) {
+ // Pin LO, set col bit
+ current_matrix[row_index] |= row_shifter;
+ } else {
+ // Pin HI, clear col bit
+ current_matrix[row_index] &= ~row_shifter;
+ }
+ }
+
+ // Unselect col
+ unselect_col(current_col);
+ HC595_delay(200); // wait for all Row signals to go HIGH
+}
+
+void matrix_init_custom(void) {
+ gpio_set_pin_output_push_pull(HC595_DS);
+ gpio_set_pin_output_push_pull(HC595_STCP);
+ gpio_set_pin_output_push_pull(HC595_SHCP);
+
+ for (uint8_t x = 0; x < MATRIX_ROWS; x++) {
+ if (row_pins[x] != NO_PIN) {
+ gpio_set_pin_input_high(row_pins[x]);
+ }
+ }
+
+ unselect_cols();
+}
+
+bool matrix_scan_custom(matrix_row_t current_matrix[]) {
+ matrix_row_t curr_matrix[MATRIX_ROWS] = {0};
+
+ // Set col, read rows
+ matrix_row_t row_shifter = MATRIX_ROW_SHIFTER;
+ for (uint8_t current_col = 0; current_col < MATRIX_COLS; current_col++, row_shifter <<= 1) {
+ matrix_read_rows_on_col(curr_matrix, current_col, row_shifter);
+ }
+
+ bool changed = memcmp(current_matrix, curr_matrix, sizeof(curr_matrix)) != 0;
+ if (changed) memcpy(current_matrix, curr_matrix, sizeof(curr_matrix));
+
+ return changed;
+}
+
+void suspend_wakeup_init_kb(void) {
+ // code will run on keyboard wakeup
+ clear_keyboard();
+}
diff --git a/keyboards/keychron/common/wireless/bat_level_animation.c b/keyboards/keychron/common/wireless/bat_level_animation.c
new file mode 100644
index 0000000000..2c63ec6cf7
--- /dev/null
+++ b/keyboards/keychron/common/wireless/bat_level_animation.c
@@ -0,0 +1,147 @@
+
+#include "quantum.h"
+#include "wireless.h"
+#include "indicator.h"
+#include "lpm.h"
+#if defined(PROTOCOL_CHIBIOS)
+# include
+#elif if defined(PROTOCOL_LUFA)
+# include "lufa.h"
+#endif
+#include "eeprom.h"
+
+#if (defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)) && defined(BAT_LEVEL_LED_LIST)
+
+#ifndef BAT_LEVEL_GROWING_INTERVAL
+# define BAT_LEVEL_GROWING_INTERVAL 150
+#endif
+
+#ifndef BAT_LEVEL_ON_INTERVAL
+# define BAT_LEVEL_ON_INTERVAL 3000
+#endif
+
+#ifdef LED_MATRIX_ENABLE
+# define LED_DRIVER_IS_ENABLED led_matrix_is_enabled
+#endif
+
+#ifdef RGB_MATRIX_ENABLE
+# define LED_DRIVER_IS_ENABLED rgb_matrix_is_enabled
+#endif
+
+enum {
+ BAT_LVL_ANI_NONE,
+ BAT_LVL_ANI_GROWING,
+ BAT_LVL_ANI_BLINK_OFF,
+ BAT_LVL_ANI_BLINK_ON,
+};
+
+static uint8_t animation_state = 0;
+static uint32_t bat_lvl_ani_timer_buffer = 0;
+static uint8_t bat_percentage;
+static uint8_t cur_percentage;
+static uint32_t time_interval;
+#ifdef RGB_MATRIX_ENABLE
+static uint8_t r, g, b;
+#endif
+
+extern indicator_config_t indicator_config;
+extern backlight_state_t original_backlight_state;
+
+void bat_level_animiation_start(uint8_t percentage) {
+ /* Turn on backlight mode for indicator */
+ indicator_enable();
+
+ animation_state = BAT_LVL_ANI_GROWING;
+ bat_percentage = percentage;
+ bat_lvl_ani_timer_buffer = timer_read32();
+ cur_percentage = 0;
+ time_interval = BAT_LEVEL_GROWING_INTERVAL;
+#ifdef RGB_MATRIX_ENABLE
+ r = g = b = 255;
+#endif
+}
+
+void bat_level_animiation_stop(void) {
+ animation_state = BAT_LVL_ANI_NONE;
+}
+
+bool bat_level_animiation_actived(void) {
+ return animation_state;
+}
+
+void bat_level_animiation_indicate(void) {
+#ifdef LED_MATRIX_ENABLE
+ uint8_t bat_lvl_led_list[10] = BAT_LEVEL_LED_LIST;
+
+ for (uint8_t i = 0; i <= LED_MATRIX_LED_COUNT; i++) {
+ led_matrix_set_value(i, 0);
+ }
+
+ if (animation_state == BAT_LVL_ANI_GROWING || animation_state == BAT_LVL_ANI_BLINK_ON)
+ for (uint8_t i = 0; i < cur_percentage / 10; i++)
+ led_matrix_set_value(bat_lvl_led_list[i], 255);
+#endif
+
+#ifdef RGB_MATRIX_ENABLE
+ uint8_t bat_lvl_led_list[10] = BAT_LEVEL_LED_LIST;
+
+ for (uint8_t i = 0; i <= RGB_MATRIX_LED_COUNT; i++) {
+ rgb_matrix_set_color(i, 0, 0, 0);
+ }
+
+ if (animation_state == BAT_LVL_ANI_GROWING || animation_state == BAT_LVL_ANI_BLINK_ON) {
+ for (uint8_t i = 0; i < cur_percentage / 10; i++) {
+ rgb_matrix_set_color(bat_lvl_led_list[i], r, g, b);
+ }
+ }
+#endif
+}
+
+void bat_level_animiation_update(void) {
+ switch (animation_state) {
+ case BAT_LVL_ANI_GROWING:
+ if (cur_percentage < bat_percentage)
+ cur_percentage += 10;
+ else {
+ if (cur_percentage == 0) cur_percentage = 10;
+ animation_state = BAT_LVL_ANI_BLINK_OFF;
+ }
+ break;
+
+ case BAT_LVL_ANI_BLINK_OFF:
+#ifdef RGB_MATRIX_ENABLE
+ if (bat_percentage < 30) {
+ r = 255;
+ b = g = 0;
+ } else {
+ r = b = 0;
+ g = 255;
+ }
+#endif
+ time_interval = BAT_LEVEL_ON_INTERVAL;
+ animation_state = BAT_LVL_ANI_BLINK_ON;
+ break;
+
+ case BAT_LVL_ANI_BLINK_ON:
+ animation_state = BAT_LVL_ANI_NONE;
+ indicator_eeconfig_reload();
+ if (indicator_config.value == 0 && !LED_DRIVER_IS_ENABLED()) {
+ indicator_disable();
+ }
+ lpm_timer_reset();
+ break;
+
+ default:
+ break;
+ }
+
+ bat_lvl_ani_timer_buffer = timer_read32();
+}
+
+void bat_level_animiation_task(void) {
+ if (animation_state && sync_timer_elapsed32(bat_lvl_ani_timer_buffer) > time_interval) {
+ bat_level_animiation_update();
+ }
+}
+
+#endif
diff --git a/keyboards/keychron/common/wireless/bat_level_animation.h b/keyboards/keychron/common/wireless/bat_level_animation.h
new file mode 100644
index 0000000000..716e924103
--- /dev/null
+++ b/keyboards/keychron/common/wireless/bat_level_animation.h
@@ -0,0 +1,23 @@
+/* Copyright 2022 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+void bat_level_animiation_start(uint8_t percentage);
+void bat_level_animiation_stop(void);
+bool bat_level_animiation_actived(void);
+void bat_level_animiation_indicate(void);
+void bat_level_animiation_task(void);
diff --git a/keyboards/keychron/common/wireless/battery.c b/keyboards/keychron/common/wireless/battery.c
new file mode 100644
index 0000000000..69ad66fb16
--- /dev/null
+++ b/keyboards/keychron/common/wireless/battery.c
@@ -0,0 +1,216 @@
+/*/* Copyright 2022 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "wireless.h"
+#include "battery.h"
+#include "transport.h"
+#include "lkbt51.h"
+#include "lpm.h"
+#include "indicator.h"
+#include "rtc_timer.h"
+#include "analog.h"
+
+#define BATTERY_EMPTY_COUNT 10
+#define CRITICAL_LOW_COUNT 20
+
+/* Battery voltage resistive voltage divider setting of MCU */
+#ifndef RVD_R1
+# define RVD_R1 10 // Upper side resitor value (uint: KΩ)
+#endif
+#ifndef RVD_R2
+# define RVD_R2 10 // Lower side resitor value (uint: KΩ)
+#endif
+
+/* Battery voltage resistive voltage divider setting of Bluetooth */
+#ifndef LKBT51_RVD_R1
+# define LKBT51_RVD_R1 560
+#endif
+#ifndef LKBT51_RVD_R2
+# define LKBT51_RVD_R2 499
+#endif
+
+#ifndef VOLTAGE_TRIM_LED_MATRIX
+# define VOLTAGE_TRIM_LED_MATRIX 30
+#endif
+
+#ifndef VOLTAGE_TRIM_RGB_MATRIX
+# define VOLTAGE_TRIM_RGB_MATRIX 60
+#endif
+
+static uint32_t bat_monitor_timer_buffer = 0;
+static uint16_t voltage = FULL_VOLTAGE_VALUE;
+static uint8_t bat_empty = 0;
+static uint8_t critical_low = 0;
+static uint8_t bat_state;
+static uint8_t power_on_sample = 0;
+
+void battery_init(void) {
+ bat_state = BAT_NOT_CHARGING;
+#if defined(BAT_CHARGING_PIN)
+# if (BAT_CHARGING_LEVEL == 0)
+ palSetLineMode(BAT_CHARGING_PIN, PAL_MODE_INPUT_PULLUP);
+# else
+ palSetLineMode(BAT_CHARGING_PIN, PAL_MODE_INPUT_PULLDOWN);
+# endif
+#endif
+
+#ifdef BAT_ADC_ENABLE_PIN
+ palSetLineMode(BAT_ADC_ENABLE_PIN, PAL_MODE_OUTPUT_PUSHPULL);
+ gpio_write_pin(BAT_ADC_ENABLE_PIN, 1);
+#endif
+#ifdef BAT_ADC_PIN
+ palSetLineMode(BAT_ADC_PIN, PAL_MODE_INPUT_ANALOG);
+#endif
+}
+
+void battery_stop(void) {
+#if (HAL_USE_ADC)
+# ifdef BAT_ADC_ENABLE_PIN
+ gpio_write_pin(BAT_ADC_ENABLE_PIN, 0);
+# endif
+# ifdef BAT_ADC_PIN
+ palSetLineMode(BAT_ADC_PIN, PAL_MODE_INPUT_ANALOG);
+ analog_stop(BAT_ADC_PIN);
+# endif
+#endif
+}
+
+__attribute__((weak)) void battery_measure(void) {
+ lkbt51_read_state_reg(0x05, 0x02);
+}
+
+/* Calculate the voltage */
+__attribute__((weak)) void battery_calculate_voltage(bool vol_src_bt, uint16_t value) {
+ uint16_t voltage;
+
+ if (vol_src_bt)
+ voltage = ((uint32_t)value) * (LKBT51_RVD_R1 + LKBT51_RVD_R2) / LKBT51_RVD_R2;
+ else
+ voltage = (uint32_t)value * 3300 / 1024 * (RVD_R1 + RVD_R2) / RVD_R2;
+
+#ifdef LED_MATRIX_ENABLE
+ if (led_matrix_is_enabled()) {
+ /* We assumpt it is linear relationship*/
+ uint32_t compensation = (VOLTAGE_TRIM_LED_MATRIX * led_matrix_driver.get_load_ratio());
+ voltage += compensation;
+ }
+#endif
+#ifdef RGB_MATRIX_ENABLE
+ if (rgb_matrix_is_enabled()) {
+
+ /* We assumpt it is linear relationship*/
+ uint32_t compensation = (VOLTAGE_TRIM_LED_MATRIX * rgb_matrix_driver.get_load_ratio());
+ voltage += compensation;
+ }
+#endif
+
+ battery_set_voltage(voltage);
+}
+
+void battery_set_voltage(uint16_t value) {
+ voltage = value;
+}
+
+uint16_t battery_get_voltage(void) {
+ return voltage;
+}
+
+uint8_t battery_get_percentage(void) {
+ if (voltage > FULL_VOLTAGE_VALUE) return 100;
+
+ if (voltage > EMPTY_VOLTAGE_VALUE) {
+ return ((uint32_t)voltage - EMPTY_VOLTAGE_VALUE) * 80 / (FULL_VOLTAGE_VALUE - EMPTY_VOLTAGE_VALUE) + 20;
+ }
+
+ if (voltage > SHUTDOWN_VOLTAGE_VALUE) {
+ return ((uint32_t)voltage - SHUTDOWN_VOLTAGE_VALUE) * 20 / (EMPTY_VOLTAGE_VALUE - SHUTDOWN_VOLTAGE_VALUE);
+ } else
+ return 0;
+}
+
+bool battery_is_empty(void) {
+ return bat_empty > BATTERY_EMPTY_COUNT;
+}
+
+bool battery_is_critical_low(void) {
+ return critical_low > CRITICAL_LOW_COUNT;
+}
+
+void battery_check_empty(void) {
+ if (voltage < EMPTY_VOLTAGE_VALUE) {
+ if (bat_empty <= BATTERY_EMPTY_COUNT) {
+ if (++bat_empty > BATTERY_EMPTY_COUNT) {
+ indicator_battery_low_enable(true);
+ power_on_sample = VOLTAGE_POWER_ON_MEASURE_COUNT;
+ }
+ }
+ }
+}
+
+void battery_check_critical_low(void) {
+ if (voltage < SHUTDOWN_VOLTAGE_VALUE) {
+ if (critical_low <= CRITICAL_LOW_COUNT) {
+ if (++critical_low > CRITICAL_LOW_COUNT) wireless_low_battery_shutdown();
+ }
+ } else if (critical_low <= CRITICAL_LOW_COUNT) {
+ critical_low = 0;
+ }
+}
+
+bool battery_power_on_sample(void) {
+ return power_on_sample < VOLTAGE_POWER_ON_MEASURE_COUNT;
+}
+
+void battery_task(void) {
+ uint32_t t = rtc_timer_elapsed_ms(bat_monitor_timer_buffer);
+ if ((get_transport() & TRANSPORT_WIRELESS) && (wireless_get_state() == WT_CONNECTED || battery_power_on_sample())) {
+#if defined(BAT_CHARGING_PIN)
+ if (usb_power_connected() && t > VOLTAGE_MEASURE_INTERVAL) {
+ if (gpio_read_pin(BAT_CHARGING_PIN) == BAT_CHARGING_LEVEL)
+ lkbt51_update_bat_state(BAT_CHARGING);
+ else
+ lkbt51_update_bat_state(BAT_FULL_CHARGED);
+ }
+#endif
+
+ if ((battery_power_on_sample()
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+ && !indicator_is_enabled()
+#endif
+ && t > BACKLIGHT_OFF_VOLTAGE_MEASURE_INTERVAL) ||
+ t > VOLTAGE_MEASURE_INTERVAL) {
+
+ battery_check_empty();
+ battery_check_critical_low();
+
+ bat_monitor_timer_buffer = rtc_timer_read_ms();
+ if (bat_monitor_timer_buffer > RTC_MAX_TIME) {
+ bat_monitor_timer_buffer = 0;
+ rtc_timer_clear();
+ }
+
+ battery_measure();
+ if (power_on_sample < VOLTAGE_POWER_ON_MEASURE_COUNT) power_on_sample++;
+ }
+ }
+
+ if ((bat_empty || critical_low) && usb_power_connected()) {
+ bat_empty = false;
+ critical_low = false;
+ indicator_battery_low_enable(false);
+ }
+}
diff --git a/keyboards/keychron/common/wireless/battery.h b/keyboards/keychron/common/wireless/battery.h
new file mode 100644
index 0000000000..cbead042da
--- /dev/null
+++ b/keyboards/keychron/common/wireless/battery.h
@@ -0,0 +1,61 @@
+/*/* Copyright 2022 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+enum {
+ BAT_NOT_CHARGING = 0,
+ BAT_CHARGING,
+ BAT_FULL_CHARGED,
+};
+
+#ifndef FULL_VOLTAGE_VALUE
+# define FULL_VOLTAGE_VALUE 4100
+#endif
+
+#ifndef EMPTY_VOLTAGE_VALUE
+# define EMPTY_VOLTAGE_VALUE 3500
+#endif
+
+#ifndef SHUTDOWN_VOLTAGE_VALUE
+# define SHUTDOWN_VOLTAGE_VALUE 3300
+#endif
+
+#ifndef VOLTAGE_MEASURE_INTERVAL
+# define VOLTAGE_MEASURE_INTERVAL 3000
+#endif
+
+#ifndef VOLTAGE_POWER_ON_MEASURE_COUNT
+# define VOLTAGE_POWER_ON_MEASURE_COUNT 15
+#endif
+
+#ifndef BACKLIGHT_OFF_VOLTAGE_MEASURE_INTERVAL
+# define BACKLIGHT_OFF_VOLTAGE_MEASURE_INTERVAL 200
+#endif
+
+void battery_init(void);
+void battery_stop(void);
+
+void battery_measure(void);
+void battery_calculate_voltage(bool vol_src_bt, uint16_t value);
+void battery_set_voltage(uint16_t value);
+uint16_t battery_get_voltage(void);
+uint8_t battery_get_percentage(void);
+bool battery_is_empty(void);
+bool battery_is_critical_low(void);
+bool battery_power_on_sample(void);
+
+void battery_task(void);
diff --git a/keyboards/keychron/common/wireless/indicator.c b/keyboards/keychron/common/wireless/indicator.c
new file mode 100644
index 0000000000..3b24919683
--- /dev/null
+++ b/keyboards/keychron/common/wireless/indicator.c
@@ -0,0 +1,770 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "indicator.h"
+#include "transport.h"
+#include "battery.h"
+#include "eeconfig.h"
+#include "wireless_config.h"
+#include "config.h"
+#include "rtc_timer.h"
+#include "keychron_common.h"
+#include "usb_main.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+#endif
+#include "lpm.h"
+#include "keychron_task.h"
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+# ifdef LED_MATRIX_ENABLE
+# include "led_matrix.h"
+# endif
+# ifdef RGB_MATRIX_ENABLE
+# include "rgb_matrix.h"
+# endif
+# include "bat_level_animation.h"
+# include "eeprom.h"
+#endif
+
+#define HOST_INDEX_MASK 0x0F
+#define HOST_P2P4G 0x10
+#define LED_ON 0x80
+
+// #define RGB_MATRIX_TIMEOUT_INFINITE 0xFFFFFFFF
+#ifdef LED_MATRIX_ENABLE
+# define DECIDE_TIME(t, duration) (duration == 0 ? LED_MATRIX_TIMEOUT_INFINITE : ((t > duration) ? t : duration))
+#endif
+#ifdef RGB_MATRIX_ENABLE
+# define DECIDE_TIME(t, duration) (duration == 0 ? RGB_MATRIX_TIMEOUT_INFINITE : ((t > duration) ? t : duration))
+#endif
+
+#define INDICATOR_SET(s) memcpy(&indicator_config, &s##_config, sizeof(indicator_config_t));
+
+enum {
+ BACKLIGHT_OFF = 0x00,
+ BACKLIGHT_ON_CONNECTED = 0x01,
+ BACKLIGHT_ON_UNCONNECTED = 0x02,
+};
+
+static indicator_config_t pairing_config = INDICATOR_CONFIG_PARING;
+static indicator_config_t connected_config = INDICATOR_CONFIG_CONNECTD;
+static indicator_config_t reconnecting_config = INDICATOR_CONFIG_RECONNECTING;
+static indicator_config_t disconnected_config = INDICATOR_CONFIG_DISCONNECTED;
+indicator_config_t indicator_config;
+static wt_state_t indicator_state;
+static uint16_t next_period;
+static indicator_type_t type;
+static uint32_t indicator_timer_buffer = 0;
+
+#if defined(BAT_LOW_LED_PIN) || defined(SPACE_KEY_LOW_BAT_IND)
+static uint32_t bat_low_backlit_indicator = 0;
+static uint8_t bat_low_ind_state = 0;
+static uint32_t rtc_time = 0;
+#endif
+
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+backlight_state_t original_backlight_state;
+
+# ifdef BT_INDCATION_LED_MATRIX_LIST
+static uint8_t bt_ind_led_matrix_list[BT_HOST_DEVICES_COUNT] = BT_INDCATION_LED_MATRIX_LIST;
+# endif
+
+#endif
+
+#ifdef BT_INDICATION_LED_PIN_LIST
+static pin_t bt_led_pin_list[BT_HOST_DEVICES_COUNT] = BT_INDICATION_LED_PIN_LIST;
+#endif
+
+#ifdef P24G_INDICATION_LED_PIN_LIST
+static pin_t p24g_led_pin_list[P24G_HOST_DEVICES_COUNT] = P24G_INDICATION_LED_PIN_LIST;
+#endif
+
+#ifdef LED_MATRIX_ENABLE
+# define LED_DRIVER led_matrix_driver
+# define LED_INDICATORS_KB led_matrix_indicators_bt
+# define LED_INDICATORS_USER led_matrix_indicators_user
+# define LED_NONE_INDICATORS_KB led_matrix_none_indicators_kb
+# define SET_ALL_LED_OFF() led_matrix_set_value_all(0)
+# define SET_LED_OFF(idx) led_matrix_set_value(idx, 0)
+# define SET_LED_ON(idx) led_matrix_set_value(idx, 255)
+# define SET_LED_BT(idx) led_matrix_set_value(idx, 255)
+# define SET_LED_P24G(idx) led_matrix_set_value(idx, 255)
+# define SET_LED_LOW_BAT(idx) led_matrix_set_value(idx, 255)
+# define LED_DRIVER_IS_ENABLED led_matrix_is_enabled
+# define LED_DRIVER_EECONFIG_RELOAD() \
+ eeprom_read_block(&led_matrix_eeconfig, EECONFIG_LED_MATRIX, sizeof(led_matrix_eeconfig)); \
+ if (!led_matrix_eeconfig.mode) { \
+ eeconfig_update_led_matrix_default(); \
+ }
+# define LED_DRIVER_ALLOW_SHUTDOWN led_matrix_driver_allow_shutdown
+# define LED_DRIVER_SHUTDOWN led_matrix_driver_shutdown
+# define LED_DRIVER_EXIT_SHUTDOWN led_matrix_driver_exit_shutdown
+# define LED_DRIVER_ENABLE_NOEEPROM led_matrix_enable_noeeprom
+# define LED_DRIVER_DISABLE_NOEEPROM led_matrix_disable_noeeprom
+# define LED_DRIVER_DISABLE_TIMEOUT_SET led_matrix_disable_timeout_set
+# define LED_DRIVER_DISABLE_TIME_RESET led_matrix_disable_time_reset
+# define LED_DRIVER_TIMEOUTED led_matrix_timeouted
+#endif
+
+#ifdef RGB_MATRIX_ENABLE
+# define LED_DRIVER rgb_matrix_driver
+# define LED_INDICATORS_KB rgb_matrix_indicators_bt
+# define LED_INDICATORS_USER rgb_matrix_indicators_user
+# define LED_NONE_INDICATORS_KB rgb_matrix_none_indicators_kb
+# define SET_ALL_LED_OFF() rgb_matrix_set_color_all(0, 0, 0)
+# define SET_LED_OFF(idx) rgb_matrix_set_color(idx, 0, 0, 0)
+# define SET_LED_ON(idx) rgb_matrix_set_color(idx, 255, 255, 255)
+# define SET_LED_BT(idx) rgb_matrix_set_color(idx, 0, 0, 255)
+# define SET_LED_P24G(idx) rgb_matrix_set_color(idx, 0, 255, 0)
+# define SET_LED_LOW_BAT(idx) rgb_matrix_set_color(idx, 255, 0, 0)
+# define LED_DRIVER_IS_ENABLED rgb_matrix_is_enabled
+# define LED_DRIVER_EECONFIG_RELOAD() \
+ eeprom_read_block(&rgb_matrix_config, EECONFIG_RGB_MATRIX, sizeof(rgb_matrix_config)); \
+ if (!rgb_matrix_config.mode) { \
+ eeconfig_update_rgb_matrix_default(); \
+ }
+# define LED_DRIVER_ALLOW_SHUTDOWN rgb_matrix_driver_allow_shutdown
+# define LED_DRIVER_SHUTDOWN rgb_matrix_driver_shutdown
+# define LED_DRIVER_EXIT_SHUTDOWN rgb_matrix_driver_exit_shutdown
+# define LED_DRIVER_ENABLE_NOEEPROM rgb_matrix_enable_noeeprom
+# define LED_DRIVER_DISABLE_NOEEPROM rgb_matrix_disable_noeeprom
+# define LED_DRIVER_DISABLE_TIMEOUT_SET rgb_matrix_disable_timeout_set
+# define LED_DRIVER_DISABLE_TIME_RESET rgb_matrix_disable_time_reset
+# define LED_DRIVER_TIMEOUTED rgb_matrix_timeouted
+#endif
+
+bool LED_INDICATORS_KB(void);
+
+void indicator_init(void) {
+ memset(&indicator_config, 0, sizeof(indicator_config));
+
+#if defined(BT_INDICATION_LED_PIN_LIST)
+ for (uint8_t i = 0; i < BT_HOST_DEVICES_COUNT; i++) {
+ gpio_set_pin_output_push_pull(bt_led_pin_list[i]);
+ gpio_write_pin(bt_led_pin_list[i], !BT_INDICATION_LED_ON_STATE);
+ }
+#endif
+
+#ifdef P24G_INDICATION_LED_PIN_LIST
+ for (uint8_t i = 0; i < P24G_HOST_DEVICES_COUNT; i++) {
+ gpio_set_pin_output_push_pull(p24g_led_pin_list[i]);
+ gpio_write_pin(p24g_led_pin_list[i], !BT_INDICATION_LED_ON_STATE);
+ }
+#endif
+
+#ifdef COMMON_BT_LED_PIN
+ gpio_set_pin_output_push_pull(COMMON_BT_LED_PIN);
+ gpio_write_pin(COMMON_BT_LED_PIN, !COMMON_BT_LED_PIN_ON_STATE);
+#endif
+
+#ifdef COMMON_P24G_LED_PIN
+ gpio_set_pin_output_push_pull(COMMON_P24G_LED_PIN);
+ gpio_write_pin(COMMON_P24G_LED_PIN, !COMMON_BT_LED_PIN_ON_STATE);
+#endif
+
+#ifdef BAT_LOW_LED_PIN
+# ifdef POWER_ON_LED_DURATION
+ if (timer_read32() > POWER_ON_LED_DURATION)
+# endif
+ {
+ gpio_set_pin_output_push_pull(BAT_LOW_LED_PIN);
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+ }
+#endif
+}
+
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+void indicator_enable(void) {
+ if (!LED_DRIVER_IS_ENABLED()) {
+ LED_DRIVER_ENABLE_NOEEPROM();
+ }
+}
+
+inline void indicator_disable(void) {
+ LED_DRIVER_DISABLE_NOEEPROM();
+}
+
+void indicator_set_backlit_timeout(uint32_t time) {
+ LED_DRIVER_DISABLE_TIMEOUT_SET(time);
+}
+
+static inline void indicator_reset_backlit_time(void) {
+ LED_DRIVER_DISABLE_TIME_RESET();
+}
+
+bool indicator_is_enabled(void) {
+ return LED_DRIVER_IS_ENABLED();
+}
+
+void indicator_eeconfig_reload(void) {
+ LED_DRIVER_EECONFIG_RELOAD();
+}
+
+#endif
+
+bool indicator_is_running(void) {
+ return
+#if defined(BAT_LOW_LED_PIN) || defined(SPACE_KEY_LOW_BAT_IND)
+ bat_low_ind_state ||
+#endif
+ !!indicator_config.value;
+}
+
+static void indicator_timer_cb(void *arg) {
+ if (*(indicator_type_t *)arg != INDICATOR_LAST) type = *(indicator_type_t *)arg;
+
+ bool time_up = false;
+ switch (type) {
+ case INDICATOR_NONE:
+ break;
+ case INDICATOR_OFF:
+ next_period = 0;
+ time_up = true;
+ break;
+
+ case INDICATOR_ON:
+ if (indicator_config.value) {
+ if (indicator_config.elapsed == 0) {
+ indicator_config.value |= LED_ON;
+
+ if (indicator_config.duration) {
+ indicator_config.elapsed += indicator_config.duration;
+ }
+ } else
+ time_up = true;
+ }
+ break;
+
+ case INDICATOR_ON_OFF:
+ if (indicator_config.value) {
+ if (indicator_config.elapsed == 0) {
+ indicator_config.value |= LED_ON;
+ next_period = indicator_config.on_time;
+ } else {
+ indicator_config.value = indicator_config.value & 0x1F;
+ next_period = indicator_config.duration - indicator_config.on_time;
+ }
+
+ if ((indicator_config.duration == 0 || indicator_config.elapsed <= indicator_config.duration) && next_period != 0) {
+ indicator_config.elapsed += next_period;
+ } else {
+ time_up = true;
+ }
+ }
+ break;
+
+ case INDICATOR_BLINK:
+ if (indicator_config.value) {
+ if (indicator_config.value & LED_ON) {
+ indicator_config.value = indicator_config.value & 0x1F;
+ next_period = indicator_config.off_time;
+ } else {
+ indicator_config.value |= LED_ON;
+ next_period = indicator_config.on_time;
+ }
+
+ if ((indicator_config.duration == 0 || indicator_config.elapsed <= indicator_config.duration) && next_period != 0) {
+ indicator_config.elapsed += next_period;
+ } else {
+ time_up = true;
+ }
+ }
+ break;
+ default:
+ time_up = true;
+
+ next_period = 0;
+ break;
+ }
+
+#if defined(BT_INDICATION_LED_PIN_LIST) || defined(P24G_INDICATION_LED_PIN_LIST) || defined(COMMON_BT_LED_PIN) || defined(COMMON_P24G_LED_PIN)
+ if (indicator_config.value) {
+ uint8_t idx = (indicator_config.value & HOST_INDEX_MASK) - 1;
+# if defined(BT_INDICATION_LED_PIN_LIST) || defined(P24G_INDICATION_LED_PIN_LIST)
+ pin_t *led_lin_list = NULL;
+# endif
+# if defined(COMMON_BT_LED_PIN) || defined(COMMON_P24G_LED_PIN)
+ pin_t led_pin = NO_PIN;
+# endif
+ uint8_t led_count;
+# if defined(P24G_INDICATION_LED_PIN_LIST) || defined(COMMON_P24G_LED_PIN)
+ if (indicator_config.value & HOST_P2P4G) {
+ if (idx < P24G_HOST_DEVICES_COUNT) {
+# if defined(P24G_INDICATION_LED_PIN_LIST)
+ led_lin_list = p24g_led_pin_list;
+# endif
+# if defined(COMMON_P24G_LED_PIN)
+ led_pin = COMMON_P24G_LED_PIN;
+# endif
+ }
+ led_count = P24G_HOST_DEVICES_COUNT;
+ } else
+# endif
+ {
+ if (idx < BT_HOST_DEVICES_COUNT) {
+# if defined(BT_INDICATION_LED_PIN_LIST)
+ led_lin_list = bt_led_pin_list;
+# endif
+# if defined(COMMON_BT_LED_PIN)
+ led_pin = COMMON_BT_LED_PIN;
+# endif
+ }
+ led_count = BT_HOST_DEVICES_COUNT;
+ }
+
+#if defined(BT_INDICATION_LED_PIN_LIST) || defined(P24G_INDICATION_LED_PIN_LIST)
+ for (uint8_t i = 0; i < led_count; i++) {
+ if (i != idx) {
+ if (led_lin_list) gpio_write_pin(led_lin_list[idx], !BT_INDICATION_LED_ON_STATE);
+ }
+ }
+#endif
+
+ if ((indicator_config.value & LED_ON) && !time_up) {
+ if (led_lin_list) gpio_write_pin(led_lin_list[idx], BT_INDICATION_LED_ON_STATE);
+# if defined(COMMON_BT_LED_PIN) || defined(COMMON_P24G_LED_PIN)
+ if (led_pin != NO_PIN) gpio_write_pin(led_pin, COMMON_BT_LED_PIN_ON_STATE);
+# endif
+ } else {
+ if (led_lin_list) gpio_write_pin(led_lin_list[idx], !BT_INDICATION_LED_ON_STATE);
+# if defined(COMMON_BT_LED_PIN) || defined(COMMON_P24G_LED_PIN)
+ if (led_pin != NO_PIN) gpio_write_pin(led_pin, !COMMON_BT_LED_PIN_ON_STATE);
+# endif
+ }
+
+ }
+#endif
+
+ if (time_up) {
+ /* Set indicator to off on timeup, avoid keeping light up until next update in raindrop effect */
+ indicator_config.value = indicator_config.value & 0x1F;
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+ LED_INDICATORS_KB();
+#endif
+
+ indicator_config.value = 0;
+ lpm_timer_reset();
+ }
+
+ if (indicator_config.value == 0) {
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+ indicator_eeconfig_reload();
+ if (!LED_DRIVER_IS_ENABLED()) indicator_disable();
+#endif
+ }
+}
+
+void indicator_set(wt_state_t state, uint8_t host_index) {
+ if (get_transport() == TRANSPORT_USB) return;
+
+ static uint8_t pre_state = 0;
+ static uint8_t current_state = 0;
+ static uint8_t current_host = 0;
+ bool host_index_changed = false;
+
+ if (host_index == 24) host_index = HOST_P2P4G | 0x01;
+
+ if (current_host != host_index && state != WT_DISCONNECTED) {
+ host_index_changed = true;
+ current_host = host_index;
+ }
+
+ if (current_state != state || host_index_changed || state == WT_RECONNECTING) {
+ // Some BT chips need to reset to enter sleep mode, ignore it.
+ if (current_state == WT_SUSPEND && state == WT_DISCONNECTED) return;
+
+ pre_state = current_state;
+ current_state = state;
+ (void)pre_state;
+ } else {
+ return;
+ }
+
+ indicator_timer_buffer = timer_read32();
+
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+ /* Turn on backlight mode for indicator */
+ indicator_enable();
+ indicator_reset_backlit_time();
+#endif
+
+ switch (state) {
+ case WT_DISCONNECTED:
+#if defined(BT_INDICATION_LED_PIN_LIST)
+ if ((host_index & HOST_P2P4G) != HOST_P2P4G) gpio_write_pin(bt_led_pin_list[(host_index & HOST_INDEX_MASK) - 1], !BT_INDICATION_LED_ON_STATE);
+#endif
+#if defined(P24G_INDICATION_LED_PIN_LIST)
+ if (host_index & HOST_P2P4G) gpio_write_pin(p24g_led_pin_list[(host_index & HOST_INDEX_MASK) - 1], !BT_INDICATION_LED_ON_STATE);
+#endif
+#ifdef COMMON_BT_LED_PIN
+ gpio_write_pin(COMMON_BT_LED_PIN, !COMMON_BT_LED_PIN_ON_STATE);
+#endif
+#ifdef COMMON_P24G_LED_PIN
+ gpio_write_pin(COMMON_P24G_LED_PIN, !COMMON_BT_LED_PIN_ON_STATE);
+#endif
+ INDICATOR_SET(disconnected);
+ indicator_config.value = (indicator_config.type == INDICATOR_NONE) ? 0 : host_index;
+ indicator_timer_cb((void *)&indicator_config.type);
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+ if (battery_is_critical_low()) {
+ indicator_set_backlit_timeout(1000);
+
+ } else {
+ if (pre_state == WT_CONNECTED)
+ indicator_set_backlit_timeout(1000);
+ else
+ /* Set timer so that user has chance to turn on the backlight when is off */
+ indicator_set_backlit_timeout(DECIDE_TIME(DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT * 1000, indicator_config.duration));
+ }
+#endif
+ break;
+
+ case WT_CONNECTED:
+ if (indicator_state != WT_CONNECTED) {
+ INDICATOR_SET(connected);
+ indicator_config.value = (indicator_config.type == INDICATOR_NONE) ? 0 : host_index;
+ indicator_timer_cb((void *)&indicator_config.type);
+ }
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+ indicator_set_backlit_timeout(DECIDE_TIME(CONNECTED_BACKLIGHT_DISABLE_TIMEOUT * 1000, indicator_config.duration));
+#endif
+ break;
+
+ case WT_PARING:
+ INDICATOR_SET(pairing);
+ indicator_config.value = (indicator_config.type == INDICATOR_NONE) ? 0 : LED_ON | host_index;
+ indicator_timer_cb((void *)&indicator_config.type);
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+ indicator_set_backlit_timeout(DECIDE_TIME(DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT * 1000, indicator_config.duration));
+#endif
+ break;
+
+ case WT_RECONNECTING:
+ INDICATOR_SET(reconnecting);
+ indicator_config.value = (indicator_config.type == INDICATOR_NONE) ? 0 : LED_ON | host_index;
+ indicator_timer_cb((void *)&indicator_config.type);
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+ indicator_set_backlit_timeout(DECIDE_TIME(DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT * 1000, indicator_config.duration));
+#endif
+ break;
+
+ case WT_SUSPEND:
+ INDICATOR_SET(disconnected);
+ indicator_config.value = (indicator_config.type == INDICATOR_NONE) ? 0 : host_index;
+ indicator_timer_cb((void *)&indicator_config.type);
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+# ifdef FACTORY_TEST_ENABLE
+ if (factory_reset_indicating())
+ indicator_set_backlit_timeout(3000);
+ else
+# endif
+ {
+ indicator_set_backlit_timeout(1000);
+ }
+#endif
+
+#if defined(BT_INDICATION_LED_PIN_LIST)
+ for (uint8_t i = 0; i < BT_HOST_DEVICES_COUNT; i++) gpio_write_pin(bt_led_pin_list[i], !BT_INDICATION_LED_ON_STATE);
+#endif
+#if defined(P24G_INDICATION_LED_PIN_LIST)
+ for (uint8_t i = 0; i < P24G_HOST_DEVICES_COUNT; i++) gpio_write_pin(p24g_led_pin_list[i], !BT_INDICATION_LED_ON_STATE);
+#endif
+#ifdef COMMON_BT_LED_PIN
+ gpio_write_pin(COMMON_BT_LED_PIN, !COMMON_BT_LED_PIN_ON_STATE);
+#endif
+#ifdef COMMON_P24G_LED_PIN
+ gpio_write_pin(COMMON_P24G_LED_PIN, !COMMON_BT_LED_PIN_ON_STATE);
+#endif
+
+ break;
+
+ default:
+ break;
+ }
+
+ indicator_state = state;
+}
+
+void indicator_stop(void) {
+ indicator_config.value = 0;
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+ indicator_eeconfig_reload();
+
+ if (indicator_is_enabled()) {
+ indicator_enable();
+ } else {
+ indicator_disable();
+ }
+#endif
+}
+
+void indicator_battery_low_enable(bool enable) {
+#if defined(BAT_LOW_LED_PIN) || defined(SPACE_KEY_LOW_BAT_IND)
+ if (enable) {
+ uint32_t t = rtc_timer_read_ms();
+
+ /* Check overflow */
+ if (rtc_time > t) {
+ if (bat_low_ind_state == 0)
+ rtc_time = t; // Update rtc_time if indicating is not running
+ else {
+ rtc_time += t;
+ }
+ }
+
+ /* Indicating at first time or after the interval */
+ if ((rtc_time == 0 || t - rtc_time > LOW_BAT_LED_TRIG_INTERVAL) && bat_low_ind_state == 0) {
+ bat_low_backlit_indicator = enable ? timer_read32() : 0;
+ rtc_time = rtc_timer_read_ms();
+ bat_low_ind_state = 1;
+# if defined(SPACE_KEY_LOW_BAT_IND)
+ indicator_enable();
+# endif
+ }
+ } else {
+ rtc_time = 0;
+ bat_low_ind_state = 0;
+# if defined(SPACE_KEY_LOW_BAT_IND)
+ indicator_eeconfig_reload();
+ if (!LED_DRIVER_IS_ENABLED()) indicator_disable();
+# endif
+ }
+#endif
+}
+
+void indicator_battery_low(void) {
+#if defined(BAT_LOW_LED_PIN) || defined(SPACE_KEY_LOW_BAT_IND)
+ if (bat_low_ind_state) {
+ if ((bat_low_ind_state & 0x0F) <= (LOW_BAT_LED_BLINK_TIMES) && timer_elapsed32(bat_low_backlit_indicator) > (LOW_BAT_LED_BLINK_PERIOD)) {
+ if (bat_low_ind_state & 0x80) {
+ bat_low_ind_state &= 0x7F;
+ bat_low_ind_state++;
+# if defined(BAT_LOW_LED_PIN)
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+# endif
+ } else {
+ bat_low_ind_state |= 0x80;
+# if defined(BAT_LOW_LED_PIN)
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+# endif
+ }
+
+ bat_low_backlit_indicator = timer_read32();
+
+ /* Restore backligth state */
+ if ((bat_low_ind_state & 0x0F) > (LOW_BAT_LED_BLINK_TIMES)) {
+# if defined(BAT_LOW_LED_PIN)
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+# endif
+# if defined(SPACE_KEY_LOW_BAT_IND)
+# if defined(NUM_LOCK_INDEX) || defined(CAPS_LOCK_INDEX) || defined(SCROLL_LOCK_INDEX) || defined(COMPOSE_LOCK_INDEX) || defined(KANA_LOCK_INDEX)
+ if (LED_DRIVER_ALLOW_SHUTDOWN())
+# endif
+ indicator_disable();
+# endif
+ }
+ } else if ((bat_low_ind_state & 0x0F) > (LOW_BAT_LED_BLINK_TIMES)) {
+# if defined(BAT_LOW_LED_PIN)
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+# endif
+ bat_low_ind_state = 0;
+ lpm_timer_reset();
+ }
+ }
+#endif
+}
+
+void indicator_task(void) {
+#if defined(BAT_LEVEL_LED_LIST)
+ bat_level_animiation_task();
+#endif
+ if (indicator_config.value && timer_elapsed32(indicator_timer_buffer) >= next_period) {
+ indicator_timer_cb((void *)&type);
+ indicator_timer_buffer = timer_read32();
+ }
+
+ indicator_battery_low();
+}
+
+#if defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)
+__attribute__((weak)) void os_state_indicate(void) {
+# if defined(RGB_MATRIX_SLEEP) || defined(LED_MATRIX_SLEEP)
+ if (get_transport() == TRANSPORT_USB && USB_DRIVER.state == USB_SUSPENDED) return;
+# endif
+
+# if defined(NUM_LOCK_INDEX)
+ if (host_keyboard_led_state().num_lock) {
+# if defined(DIM_NUM_LOCK)
+ SET_LED_OFF(NUM_LOCK_INDEX);
+# else
+ SET_LED_ON(NUM_LOCK_INDEX);
+# endif
+ }
+# endif
+# if defined(CAPS_LOCK_INDEX)
+ if (host_keyboard_led_state().caps_lock) {
+# if defined(DIM_CAPS_LOCK)
+ SET_LED_OFF(CAPS_LOCK_INDEX);
+# else
+ SET_LED_ON(CAPS_LOCK_INDEX);
+# endif
+ }
+# endif
+# if defined(SCROLL_LOCK_INDEX)
+ if (host_keyboard_led_state().scroll_lock) {
+ SET_LED_ON(SCROLL_LOCK_INDEX);
+ }
+# endif
+# if defined(COMPOSE_LOCK_INDEX)
+ if (host_keyboard_led_state().compose) {
+ SET_LED_ON(COMPOSE_LOCK_INDEX);
+ }
+# endif
+# if defined(KANA_LOCK_INDEX)
+ if (host_keyboard_led_state().kana) {
+ SET_LED_ON(KANA_LOCK_INDEX);
+ }
+# endif
+}
+
+bool LED_INDICATORS_KB(void) {
+ if (get_transport() & TRANSPORT_WIRELESS) {
+ /* Prevent backlight flash caused by key activities */
+ if (battery_is_critical_low()) {
+ SET_ALL_LED_OFF();
+ return true;
+ }
+
+ if (battery_is_empty()) SET_ALL_LED_OFF();
+# if defined(LOW_BAT_IND_INDEX)
+ if (bat_low_ind_state && (bat_low_ind_state & 0x0F) <= LOW_BAT_LED_BLINK_TIMES) {
+ uint8_t idx_list[] = LOW_BAT_IND_INDEX;
+ for (uint8_t i = 0; i < sizeof(idx_list); i++) {
+ if (bat_low_ind_state & LED_ON) {
+ SET_LED_LOW_BAT(idx_list[i]);
+ } else {
+ SET_LED_OFF(idx_list[i]);
+ }
+ }
+ }
+# endif
+
+# if (defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)) && defined(BAT_LEVEL_LED_LIST)
+ if (bat_level_animiation_actived()) {
+ bat_level_animiation_indicate();
+ }
+# endif
+ static uint8_t last_host_index = 0xFF;
+
+ if (indicator_config.value) {
+ uint8_t host_index = indicator_config.value & HOST_INDEX_MASK;
+
+ if (indicator_config.highlight) {
+ SET_ALL_LED_OFF();
+ } else if (last_host_index != host_index) {
+# ifdef P24G_INDICATION_LED_MATRIX_INDEX
+ if (indicator_config.value & HOST_P2P4G)
+ SET_LED_OFF(P24G_INDICATION_LED_MATRIX_INDEX);
+ else
+# endif
+# ifdef BT_INDCATION_LED_MATRIX_LIST
+ SET_LED_OFF(bt_ind_led_matrix_list[host_index - 1]);
+# endif
+ last_host_index = host_index;
+ }
+
+ if (indicator_config.value & LED_ON) {
+# ifdef P24G_INDICATION_LED_MATRIX_INDEX
+ if (indicator_config.value & HOST_P2P4G)
+ SET_LED_P24G(P24G_INDICATION_LED_MATRIX_INDEX);
+ else
+# endif
+# ifdef BT_INDCATION_LED_MATRIX_LIST
+ SET_LED_BT(bt_ind_led_matrix_list[host_index - 1]);
+# endif
+ } else {
+# ifdef P24G_INDICATION_LED_MATRIX_INDEX
+ if (indicator_config.value & HOST_P2P4G)
+ SET_LED_OFF(P24G_INDICATION_LED_MATRIX_INDEX);
+ else
+# endif
+# ifdef BT_INDCATION_LED_MATRIX_LIST
+ SET_LED_OFF(bt_ind_led_matrix_list[host_index - 1]);
+# endif
+ }
+ } else
+ os_state_indicate();
+
+ } else
+ os_state_indicate();
+
+ if (!LED_INDICATORS_USER()) return true;
+
+ return true;
+}
+
+bool led_update_kb(led_t led_state) {
+ bool res = led_update_user(led_state);
+ if (res) {
+ led_update_ports(led_state);
+
+ if (!LED_DRIVER_IS_ENABLED() || (LED_DRIVER_IS_ENABLED() && LED_DRIVER_TIMEOUTED())) {
+# if defined(LED_MATRIX_DRIVER_SHUTDOWN_ENABLE) || defined(RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE)
+ LED_DRIVER_EXIT_SHUTDOWN();
+# endif
+ SET_ALL_LED_OFF();
+ os_state_indicate();
+ LED_DRIVER.flush();
+# if defined(LED_MATRIX_DRIVER_SHUTDOWN_ENABLE) || defined(RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE)
+ if (LED_DRIVER_ALLOW_SHUTDOWN()) LED_DRIVER_SHUTDOWN();
+# endif
+ }
+ }
+
+ return res;
+}
+
+void LED_NONE_INDICATORS_KB(void) {
+# if defined(RGB_MATRIX_SLEEP) || defined(LED_MATRIX_SLEEP)
+ if (get_transport() == TRANSPORT_USB && USB_DRIVER.state == USB_SUSPENDED) return;
+# endif
+
+ os_state_indicate();
+}
+
+# if defined(LED_MATRIX_DRIVER_SHUTDOWN_ENABLE) || defined(RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE)
+bool LED_DRIVER_ALLOW_SHUTDOWN(void) {
+# if defined(NUM_LOCK_INDEX)
+ if (host_keyboard_led_state().num_lock) return false;
+# endif
+# if defined(CAPS_LOCK_INDEX) && !defined(DIM_CAPS_LOCK)
+ if (host_keyboard_led_state().caps_lock) return false;
+# endif
+# if defined(SCROLL_LOCK_INDEX)
+ if (host_keyboard_led_state().scroll_lock) return false;
+# endif
+# if defined(COMPOSE_LOCK_INDEX)
+ if (host_keyboard_led_state().compose) return false;
+# endif
+# if defined(KANA_LOCK_INDEX)
+ if (host_keyboard_led_state().kana) return false;
+# endif
+ return true;
+}
+# endif
+
+#endif
diff --git a/keyboards/keychron/common/wireless/indicator.h b/keyboards/keychron/common/wireless/indicator.h
new file mode 100644
index 0000000000..468332cebe
--- /dev/null
+++ b/keyboards/keychron/common/wireless/indicator.h
@@ -0,0 +1,114 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include "config.h"
+#include "wireless.h"
+
+/* Indication of pairing */
+#ifndef INDICATOR_CONFIG_PARING
+# define INDICATOR_CONFIG_PARING {INDICATOR_BLINK, 1000, 1000, 0, true, 0};
+#endif
+
+/* Indication on Connected */
+#ifndef INDICATOR_CONFIG_CONNECTD
+# define INDICATOR_CONFIG_CONNECTD {INDICATOR_ON_OFF, 2000, 250, 2000, true, 0};
+#endif
+
+/* Reconnecting indication */
+#ifndef INDICATOR_CONFIG_RECONNECTING
+# define INDICATOR_CONFIG_RECONNECTING {INDICATOR_BLINK, 100, 100, 600, true, 0};
+#endif
+
+/* Disconnected indication */
+#ifndef INDICATOR_CONFIG_DISCONNECTED
+# define INDICATOR_CONFIG_DISCONNECTED {INDICATOR_NONE, 100, 100, 600, false, 0};
+#endif
+
+/* Uint: Second */
+#ifndef DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+#endif
+
+/* Uint: Second, the timer restarts on key activities. */
+#ifndef CONNECTED_BACKLIGHT_DISABLE_TIMEOUT
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+#endif
+
+/* Uint: ms */
+#ifndef LOW_BAT_LED_BLINK_PERIOD
+# define LOW_BAT_LED_BLINK_PERIOD 1000
+#endif
+
+#ifndef LOW_BAT_LED_BLINK_TIMES
+# define LOW_BAT_LED_BLINK_TIMES 5
+#endif
+
+#ifndef LOW_BAT_LED_TRIG_INTERVAL
+# define LOW_BAT_LED_TRIG_INTERVAL 30000
+#endif
+
+#if ((defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)) && defined(LOW_BAT_IND_INDEX))
+# define SPACE_KEY_LOW_BAT_IND
+#endif
+
+#if BT_HOST_MAX_COUNT > 6
+# pragma error("HOST_COUNT max value is 6")
+#endif
+
+#ifndef P24G_HOST_DEVICES_COUNT
+# define P24G_HOST_DEVICES_COUNT 1
+#endif
+
+typedef enum {
+ INDICATOR_NONE,
+ INDICATOR_OFF,
+ INDICATOR_ON,
+ INDICATOR_ON_OFF,
+ INDICATOR_BLINK,
+ INDICATOR_LAST,
+} indicator_type_t;
+
+typedef struct {
+ indicator_type_t type;
+ uint32_t on_time;
+ uint32_t off_time;
+ uint32_t duration;
+ bool highlight;
+ uint8_t value;
+ uint32_t elapsed;
+} indicator_config_t;
+
+typedef struct {
+ uint8_t value;
+ bool saved;
+} backlight_state_t;
+
+void indicator_init(void);
+void indicator_set(wt_state_t state, uint8_t host_index);
+void indicator_set_backlit_timeout(uint32_t time);
+void indicator_backlight_timer_reset(bool enable);
+bool indicator_hook_key(uint16_t keycode);
+void indicator_enable(void);
+void indicator_disable(void);
+void indicator_stop(void);
+void indicator_eeconfig_reload(void);
+bool indicator_is_enabled(void);
+bool indicator_is_running(void);
+void indicator_battery_low_enable(bool enable);
+
+void indicator_task(void);
diff --git a/keyboards/keychron/common/wireless/keychron_wireless_common.c b/keyboards/keychron/common/wireless/keychron_wireless_common.c
new file mode 100644
index 0000000000..eb7c4ac095
--- /dev/null
+++ b/keyboards/keychron/common/wireless/keychron_wireless_common.c
@@ -0,0 +1,171 @@
+/* Copyright 2022 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "indicator.h"
+# include "transport.h"
+# include "battery.h"
+# include "bat_level_animation.h"
+# include "lpm.h"
+# include "keychron_wireless_common.h"
+# include "keychron_task.h"
+#endif
+#include "keychron_common.h"
+
+bool firstDisconnect = true;
+
+static uint32_t pairing_key_timer;
+static uint8_t host_idx = 0;
+
+bool process_record_keychron_wireless(uint16_t keycode, keyrecord_t *record) {
+ static uint8_t host_idx;
+
+ switch (keycode) {
+ case BT_HST1 ... BT_HST3:
+ if (get_transport() == TRANSPORT_BLUETOOTH) {
+ if (record->event.pressed) {
+ host_idx = keycode - BT_HST1 + 1;
+
+ pairing_key_timer = timer_read32();
+ wireless_connect_ex(host_idx, 0);
+ } else {
+ host_idx = 0;
+ pairing_key_timer = 0;
+ }
+ }
+ break;
+ case P2P4G:
+ if (get_transport() == TRANSPORT_P2P4) {
+ if (record->event.pressed) {
+ host_idx = P24G_INDEX;
+
+ pairing_key_timer = timer_read32();
+ } else {
+ host_idx = 0;
+ pairing_key_timer = 0;
+ }
+ }
+ break;
+#if (defined(LED_MATRIX_ENABLE) || defined(RGB_MATRIX_ENABLE)) && defined(BAT_LEVEL_LED_LIST)
+ case BAT_LVL:
+ if ((get_transport() & TRANSPORT_WIRELESS) && !usb_power_connected()) {
+ bat_level_animiation_start(battery_get_percentage());
+ }
+ break;
+#endif
+
+ default:
+ break;
+ }
+
+ return true;
+}
+
+void lkbt51_param_init(void) {
+ /* Set bluetooth device name */
+ lkbt51_set_local_name(PRODUCT);
+ wait_ms(3);
+ // clang-format off
+ /* Set bluetooth parameters */
+ module_param_t param = {.event_mode = 0x02,
+ .connected_idle_timeout = 7200,
+ .pairing_timeout = 180,
+ .pairing_mode = 0,
+ .reconnect_timeout = 5,
+ .report_rate = 90,
+ .vendor_id_source = 1,
+ .verndor_id = 0x3434, // Must be 0x3434
+ .product_id = PRODUCT_ID};
+ // clang-format on
+ lkbt51_set_param(¶m);
+}
+
+void wireless_enter_reset_kb(uint8_t reason) {
+ lkbt51_param_init();
+}
+
+void wireless_enter_disconnected_kb(uint8_t host_idx, uint8_t reason) {
+ /* CKBT51 bluetooth module boot time is slower, it enters disconnected after boot,
+ so we place initialization here. */
+ if (firstDisconnect && timer_read32() < 1000) {
+ lkbt51_param_init();
+ if (get_transport() == TRANSPORT_BLUETOOTH) wireless_connect();
+ firstDisconnect = false;
+ }
+}
+
+void keychron_wireless_common_task(void) {
+ if (pairing_key_timer) {
+ if (timer_elapsed32(pairing_key_timer) > 2000) {
+ pairing_key_timer = 0;
+ wireless_pairing_ex(host_idx, NULL);
+ }
+ }
+}
+
+void wireless_pre_task(void) {
+ static uint8_t dip_switch_state = 0;
+ static uint32_t time = 0;
+
+ if (time == 0) {
+ uint8_t pins_state = (gpio_read_pin(BT_MODE_SELECT_PIN) << 1)
+# ifdef P24G_MODE_SELECT_PIN
+ | gpio_read_pin(P24G_MODE_SELECT_PIN)
+# endif
+ ;
+
+ if (pins_state != dip_switch_state) {
+ dip_switch_state = pins_state;
+ time = timer_read32();
+ }
+ }
+
+ if ((time && timer_elapsed32(time) > 100) || get_transport() == TRANSPORT_NONE) {
+ uint8_t pins_state = (gpio_read_pin(BT_MODE_SELECT_PIN) << 1)
+# ifdef P24G_MODE_SELECT_PIN
+ | gpio_read_pin(P24G_MODE_SELECT_PIN)
+# endif
+ ;
+
+ if (pins_state == dip_switch_state) {
+ time = 0;
+
+ switch (dip_switch_state) {
+# ifndef P24G_MODE_SELECT_PIN
+ case 0x00:
+ set_transport(TRANSPORT_BLUETOOTH);
+ break;
+# else
+ case 0x01:
+ set_transport(TRANSPORT_BLUETOOTH);
+ break;
+ case 0x02:
+ set_transport(TRANSPORT_P2P4);
+ break;
+# endif
+ default:
+ set_transport(TRANSPORT_USB);
+ break;
+ }
+ } else {
+ dip_switch_state = pins_state;
+ time = timer_read32();
+ }
+ }
+}
diff --git a/keyboards/keychron/common/wireless/keychron_wireless_common.h b/keyboards/keychron/common/wireless/keychron_wireless_common.h
new file mode 100644
index 0000000000..4ed4151606
--- /dev/null
+++ b/keyboards/keychron/common/wireless/keychron_wireless_common.h
@@ -0,0 +1,26 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "stdint.h"
+#ifdef VIA_ENABLE
+# include "via.h"
+#endif
+#include "quantum_keycodes.h"
+
+void lkbt51_param_init(void);
+
+bool process_record_keychron_wireless(uint16_t keycode, keyrecord_t *record);
+void keychron_wireless_common_task(void);
diff --git a/keyboards/keychron/common/wireless/lkbt51.c b/keyboards/keychron/common/wireless/lkbt51.c
new file mode 100644
index 0000000000..ccf618c5cb
--- /dev/null
+++ b/keyboards/keychron/common/wireless/lkbt51.c
@@ -0,0 +1,885 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "lkbt51.h"
+#include "wireless.h"
+#include "wireless_event_type.h"
+#include "battery.h"
+#include "raw_hid.h"
+#include "report_buffer.h"
+#include "factory_test.h"
+
+extern void factory_test_send(uint8_t* payload, uint8_t length);
+
+#ifndef RAW_EPSIZE
+# define RAW_EPSIZE 32
+#endif
+
+#ifndef SPI_SCK_PIN
+# define SPI_SCK_PIN A5
+#endif
+#ifndef SPI_MISO_PIN
+# define SPI_MISO_PIN A6
+#endif
+#ifndef SPI_MOSI_PIN
+# define SPI_MOSI_PIN A7
+#endif
+
+#ifndef SPI_CLK_PAL_MODE
+# define SPI_CLK_PAL_MODE 5
+#endif
+#ifndef SPI_MISO_PAL_MODE
+# define SPI_MISO_PAL_MODE 5
+#endif
+#ifndef SPI_MOSI_PAL_MODE
+# define SPI_MOSI_PAL_MODE 5
+#endif
+
+#ifndef LKBT51_INT_INPUT_PIN
+# error "LKBT51_INT_INPUT_PIN is not defined"
+#endif
+
+#ifndef LKBT51_TX_RETRY_COUNT
+# define LKBT51_TX_RETRY_COUNT 3
+#endif
+
+// clang-format off
+enum {
+ /* HID Report */
+ LKBT51_CMD_SEND_KB = 0x11,
+ LKBT51_CMD_SEND_KB_NKRO = 0x12,
+ LKBT51_CMD_SEND_CONSUMER = 0x13,
+ LKBT51_CMD_SEND_SYSTEM = 0x14,
+ LKBT51_CMD_SEND_FN = 0x15, // Not used currently
+ LKBT51_CMD_SEND_MOUSE = 0x16,
+ LKBT51_CMD_SEND_BOOT_KB = 0x17,
+ /* Bluetooth connections */
+ LKBT51_CMD_PAIRING = 0x21,
+ LKBT51_CMD_CONNECT = 0x22,
+ LKBT51_CMD_DISCONNECT = 0x23,
+ LKBT51_CMD_SWITCH_HOST = 0x24,
+ LKBT51_CMD_READ_STATE_REG = 0x25,
+ /* Battery */
+ LKBT51_CMD_BATTERY_MANAGE = 0x31,
+ LKBT51_CMD_UPDATE_BAT_LVL = 0x32,
+ LKBT51_CMD_UPDATE_BAT_STATE = 0x33,
+ /* Set/get parameters */
+ LKBT51_CMD_GET_MODULE_INFO = 0x40,
+ LKBT51_CMD_SET_CONFIG = 0x41,
+ LKBT51_CMD_GET_CONFIG = 0x42,
+ LKBT51_CMD_SET_BDA = 0x43,
+ LKBT51_CMD_GET_BDA = 0x44,
+ LKBT51_CMD_SET_NAME = 0x45,
+ LKBT51_CMD_GET_NAME = 0x46,
+ LKBT51_CMD_WRTE_CSTM_DATA = 0x49,
+ /* DFU */
+ LKBT51_CMD_GET_DFU_VER = 0x60,
+ LKBT51_CMD_HAND_SHAKE_TOKEN = 0x61,
+ LKBT51_CMD_START_DFU = 0x62,
+ LKBT51_CMD_SEND_FW_DATA = 0x63,
+ LKBT51_CMD_VERIFY_CRC32 = 0x64,
+ LKBT51_CMD_SWITCH_FW = 0x65,
+ /* Factory test */
+ LKBT51_CMD_FACTORY_RESET = 0x71,
+ LKBT51_CMD_IO_TEST = 0x72,
+ LKBT51_CMD_RADIO_TEST = 0x73,
+ /* Event */
+ LKBT51_EVT_LKBT51_CMD_RECEIVED = 0xA1,
+ LKBT51_EVT_OTA_RSP = 0xA3,
+ LKBT51_CONNECTION_EVT_ACK = 0xA4,
+};
+
+enum {
+ LKBT51_EVT_ACK = 0xA1,
+ LKBT51_EVT_QUERY_RSP = 0xA2,
+ LKBT51_EVT_RESET = 0xB0,
+ LKBT51_EVT_LE_CONNECTION = 0xB1,
+ LKBT51_EVT_HOST_TYPE = 0xB2,
+ LKBT51_EVT_CONNECTION = 0xB3,
+ LKBT51_EVT_HID_EVENT = 0xB4,
+ LKBT51_EVT_BATTERY = 0xB5,
+};
+
+enum {
+ LKBT51_CONNECTED = 0x20,
+ LKBT51_DISCOVERABLE = 0x21,
+ LKBT51_RECONNECTING = 0x22,
+ LKBT51_DISCONNECTED = 0x23,
+ LKBT51_PINCODE_ENTRY = 0x24,
+ LKBT51_EXIT_PINCODE_ENTRY = 0x25,
+ LKBT51_SLEEP = 0x26
+};
+
+enum {
+ ACK_SUCCESS = 0x00,
+ ACK_CHECKSUM_ERROR,
+ ACK_FIFO_HALF_WARNING,
+ ACK_FIFO_FULL_ERROR,
+};
+
+enum{
+ LK_EVT_MSK_CONNECTION = 0x01 << 0,
+ LK_EVT_MSK_LED = 0x01 << 1,
+ LK_EVT_MSK_BATT = 0x01 << 2,
+ LK_EVT_MSK_RESET = 0x01 << 3,
+ LK_EVT_MSK_RPT_INTERVAL = 0x01 << 4,
+ LK_EVT_MSK_MD = 0x01 << 7,
+};
+
+// clang-format on
+
+static uint8_t payload[PACKET_MAX_LEN];
+static uint8_t reg_offset = 0xFF;
+static uint8_t expect_len = 22;
+static uint16_t connection_interval = 1;
+static uint32_t wake_time;
+static uint32_t factory_reset = 0;
+
+// clang-format off
+wt_func_t wireless_transport = {
+ lkbt51_init,
+ lkbt51_connect,
+ lkbt51_become_discoverable,
+ lkbt51_disconnect,
+ lkbt51_send_keyboard,
+ lkbt51_send_nkro,
+ lkbt51_send_consumer,
+ lkbt51_send_system,
+ lkbt51_send_mouse,
+ lkbt51_update_bat_lvl,
+ lkbt51_task
+};
+// clang-format on
+
+#if defined(MCU_STM32)
+/* Init SPI */
+const SPIConfig spicfg = {
+ .circular = false,
+ .slave = false,
+ .data_cb = NULL,
+ .error_cb = NULL,
+ .ssport = PAL_PORT(LKBT51_INT_OUTPUT_PIN),
+ .sspad = PAL_PAD(LKBT51_INT_OUTPUT_PIN),
+ .cr1 = SPI_CR1_MSTR | SPI_CR1_BR_1 | SPI_CR1_BR_0,
+ .cr2 = 0U,
+};
+#endif
+
+#if defined(WB32F3G71xx)
+/* Init SPI */
+const SPIConfig spicfg = {
+ .ssport = PAL_PORT(LKBT51_INT_OUTPUT_PIN),
+ .sspad = PAL_PAD(LKBT51_INT_OUTPUT_PIN),
+ .SPI_CPOL = 0U,
+ .SPI_CPHA = 0U,
+ .SPI_BaudRatePrescaler = 32U,
+};
+#endif
+
+void lkbt51_init(bool wakeup_from_low_power_mode) {
+#ifdef LKBT51_RESET_PIN
+ if (!wakeup_from_low_power_mode) {
+ gpio_set_pin_output_push_pull(LKBT51_RESET_PIN);
+ gpio_write_pin_low(LKBT51_RESET_PIN);
+ wait_ms(1);
+ gpio_write_pin_high(LKBT51_RESET_PIN);
+ }
+#endif
+
+#if (HAL_USE_SPI == TRUE)
+ palSetLineMode(SPI_SCK_PIN, PAL_MODE_ALTERNATE(SPI_CLK_PAL_MODE));
+ palSetLineMode(SPI_MISO_PIN, PAL_MODE_ALTERNATE(SPI_MISO_PAL_MODE));
+ palSetLineMode(SPI_MOSI_PIN, PAL_MODE_ALTERNATE(SPI_MOSI_PAL_MODE));
+
+ if (WT_DRIVER.state == SPI_UNINIT) {
+ if (wakeup_from_low_power_mode) {
+ spiInit();
+ return;
+ }
+
+ spiInit();
+ }
+#endif
+
+ gpio_set_pin_output_push_pull(LKBT51_INT_OUTPUT_PIN);
+ gpio_write_pin_high(LKBT51_INT_OUTPUT_PIN);
+
+ gpio_set_pin_input_high(LKBT51_INT_INPUT_PIN);
+}
+
+static inline void lkbt51_wake(void) {
+ if (timer_elapsed32(wake_time) > 3000) {
+ wake_time = timer_read32();
+
+ palWriteLine(LKBT51_INT_OUTPUT_PIN, 0);
+ wait_ms(10);
+ palWriteLine(LKBT51_INT_OUTPUT_PIN, 1);
+ wait_ms(300);
+ }
+}
+
+void lkbt51_send_protocol_ver(uint16_t ver) {
+ uint8_t pkt[PACKET_MAX_LEN] = {0};
+ memset(pkt, 0, PACKET_MAX_LEN);
+
+ uint8_t i = 0;
+
+ pkt[i++] = 0x84;
+ pkt[i++] = 0x7e;
+ pkt[i++] = 0x00;
+ pkt[i++] = 0x00;
+ pkt[i++] = 0xAA;
+ pkt[i++] = 0x54;
+ pkt[i++] = ver & 0xFF;
+ pkt[i++] = (ver >> 8) & 0xFF;
+ pkt[i++] = (uint8_t)(~0x54);
+ pkt[i++] = (uint8_t)(~0xAA);
+
+#if HAL_USE_SPI
+ expect_len = 10;
+ spiStart(&WT_DRIVER, &spicfg);
+ spiSelect(&WT_DRIVER);
+ spiSend(&WT_DRIVER, i, pkt);
+ spiUnselectI(&WT_DRIVER);
+ spiStop(&WT_DRIVER);
+#endif
+}
+
+void lkbt51_send_cmd(uint8_t* payload, uint8_t len, bool ack_enable, bool retry) {
+ static uint8_t sn = 0;
+ uint8_t i;
+ uint8_t pkt[PACKET_MAX_LEN] = {0};
+ memset(pkt, 0, PACKET_MAX_LEN);
+
+ if (!retry) ++sn;
+ if (sn == 0) ++sn;
+
+ uint16_t checksum = 0;
+ for (i = 0; i < len; i++)
+ checksum += payload[i];
+
+ i = 0;
+ pkt[i++] = 0x84;
+ pkt[i++] = 0x7e;
+ pkt[i++] = 0x00;
+ pkt[i++] = 0x00;
+ pkt[i++] = 0xAA;
+ pkt[i++] = ack_enable ? 0x56 : 0x55;
+ pkt[i++] = len + 2;
+ pkt[i++] = ~(len + 2) & 0xFF;
+ pkt[i++] = sn;
+
+ memcpy(pkt + i, payload, len);
+ i += len;
+ pkt[i++] = checksum & 0xFF;
+ pkt[i++] = (checksum >> 8) & 0xFF;
+#if HAL_USE_SPI
+ if ((payload[0] & 0xF0) == 0x60)
+ expect_len = 64;
+ else
+ expect_len = 64;
+
+ spiStart(&WT_DRIVER, &spicfg);
+ spiSelect(&WT_DRIVER);
+ spiSend(&WT_DRIVER, i, pkt);
+ spiUnselectI(&WT_DRIVER);
+ spiStop(&WT_DRIVER);
+#endif
+}
+
+void lkbt51_read(uint8_t* payload, uint8_t len) {
+ uint8_t i;
+ uint8_t pkt[PACKET_MAX_LEN] = {0};
+ memset(pkt, 0, PACKET_MAX_LEN);
+
+ i = 0;
+ pkt[i++] = 0x84;
+ pkt[i++] = 0x7f;
+ pkt[i++] = 0x00;
+ pkt[i++] = 0x80;
+
+ i += len;
+
+#if HAL_USE_SPI
+ spiStart(&WT_DRIVER, &spicfg);
+ spiSelect(&WT_DRIVER);
+ spiExchange(&WT_DRIVER, i, pkt, payload);
+ spiUnselect(&WT_DRIVER);
+ spiStop(&WT_DRIVER);
+#endif
+}
+
+void lkbt51_send_keyboard(uint8_t* report) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_SEND_KB;
+ memcpy(payload + i, report, 8);
+ i += 8;
+
+ lkbt51_send_cmd(payload, i, true, false);
+}
+
+void lkbt51_send_nkro(uint8_t* report) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_SEND_KB_NKRO;
+ memcpy(payload + i, report, 20); // NKRO report lenght is limited to 20 bytes
+ i += 20;
+
+ lkbt51_send_cmd(payload, i, true, false);
+}
+
+void lkbt51_send_consumer(uint16_t report) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_SEND_CONSUMER;
+ payload[i++] = report & 0xFF;
+ payload[i++] = ((report) >> 8) & 0xFF;
+ i += 4; // QMK doesn't send multiple consumer reports, just skip 2nd and 3rd consumer reports
+
+ lkbt51_send_cmd(payload, i, true, false);
+}
+
+void lkbt51_send_system(uint16_t report) {
+ uint8_t hid_usage = report & 0xFF;
+
+ if (hid_usage < 0x81 || hid_usage > 0x83) return;
+
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_SEND_SYSTEM;
+ payload[i++] = 0x01 << (hid_usage - 0x81);
+
+ lkbt51_send_cmd(payload, i, true, false);
+}
+
+void lkbt51_send_mouse(uint8_t* report) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_SEND_MOUSE; // Cmd type
+ payload[i++] = report[1]; // Button
+ payload[i++] = report[2]; // X
+ payload[i++] = (report[2] & 0x80) ? 0xff : 0x00; // ckbt51 use 16bit report, set high byte
+ payload[i++] = report[3]; // Y
+ payload[i++] = (report[3] & 0x80) ? 0xff : 0x00; // ckbt51 use 16bit report, set high byte
+ payload[i++] = report[4]; // V wheel
+ payload[i++] = report[5]; // H wheel
+
+ lkbt51_send_cmd(payload, i, false, false);
+}
+
+/* Send ack to connection event, wireless module will retry 2 times if no ack received */
+void lkbt51_send_conn_evt_ack(void) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CONNECTION_EVT_ACK;
+
+ lkbt51_send_cmd(payload, i, false, false);
+}
+
+void lkbt51_become_discoverable(uint8_t host_idx, void* param) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ pairing_param_t default_pairing_param = {0, 0, PAIRING_MODE_LESC_OR_SSP, BT_MODE_CLASSIC, 0, NULL};
+
+ if (param == NULL) {
+ param = &default_pairing_param;
+ }
+ pairing_param_t* p = (pairing_param_t*)param;
+
+ payload[i++] = LKBT51_CMD_PAIRING; // Cmd type
+ payload[i++] = host_idx; // Host Index
+ payload[i++] = p->timeout & 0xFF; // Timeout
+ payload[i++] = (p->timeout >> 8) & 0xFF;
+ payload[i++] = p->pairingMode;
+ payload[i++] = p->BRorLE; // BR/LE
+ payload[i++] = p->txPower; // LE TX POWER
+ if (p->leName) {
+ memcpy(&payload[i], p->leName, strlen(p->leName));
+ i += strlen(p->leName);
+ }
+
+ lkbt51_wake();
+ lkbt51_send_cmd(payload, i, true, false);
+}
+
+/* Timeout : 2 ~ 255 seconds */
+void lkbt51_connect(uint8_t hostIndex, uint16_t timeout) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_CONNECT;
+ payload[i++] = hostIndex; // Host index
+ payload[i++] = timeout & 0xFF; // Timeout
+ payload[i++] = (timeout >> 8) & 0xFF;
+
+ lkbt51_wake();
+ lkbt51_send_cmd(payload, i, true, false);
+}
+
+void lkbt51_disconnect(void) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_DISCONNECT;
+ payload[i++] = 0; // Sleep mode
+
+ if (WT_DRIVER.state != SPI_READY)
+ spiStart(&WT_DRIVER, &spicfg);
+ spiSelect(&WT_DRIVER);
+ wait_ms(30);
+ // spiUnselect(&SPID1);
+ wait_ms(70);
+
+ lkbt51_send_cmd(payload, i, true, false);
+}
+
+void lkbt51_switch_host(uint8_t hostIndex) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_SWITCH_HOST;
+ payload[i++] = hostIndex;
+
+ lkbt51_send_cmd(payload, i, true, false);
+}
+
+void lkbt51_read_state_reg(uint8_t reg, uint8_t len) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_READ_STATE_REG;
+ payload[i++] = reg_offset = reg;
+ payload[i++] = len;
+
+ // TODO
+ lkbt51_send_cmd(payload, i, false, false);
+}
+
+void lkbt51_update_bat_lvl(uint8_t bat_lvl) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_UPDATE_BAT_LVL;
+ payload[i++] = bat_lvl;
+ lkbt51_send_cmd(payload, i, false, false);
+}
+
+void lkbt51_update_bat_state(uint8_t bat_state) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_UPDATE_BAT_STATE;
+ payload[i++] = bat_state;
+ lkbt51_send_cmd(payload, i, false, false);
+}
+
+void lkbt51_get_info(module_info_t* info) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_GET_MODULE_INFO;
+ lkbt51_send_cmd(payload, i, false, false);
+}
+
+void lkbt51_set_param(module_param_t* param) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_SET_CONFIG;
+ memcpy(payload + i, param, sizeof(module_param_t));
+ i += sizeof(module_param_t);
+
+ lkbt51_send_cmd(payload, i, false, false);
+}
+
+void lkbt51_get_param(module_param_t* param) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_GET_CONFIG;
+
+ lkbt51_send_cmd(payload, i, false, false);
+}
+
+void lkbt51_set_local_name(const char* name) {
+ uint8_t i = 0;
+ uint8_t len = strlen(name);
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_SET_NAME;
+ memcpy(payload + i, name, len);
+ i += len;
+ lkbt51_send_cmd(payload, i, false, false);
+}
+
+void lkbt51_get_local_name(void) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_GET_NAME;
+
+ lkbt51_send_cmd(payload, i, false, false);
+}
+
+void lkbt51_factory_reset(uint8_t p2p4g_clr_msk) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+
+ payload[i++] = LKBT51_CMD_FACTORY_RESET;
+ payload[i++] = p2p4g_clr_msk;
+
+ lkbt51_wake();
+ lkbt51_send_cmd(payload, i, false, false);
+ factory_reset = timer_read32();
+}
+
+void lkbt51_int_pin_test(bool enable) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+ payload[i++] = LKBT51_CMD_IO_TEST;
+ payload[i++] = enable;
+
+ lkbt51_send_cmd(payload, i, false, false);
+}
+
+void lkbt51_radio_test(uint8_t channel) {
+ uint8_t i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+ payload[i++] = LKBT51_CMD_RADIO_TEST;
+ payload[i++] = channel;
+ payload[i++] = 0;
+
+ lkbt51_send_cmd(payload, i, false, false);
+}
+
+bool lkbt51_read_customize_data(uint8_t* data, uint8_t len) {
+ uint8_t i;
+ uint8_t buf[20] = {0};
+
+ i = 0;
+ buf[i++] = 0x84;
+ buf[i++] = 0x7a;
+ buf[i++] = 0x00;
+ buf[i++] = 0x80;
+
+#if HAL_USE_SPI
+ spiStart(&WT_DRIVER, &spicfg);
+ spiSelect(&WT_DRIVER);
+ spiExchange(&WT_DRIVER, 20, buf, payload);
+ uint16_t state = buf[5] | (buf[6] << 8);
+ if (state == 0x9527) spiExchange(&WT_DRIVER, len, data, payload);
+ spiUnselect(&WT_DRIVER);
+ spiStop(&WT_DRIVER);
+#endif
+
+ return true;
+}
+
+void lkbt51_write_customize_data(uint8_t* data, uint8_t len) {
+ uint8_t i;
+ uint8_t pkt[PACKET_MAX_LEN] = {0};
+
+ i = 0;
+ pkt[i++] = 0x84;
+ pkt[i++] = 0x7a;
+ pkt[i++] = 0x00;
+ pkt[i++] = 0x00;
+
+#if HAL_USE_SPI
+ spiStart(&WT_DRIVER, &spicfg);
+ spiSelect(&WT_DRIVER);
+ spiSend(&WT_DRIVER, i, pkt);
+ spiSend(&WT_DRIVER, len, data);
+ spiUnselectI(&WT_DRIVER);
+ spiStop(&WT_DRIVER);
+#endif
+
+ i = 0;
+ memset(payload, 0, PACKET_MAX_LEN);
+ payload[i++] = LKBT51_CMD_WRTE_CSTM_DATA;
+
+ lkbt51_send_cmd(payload, i, false, false);
+}
+#ifdef RAW_ENABLE
+void lkbt51_dfu_tx(uint8_t rsp, uint8_t* data, uint8_t len, uint8_t sn) {
+ uint16_t checksum = 0;
+ uint8_t buf[RAW_EPSIZE] = {0};
+ uint8_t i = 0;
+
+ buf[i++] = 0x03;
+ buf[i++] = 0xAA;
+ buf[i++] = 0x57;
+ buf[i++] = len;
+ buf[i++] = ~len;
+ buf[i++] = sn;
+ buf[i++] = rsp;
+ memcpy(&buf[i], data, len);
+ i += len;
+
+ for (uint8_t k = 0; k < i; k++)
+ checksum += buf[i];
+
+ raw_hid_send(buf, RAW_EPSIZE);
+
+ if (len > 25) {
+ i = 0;
+ memset(buf, 0, RAW_EPSIZE);
+ buf[i++] = 0x03;
+ memcpy(&buf[i], data + 25, len - 25);
+ i = i + len - 25;
+ raw_hid_send(buf, RAW_EPSIZE);
+ }
+}
+#endif
+void lkbt51_dfu_rx(uint8_t* data, uint8_t length) {
+ if (data[0] == 0xAA && (data[1] == 0x55 || data[1] == 0x56) && data[2] == (~data[3] & 0xFF)) {
+ uint16_t checksum = 0;
+ uint8_t payload_len = data[2];
+
+ /* Check payload_len validity */
+ if (payload_len > RAW_EPSIZE - PACKECT_HEADER_LEN) return;
+
+ uint8_t* payload = &data[PACKECT_HEADER_LEN];
+
+ for (uint8_t i = 0; i < payload_len - 2; i++) {
+ checksum += payload[i];
+ }
+
+ /* Verify checksum */
+ if ((checksum & 0xFF) != payload[payload_len - 2] || checksum >> 8 != payload[payload_len - 1]) return;
+ static uint8_t sn = 0;
+
+ bool retry = true;
+ if (sn != data[4]) {
+ sn = data[4];
+ retry = false;
+ }
+
+ if ((payload[0] & 0xF0) == 0x60) {
+ lkbt51_wake();
+ lkbt51_send_cmd(payload, payload_len - 2, data[1] == 0x56, retry);
+ }
+ }
+}
+
+static void ack_handler(uint8_t* data, uint8_t len) {
+ switch (data[1]) {
+ case LKBT51_CMD_SEND_KB:
+ case LKBT51_CMD_SEND_KB_NKRO:
+ case LKBT51_CMD_SEND_CONSUMER:
+ case LKBT51_CMD_SEND_SYSTEM:
+ case LKBT51_CMD_SEND_MOUSE:
+ switch (data[2]) {
+ case ACK_SUCCESS:
+ report_buffer_set_retry(0);
+ report_buffer_set_inverval(connection_interval);
+ break;
+ case ACK_FIFO_HALF_WARNING:
+ report_buffer_set_retry(0);
+ report_buffer_set_inverval(connection_interval + 5);
+ break;
+ case ACK_FIFO_FULL_ERROR:
+ report_buffer_set_inverval(connection_interval + 10);
+ break;
+ }
+ break;
+ default:
+ break;
+ }
+}
+
+static void query_rsp_handler(uint8_t* data, uint8_t len) {
+ if (data[2]) return;
+
+ switch (data[1]) {
+ case LKBT51_CMD_IO_TEST:
+ factory_test_send(data, len);
+ break;
+ default:
+ break;
+ }
+}
+
+static void lkbt51_event_handler(uint8_t evt_type, uint8_t* data, uint8_t len, uint8_t sn) {
+ wireless_event_t event = {0};
+
+ switch (evt_type) {
+ case LKBT51_EVT_ACK:
+ ack_handler(data, len);
+ break;
+ case LKBT51_EVT_RESET:
+ kc_printf("LKBT51_EVT_RESET\n");
+ event.evt_type = EVT_RESET;
+ event.params.reason = data[0];
+ break;
+ case LKBT51_EVT_LE_CONNECTION:
+ kc_printf("LKBT51_EVT_LE_CONNECTION\n");
+ break;
+ case LKBT51_EVT_HOST_TYPE:
+ kc_printf("LKBT51_EVT_HOST_TYPE\n");
+ break;
+ case LKBT51_EVT_HID_EVENT:
+ kc_printf("LKBT51_EVT_HID_EVENT\n");
+ event.evt_type = EVT_HID_INDICATOR;
+ event.params.led = data[0];
+ break;
+ case LKBT51_EVT_QUERY_RSP:
+ kc_printf("LKBT51_EVT_QUERY_RSP\n\r");
+ query_rsp_handler(data, len);
+ break;
+ case LKBT51_EVT_OTA_RSP:
+#ifdef RAW_ENABLE
+ kc_printf("LKBT51_EVT_OTA_RSP\n");
+ lkbt51_dfu_tx(LKBT51_EVT_OTA_RSP, data, len, sn);
+#endif
+ break;
+ default:
+ kc_printf("Unknown event!!!\n");
+ break;
+ }
+
+ if (event.evt_type) wireless_event_enqueue(event);
+}
+
+void lkbt51_task(void) {
+#define VALID_DATA_START_INDEX 4
+#define BUFFER_SIZE 64
+
+ static bool wait_for_new_pkt = true;
+ static uint8_t len = 0xff;
+ static uint8_t sn = 0;
+
+ if (gpio_read_pin(LKBT51_INT_INPUT_PIN) == 0) {
+ uint8_t buf[BUFFER_SIZE] = {0};
+ lkbt51_read(buf, expect_len);
+
+ uint8_t* pbuf = buf + VALID_DATA_START_INDEX;
+
+ if (pbuf[0] == 0xAA && pbuf[1] == 0x54 && pbuf[4] == (uint8_t)(~0x54) && pbuf[5] == (uint8_t)(~0xAA)) {
+ uint16_t protol_ver = pbuf[3] << 8 | pbuf[2];
+ kc_printf("protol_ver: %x\n\r", protol_ver);
+ (void)protol_ver;
+ } else if (pbuf[0] == 0xAA) {
+ wireless_event_t event = {0};
+ uint8_t evt_mask = pbuf[1];
+
+ if (evt_mask & LK_EVT_MSK_RESET) {
+ event.evt_type = EVT_RESET;
+ event.params.reason = pbuf[2];
+ wireless_event_enqueue(event);
+ }
+
+ if (evt_mask & LK_EVT_MSK_CONNECTION) {
+ lkbt51_send_conn_evt_ack();
+ switch (pbuf[2]) {
+ case LKBT51_CONNECTED:
+ event.evt_type = EVT_CONNECTED;
+ break;
+ case LKBT51_DISCOVERABLE:
+ event.evt_type = EVT_DISCOVERABLE;
+ break;
+ case LKBT51_RECONNECTING:
+ event.evt_type = EVT_RECONNECTING;
+ break;
+ case LKBT51_DISCONNECTED:
+ event.evt_type = EVT_DISCONNECTED;
+ if (factory_reset && timer_elapsed32(factory_reset) < 3000) {
+ factory_reset = 0;
+ event.data = 1;
+ }
+ break;
+ case LKBT51_PINCODE_ENTRY:
+ event.evt_type = EVT_BT_PINCODE_ENTRY;
+ break;
+ case LKBT51_EXIT_PINCODE_ENTRY:
+ event.evt_type = EVT_EXIT_BT_PINCODE_ENTRY;
+ break;
+ case LKBT51_SLEEP:
+ event.evt_type = EVT_SLEEP;
+ break;
+ }
+ event.params.hostIndex = pbuf[3];
+
+ wireless_event_enqueue(event);
+ }
+
+ if (evt_mask & LK_EVT_MSK_LED) {
+ memset(&event, 0, sizeof(event));
+ event.evt_type = EVT_HID_INDICATOR;
+ event.params.led = pbuf[4];
+ wireless_event_enqueue(event);
+ }
+
+ if (evt_mask & LK_EVT_MSK_RPT_INTERVAL) {
+ uint32_t interval;
+ if (pbuf[8] & 0x80) {
+ interval = (pbuf[8] & 0x7F) * 1250;
+ } else {
+ interval = (pbuf[8] & 0x7F) * 125;
+ }
+
+ connection_interval = interval / 1000;
+ if (connection_interval > 7) connection_interval /= 3;
+
+ memset(&event, 0, sizeof(event));
+ event.evt_type = EVT_CONECTION_INTERVAL;
+ event.params.interval = connection_interval;
+ wireless_event_enqueue(event);
+ }
+
+ if (evt_mask & LK_EVT_MSK_BATT) {
+ battery_calculate_voltage(true, pbuf[6] << 8 | pbuf[5]);
+ }
+ }
+
+ pbuf = buf;
+ if (wait_for_new_pkt) {
+ for (uint8_t i = 10; i < BUFFER_SIZE - 5; i++) {
+ if (buf[i] == 0xAA && buf[i + 1] == 0x57 // Packet Head
+ && (~buf[i + 2] & 0xFF) == buf[i + 3]) { // Check wheather len is valid
+ len = buf[i + 2];
+ sn = buf[i + 4];
+ pbuf = &buf[i + 5];
+ wait_for_new_pkt = false;
+ }
+ }
+ }
+
+ if (!wait_for_new_pkt && BUFFER_SIZE - 5 >= len) {
+ wait_for_new_pkt = true;
+
+ uint16_t checksum = 0;
+ for (int i = 0; i < len - 2; i++) {
+ checksum += pbuf[i];
+ }
+
+ if ((checksum & 0xff) == pbuf[len - 2] && ((checksum >> 8) & 0xff) == pbuf[len - 1]) {
+ lkbt51_event_handler(pbuf[0], pbuf + 1, len - 3, sn);
+ } else {
+ // TODO: Error handle
+ }
+ }
+ }
+}
diff --git a/keyboards/keychron/common/wireless/lkbt51.h b/keyboards/keychron/common/wireless/lkbt51.h
new file mode 100644
index 0000000000..c07e680e5a
--- /dev/null
+++ b/keyboards/keychron/common/wireless/lkbt51.h
@@ -0,0 +1,136 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include "stdint.h"
+#include "hal.h"
+#include "config.h"
+
+// Error checking
+#if HAL_USE_SPI == FALSE
+# error "Please enable SPI to use LKBT51"
+#endif
+
+#if defined(WB32F3G71xx)
+# ifndef WT_DRIVER
+# define WT_DRIVER SPIDQ
+# endif
+#endif
+
+#if defined(MCU_STM32)
+# ifndef WT_DRIVER
+# define WT_DRIVER SPID1
+# endif
+#endif
+
+#define PACKECT_HEADER_LEN 5
+#define BDA_LEN 6
+#define PACKET_MAX_LEN 64
+#define P24G_INDEX 24
+
+enum {
+ PAIRING_MODE_DEFAULT = 0x00,
+ PAIRING_MODE_JUST_WORK,
+ PAIRING_MODE_PASSKEY_ENTRY,
+ PAIRING_MODE_LESC_OR_SSP,
+ PAIRING_MODE_INVALID,
+};
+
+enum {
+ BT_MODE_DEFAUL,
+ BT_MODE_CLASSIC,
+ BT_MODE_LE,
+ BT_MODE_INVALID,
+};
+
+typedef struct {
+ uint8_t hostIndex;
+ uint16_t timeout; /* Pairing timeout, valid value range from 30 to 3600 seconds, 0 for default */
+ uint8_t pairingMode; /* 0: default, 1: Just Works, 2: Passkey Entry */
+ uint8_t BRorLE; /* Only available for dual mode module. Keep 0 for single mode module */
+ uint8_t txPower; /* Only available for BLE module */
+ const char* leName; /* Only available for BLE module */
+} pairing_param_t;
+
+typedef struct {
+ uint8_t type;
+ uint16_t full_votage;
+ uint16_t empty_voltage;
+ uint16_t shutdown_voltage;
+} battery_param_t;
+
+typedef struct {
+ uint8_t model_name[11];
+ uint8_t mode;
+ uint8_t bluetooth_version;
+ uint8_t firmware_version[11];
+ uint8_t hardware_version[11];
+ uint16_t cmd_set_verson;
+} __attribute__((packed)) module_info_t;
+
+typedef struct {
+ uint8_t event_mode; /* Must be 0x02 */
+ uint16_t connected_idle_timeout;
+ uint16_t pairing_timeout; /* Range: 30 ~ 3600 second, 0 for default */
+ uint8_t pairing_mode; /* 0: default, 1: Just Works, 2: Passkey Entry */
+ uint16_t reconnect_timeout; /* 0: default, 0xFF: Unlimited time, 2 ~ 254 seconds */
+ uint8_t report_rate; /* 90 or 133 */
+ uint8_t rsvd1;
+ uint8_t rsvd2;
+ uint8_t vendor_id_source; /* 0: From Bluetooth SIG, 1: From USB-IF */
+ uint16_t verndor_id; /* No effect, the vendor ID is 0x3434 */
+ uint16_t product_id;
+ /* Below parametes is only available for BLE module */
+ uint16_t le_connection_interval_min;
+ uint16_t le_connection_interval_max;
+ uint16_t le_connection_interval_timeout;
+} __attribute__((packed)) module_param_t;
+
+void lkbt51_init(bool wakeup_from_low_power_mode);
+void lkbt51_send_protocol_ver(uint16_t ver);
+
+void lkbt51_send_cmd(uint8_t* payload, uint8_t len, bool ack_enable, bool retry);
+
+void lkbt51_send_keyboard(uint8_t* report);
+void lkbt51_send_nkro(uint8_t* report);
+void lkbt51_send_consumer(uint16_t report);
+void lkbt51_send_system(uint16_t report);
+void lkbt51_send_mouse(uint8_t* report);
+
+void lkbt51_become_discoverable(uint8_t host_idx, void* param);
+void lkbt51_connect(uint8_t hostIndex, uint16_t timeout);
+void lkbt51_disconnect(void);
+void lkbt51_switch_host(uint8_t hostIndex);
+void lkbt51_read_state_reg(uint8_t reg, uint8_t len);
+
+void lkbt51_update_bat_lvl(uint8_t bat_lvl);
+void lkbt51_update_bat_state(uint8_t bat_state);
+
+void lkbt51_get_info(module_info_t* info);
+void lkbt51_set_param(module_param_t* param);
+void lkbt51_get_param(module_param_t* param);
+void lkbt51_set_local_name(const char* name);
+void lkbt51_get_local_name(void);
+
+void lkbt51_factory_reset(uint8_t p2p4g_clr_msk);
+void lkbt51_int_pin_test(bool enable);
+void lkbt51_dfu_rx(uint8_t* data, uint8_t length);
+void lkbt51_radio_test(uint8_t channel);
+void lkbt51_write_customize_data(uint8_t* data, uint8_t len);
+bool lkbt51_read_customize_data(uint8_t* data, uint8_t len);
+
+void lkbt51_task(void);
diff --git a/keyboards/keychron/common/wireless/lpm.c b/keyboards/keychron/common/wireless/lpm.c
new file mode 100644
index 0000000000..fc131fa668
--- /dev/null
+++ b/keyboards/keychron/common/wireless/lpm.c
@@ -0,0 +1,315 @@
+/*/* Copyright 2022 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+/******************************************************************************
+ *
+ * Filename: lpm.c
+ *
+ * Description: Contains low power mode implementation
+ *
+ ******************************************************************************/
+
+#include "quantum.h"
+#if defined(PROTOCOL_CHIBIOS)
+# include
+#endif
+#include "debounce.h"
+#include "wireless.h"
+#include "indicator.h"
+#include "lpm.h"
+#include "transport.h"
+#include "battery.h"
+#include "report_buffer.h"
+#include "keychron_common.h"
+
+extern matrix_row_t matrix[MATRIX_ROWS];
+extern wt_func_t wireless_transport;
+
+static uint32_t lpm_timer_buffer;
+static bool lpm_time_up = false;
+#ifndef OPTICAL_SWITCH
+static matrix_row_t empty_matrix[MATRIX_ROWS] = {0};
+#endif
+
+pin_t pins_row[MATRIX_ROWS] = MATRIX_ROW_PINS;
+pin_t pins_col[MATRIX_COLS] = MATRIX_COL_PINS;
+;
+
+__attribute__((weak)) void select_all_cols(void) {
+ for (uint8_t i = 0; i < MATRIX_COLS; i++) {
+ if (pins_col[i] == NO_PIN) continue;
+
+ gpio_set_pin_output_push_pull(pins_col[i]);
+ gpio_write_pin_low(pins_col[i]);
+ }
+}
+
+void lpm_init(void) {
+#ifdef USB_POWER_SENSE_PIN
+# if (USB_POWER_CONNECTED_LEVEL == 0)
+ gpio_set_pin_input_high(USB_POWER_SENSE_PIN);
+# else
+ setPinInputLow(USB_POWER_SENSE_PIN);
+# endif
+#endif
+ lpm_timer_reset();
+}
+
+inline void lpm_timer_reset(void) {
+ lpm_time_up = false;
+ lpm_timer_buffer = timer_read32();
+}
+
+void lpm_timer_stop(void) {
+ lpm_time_up = false;
+ lpm_timer_buffer = 0;
+}
+
+static inline bool lpm_any_matrix_action(void) {
+ return memcmp(matrix, empty_matrix, sizeof(empty_matrix));
+}
+
+__attribute__((weak)) void matrix_enter_low_power(void) {
+ /* Enable key matrix wake up */
+ for (uint8_t x = 0; x < MATRIX_ROWS; x++) {
+ if (pins_row[x] != NO_PIN) {
+ palEnableLineEvent(pins_row[x], PAL_EVENT_MODE_BOTH_EDGES);
+ }
+ }
+
+ select_all_cols();
+}
+
+__attribute__((weak)) void matrix_exit_low_power(void) {
+ /* Disable all wake up pins */
+ for (uint8_t x = 0; x < MATRIX_ROWS; x++) {
+ if (pins_row[x] != NO_PIN) {
+ palDisableLineEvent(pins_row[x]);
+ }
+ }
+}
+
+static void lpm_turn_off_backlight_and_led(void) {
+ #ifdef RGB_MATRIX_ENABLE
+ rgb_matrix_set_color_all(0, 0, 0);
+ rgb_matrix_driver.flush();
+ rgb_matrix_driver_shutdown();
+#endif
+#ifdef LED_MATRIX_ENABLE
+ led_matrix_set_value_all(0);
+ led_matrix_driver.flush();
+ led_matrix_driver_shutdown();
+#endif
+#ifdef LED_NUM_LOCK_PIN
+ gpio_write_pin(LED_NUM_LOCK_PIN, !LED_PIN_ON_STATE);
+#endif
+#ifdef LED_CAPS_LOCK_PIN
+ gpio_write_pin(LED_CAPS_LOCK_PIN, !LED_PIN_ON_STATE);
+#endif
+#ifdef BAT_LOW_LED_PIN
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+#ifdef BT_INDICATION_LED_PIN_LIST
+ pin_t bt_led_pins[] = BT_INDICATION_LED_PIN_LIST;
+ for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(bt_led_pins[i], !BT_INDICATION_LED_ON_STATE);
+#endif
+}
+
+/* Implement of entering low power mode and wakeup varies per mcu or platform */
+
+__attribute__((weak)) void lpm_pre_enter_low_power(void) {}
+
+__attribute__((weak)) void lpm_enter_low_power_kb(void) {}
+
+__attribute__((weak)) void lpm_enter_low_power(void) {
+ if (get_transport() == TRANSPORT_USB && !usb_power_connected()) {
+ lpm_turn_off_backlight_and_led();
+ }
+
+ /* Usb unit is actived and running, stop and disconnect first */
+ usbStop(&USBD1);
+ usbDisconnectBus(&USBD1);
+
+ /* Isolate USB to save power.*/
+ // PWR->CR2 &= ~PWR_CR2_USV; /*PWR_CR2_USV is available on STM32L4x2xx and STM32L4x3xx devices only. */
+
+#if (HAL_USE_SPI == TRUE)
+ spiStop(&SPI_DRIVER);
+ palSetLineMode(SPI_SCK_PIN, PAL_MODE_INPUT_PULLDOWN);
+#ifdef SPI_MOSI_PIN
+ palSetLineMode(SPI_MOSI_PIN, PAL_MODE_INPUT_PULLDOWN);
+#endif
+#ifdef SPI_MISO_PIN
+ palSetLineMode(SPI_MISO_PIN, PAL_MODE_INPUT_PULLDOWN);
+#endif
+#endif
+
+ palEnableLineEvent(LKBT51_INT_INPUT_PIN, PAL_EVENT_MODE_FALLING_EDGE);
+#ifdef USB_POWER_SENSE_PIN
+ palEnableLineEvent(USB_POWER_SENSE_PIN, PAL_EVENT_MODE_BOTH_EDGES);
+#endif
+#ifdef P24G_MODE_SELECT_PIN
+ palEnableLineEvent(P24G_MODE_SELECT_PIN, PAL_EVENT_MODE_BOTH_EDGES);
+#endif
+#ifdef BT_MODE_SELECT_PIN
+ palEnableLineEvent(BT_MODE_SELECT_PIN, PAL_EVENT_MODE_BOTH_EDGES);
+#endif
+ matrix_enter_low_power();
+
+#if defined(DIP_SWITCH_PINS)
+# define NUMBER_OF_DIP_SWITCHES (sizeof(dip_switch_pad) / sizeof(pin_t))
+ static pin_t dip_switch_pad[] = DIP_SWITCH_PINS;
+
+ for (uint8_t i = 0; i < NUMBER_OF_DIP_SWITCHES; i++) {
+ setPinInputLow(dip_switch_pad[i]);
+ }
+#endif
+ battery_stop();
+ lpm_enter_low_power_kb();
+}
+
+__attribute__((weak)) void lpm_post_enter_low_power(void) {}
+
+__attribute__((weak)) void lpm_standby(pm_t mode) {}
+
+__attribute__((weak)) void lpm_early_wakeup(void) {
+ gpio_write_pin_low(LKBT51_INT_OUTPUT_PIN);
+}
+
+__attribute__((weak)) void lpm_wakeup_init(void) {}
+
+__attribute__((weak)) void lpm_pre_wakeup(void) {
+ gpio_write_pin_high(LKBT51_INT_OUTPUT_PIN);
+}
+
+__attribute__((weak)) void lpm_wakeup(void) {
+ matrix_exit_low_power();
+
+ halInit();
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ if (wireless_transport.init) wireless_transport.init(true);
+ battery_init();
+
+ palDisableLineEvent(LKBT51_INT_INPUT_PIN);
+#ifdef P24G_MODE_SELECT_PIN
+ palDisableLineEvent(P24G_MODE_SELECT_PIN);
+#endif
+#ifdef BT_MODE_SELECT_PIN
+ palDisableLineEvent(BT_MODE_SELECT_PIN);
+#endif
+#ifdef USB_POWER_SENSE_PIN
+ palDisableLineEvent(USB_POWER_SENSE_PIN);
+
+# if defined(KEEP_USB_CONNECTION_IN_WIRELESS_MODE)
+ if (usb_power_connected()
+# ifndef BT_MODE_SELECT_PIN
+ && (get_transport() == TRANSPORT_USB)
+# endif
+ ) {
+ usb_event_queue_init();
+ init_usb_driver(&USB_DRIVER);
+ }
+# endif
+
+#endif
+
+#if defined(DIP_SWITCH_PINS)
+ dip_switch_init();
+ dip_switch_read(true);
+#endif
+
+ /* Call debounce_free() to avoiding memory leak of debounce_counters as debounce_init()
+ invoked in matrix_init() alloc new memory to debounce_counters */
+ debounce_free();
+ matrix_init();
+}
+
+__attribute__((weak)) void lpm_post_wakeup(void) {}
+
+__attribute__((weak)) bool usb_power_connected(void) {
+#ifdef USB_POWER_SENSE_PIN
+ return gpio_read_pin(USB_POWER_SENSE_PIN) == USB_POWER_CONNECTED_LEVEL;
+#else
+ return true;
+#endif
+}
+
+__attribute__((weak)) bool lpm_is_kb_idle(void) {
+ return true;
+}
+
+__attribute__((weak)) bool lpm_set(pm_t mode) {
+ return false;
+}
+
+bool allow_low_power_mode(pm_t mode) {
+ /* Don't enter low power mode if attached to the host */
+ if (mode > PM_SLEEP && usb_power_connected()) return false;
+
+ if (!lpm_set(mode)) return false;
+
+ return true;
+}
+
+void lpm_task(void) {
+
+ if (!lpm_time_up && sync_timer_elapsed32(lpm_timer_buffer) > RUN_MODE_PROCESS_TIME) {
+ lpm_time_up = true;
+ lpm_timer_buffer = 0;
+ }
+
+ if (usb_power_connected() && USBD1.state == USB_STOP) {
+ usb_event_queue_init();
+ init_usb_driver(&USB_DRIVER);
+ }
+
+ if ((get_transport() & TRANSPORT_WIRELESS) && lpm_time_up && !indicator_is_running() && lpm_is_kb_idle()) {
+ if (
+#ifdef LED_MATRIX_ENABLE
+ (!led_matrix_is_enabled() ||
+ (led_matrix_is_enabled() && led_matrix_is_driver_shutdown()))
+#elif defined(RGB_MATRIX_ENABLE)
+ (!rgb_matrix_is_enabled() ||
+ (rgb_matrix_is_enabled() && rgb_matrix_is_driver_shutdown()))
+#else
+ !bat_level_animiation_actived()
+#endif
+ && !lpm_any_matrix_action()) {
+
+ if (allow_low_power_mode(LOW_POWER_MODE)) {
+ lpm_pre_enter_low_power();
+ lpm_enter_low_power();
+ lpm_post_enter_low_power();
+
+ lpm_standby(LOW_POWER_MODE);
+ lpm_early_wakeup();
+ lpm_wakeup_init();
+ lpm_pre_wakeup();
+ lpm_wakeup();
+ lpm_post_wakeup();
+
+ lpm_timer_reset();
+ report_buffer_init();
+ lpm_set(PM_RUN);
+ }
+ }
+ }
+}
diff --git a/keyboards/keychron/common/wireless/lpm.h b/keyboards/keychron/common/wireless/lpm.h
new file mode 100644
index 0000000000..c436e27604
--- /dev/null
+++ b/keyboards/keychron/common/wireless/lpm.h
@@ -0,0 +1,49 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifndef RUN_MODE_PROCESS_TIME
+# define RUN_MODE_PROCESS_TIME 1000
+#endif
+
+typedef enum {
+ PM_RUN,
+ PM_SLEEP,
+ PM_STOP,
+ PM_STANDBY,
+} pm_t;
+
+void lpm_init(void);
+void lpm_timer_reset(void);
+void lpm_timer_stop(void);
+void select_all_cols(void);
+void matrix_enter_low_power(void);
+void matrix_exit_low_power(void);
+void lpm_pre_enter_low_power(void);
+void lpm_enter_low_power(void);
+void lpm_enter_low_power_kb(void);
+void lpm_post_enter_low_power(void) ;
+void lpm_standby(pm_t mode);
+void lpm_early_wakeup(void);
+void lpm_wakeup_init(void);
+void lpm_pre_wakeup(void);
+void lpm_wakeup(void);
+void lpm_post_wakeup(void);
+bool usb_power_connected(void);
+bool lpm_is_kb_idle(void);
+bool lpm_set(pm_t mode);
+void lpm_task(void);
diff --git a/keyboards/keychron/common/wireless/lpm_stm32f401.c b/keyboards/keychron/common/wireless/lpm_stm32f401.c
new file mode 100644
index 0000000000..6031a81cd0
--- /dev/null
+++ b/keyboards/keychron/common/wireless/lpm_stm32f401.c
@@ -0,0 +1,142 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+/******************************************************************************
+ *
+ * Filename: lpm_stm32f401.c
+ *
+ * Description: Contains low power mode implementation
+ *
+ ******************************************************************************/
+
+#include "quantum.h"
+#include
+#include "wireless.h"
+#include "lpm.h"
+#include "lpm_stm32f401.h"
+#include "config.h"
+#include "hal.h"
+
+static pm_t power_mode = PM_RUN;
+
+void lpm_post_enter_low_power(void) {
+ /* USB D+/D- */
+ palSetLineMode(A12, PAL_MODE_INPUT_PULLDOWN);
+ palSetLineMode(A11, PAL_MODE_INPUT_PULLDOWN);
+}
+
+void lpm_pre_wakeup(void) {
+ /* USB D+/D- */
+#if (HAL_USE_USB == TRUE)
+ palSetLineMode(A11, PAL_STM32_OTYPE_PUSHPULL | PAL_STM32_OSPEED_HIGHEST | PAL_STM32_PUPDR_FLOATING | PAL_MODE_ALTERNATE(10U));
+ palSetLineMode(A12, PAL_STM32_OTYPE_PUSHPULL | PAL_STM32_OSPEED_HIGHEST | PAL_STM32_PUPDR_FLOATING | PAL_MODE_ALTERNATE(10U));
+#endif
+
+ /* SPI */
+#if (HAL_USE_SPI == TRUE)
+ palSetLineMode(SPI_SCK_PIN, PAL_MODE_ALTERNATE(5));
+ if (SPI_MOSI_PIN != NO_PIN) {
+ palSetLineMode(SPI_MOSI_PIN, PAL_MODE_ALTERNATE(5));
+ }
+ if (SPI_MISO_PIN != NO_PIN) {
+ palSetLineMode(SPI_MISO_PIN, PAL_MODE_ALTERNATE(5));
+ }
+#endif
+}
+
+bool lpm_set(pm_t mode) {
+ bool ret = true;
+
+ switch (mode) {
+ case PM_SLEEP:
+ /* Wake source: Any interrupt or event */
+ if (power_mode != PM_RUN)
+ ret = false;
+ else
+ SCB->SCR &= ~SCB_SCR_SLEEPDEEP_Msk;
+ break;
+
+ case PM_STOP:
+ /* Wake source: Reset pin, all I/Os, BOR, PVD, PVM, RTC, LCD, IWDG,
+ COMPx, USARTx, LPUART1, I2Cx, LPTIMx, USB, SWPMI */
+ if (power_mode != PM_RUN)
+ ret = false;
+ else {
+ SCB->SCR |= SCB_SCR_SLEEPDEEP_Msk;
+ PWR->CR |=
+#if STOP_MODE_MAIN_REGULATOR_LOW_VOLTAGE
+ PWR_CR_MRLVDS |
+#endif
+#if STOP_MODE_LOW_POWER_REGULATOR_LOW_VOLTAG
+ PWR_CR_LPLVDS |
+#endif
+#if STOP_MODE_FLASH_POWER_DOWN
+ PWR_CR_FPDS |
+#endif
+#if STOP_MODE_LOW_POWER_DEEPSLEEP
+ PWR_CR_LPDS |
+#endif
+ 0;
+ }
+ break;
+
+ case PM_STANDBY:
+ if (power_mode != PM_RUN)
+ ret = false;
+ else {
+ SCB->SCR |= SCB_SCR_SLEEPDEEP_Msk;
+ }
+ break;
+
+ default:
+ break;
+ }
+ power_mode = mode;
+
+ return ret;
+}
+
+void lpm_standby(pm_t mode) {
+#if STM32_HSE_ENABLED
+ /* Switch to HSI */
+ RCC->CFGR = (RCC->CFGR & (~STM32_SW_MASK)) | STM32_SW_HSI;
+ while ((RCC->CFGR & RCC_CFGR_SWS) != (STM32_SW_HSI << 2))
+ ;
+
+ /* Set HSE off */
+ RCC->CR &= ~RCC_CR_HSEON;
+ while ((RCC->CR & RCC_CR_HSERDY))
+ ;
+
+ /* To avoid power consumption of floating GPIO */
+ palSetLineMode(H0, PAL_MODE_INPUT_PULLDOWN);
+ palSetLineMode(H1, PAL_MODE_INPUT_PULLDOWN);
+#endif
+
+ __WFI();
+
+ SCB->SCR &= ~SCB_SCR_SLEEPDEEP_Msk;
+}
+
+void lpm_wakeup_init(void) {
+ gpio_write_pin_low(LKBT51_INT_OUTPUT_PIN);
+ stm32_clock_init();
+ gpio_write_pin_high(LKBT51_INT_OUTPUT_PIN);
+}
+
+void usb_power_connect(void) {}
+
+void usb_power_disconnect(void) {}
diff --git a/keyboards/keychron/common/wireless/lpm_stm32f401.h b/keyboards/keychron/common/wireless/lpm_stm32f401.h
new file mode 100644
index 0000000000..f9918365b0
--- /dev/null
+++ b/keyboards/keychron/common/wireless/lpm_stm32f401.h
@@ -0,0 +1,33 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifndef STOP_MODE_MAIN_REGULATOR_LOW_VOLTAGE
+# define STOP_MODE_MAIN_REGULATOR_LOW_VOLTAGE TRUE
+#endif
+
+#ifndef STOP_MODE_LOW_POWER_REGULATOR_LOW_VOLTAG
+# define STOP_MODE_LOW_POWER_REGULATOR_LOW_VOLTAG TRUE
+#endif
+
+#ifndef STOP_MODE_FLASH_POWER_DOWN
+# define STOP_MODE_FLASH_POWER_DOWN TRUE
+#endif
+
+#ifndef STOP_MODE_LOW_POWER_DEEPSLEEP
+# define STOP_MODE_LOW_POWER_DEEPSLEEP TRUE
+#endif
diff --git a/keyboards/keychron/common/wireless/lpm_wb32f3g71.c b/keyboards/keychron/common/wireless/lpm_wb32f3g71.c
new file mode 100644
index 0000000000..c8e5799622
--- /dev/null
+++ b/keyboards/keychron/common/wireless/lpm_wb32f3g71.c
@@ -0,0 +1,146 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "lpm.h"
+
+bool wakeup_from_lpm;
+
+// clang-format off
+static const uint32_t pre_lp_code[] = {
+ 553863175u, 554459777u, 1208378049u, 4026624001u, 688390415u,
+ 554227969u, 3204472833u, 1198571264u, 1073807360u, 1073808388u};
+#define PRE_LP() ((void (*)(void))((unsigned int)(pre_lp_code) | 0x01))()
+
+static const uint32_t post_lp_code[] = {
+ 553863177u, 554459777u, 1208509121u, 51443856u, 4026550535u,
+ 1745485839u, 3489677954u, 536895496u, 673389632u, 1198578684u,
+ 1073807360u, 536866816u, 1073808388u};
+#define POST_LP() ((void (*)(void))((unsigned int)(post_lp_code) | 0x01))()
+// clang-format on
+extern void __early_init(void);
+extern void matrix_init_pins(void);
+
+void stop_mode_entry(void);
+
+void lpm_post_enter_low_power(void) {
+#if (HAL_USE_USB == TRUE)
+ /* USB D+/D- */
+ palSetLineMode(A12, PAL_MODE_INPUT_PULLUP); // why PAL_MODE_INPUT_PULLUP
+ palSetLineMode(A11, PAL_MODE_INPUT_PULLDOWN);
+#endif
+
+ palSetLineMode(DP_PULLUP_CONTROL_PIN, PAL_MODE_INPUT_PULLDOWN);
+}
+
+void lpm_pre_wakeup(void) {
+#if (HAL_USE_USB == TRUE)
+ /* USB D+/D- */
+ palSetLineMode(A11, PAL_WB32_OTYPE_PUSHPULL | PAL_WB32_OSPEED_HIGH | PAL_WB32_PUPDR_FLOATING | PAL_MODE_ALTERNATE(10U));
+ palSetLineMode(A12, PAL_WB32_OTYPE_PUSHPULL | PAL_WB32_OSPEED_HIGH | PAL_WB32_PUPDR_FLOATING | PAL_MODE_ALTERNATE(10U));
+#endif
+
+ /* SPI */
+#if (HAL_USE_SPI == TRUE)
+ palSetLineMode(SPI_SCK_PIN, PAL_MODE_ALTERNATE(5));
+ if (SPI_MOSI_PIN != NO_PIN) {
+ palSetLineMode(SPI_MOSI_PIN, PAL_MODE_ALTERNATE(5));
+ }
+ if (SPI_MISO_PIN != NO_PIN) {
+ palSetLineMode(SPI_MISO_PIN, PAL_MODE_ALTERNATE(5));
+ }
+#endif
+}
+
+bool lpm_set(pm_t mode) {
+ bool ret = true;
+ static pm_t power_mode = PM_RUN;
+
+ switch (mode) {
+ case PM_SLEEP:
+ /* Wake source: Any interrupt or event */
+ if (power_mode != PM_RUN)
+ ret = false;
+ else
+ SCB->SCR &= ~SCB_SCR_SLEEPDEEP_Msk;
+ break;
+
+ case PM_STOP:
+ if (power_mode != PM_RUN) ret = false;
+ break;
+
+ case PM_STANDBY:
+ if (power_mode != PM_RUN)
+ ret = false;
+ else {
+ SCB->SCR |= SCB_SCR_SLEEPDEEP_Msk;
+ }
+ break;
+
+ default:
+ break;
+ }
+ power_mode = mode;
+
+ return ret;
+}
+
+void lpm_standby(pm_t mode) {
+ chSysDisable();
+ wb32_set_main_clock_to_mhsi();
+
+ rtclp_lld_init();
+ stop_mode_entry();
+ chSysEnable();
+}
+
+void lpm_wakeup_init(void) {
+ wakeup_from_lpm = true;
+ __early_init();
+ wakeup_from_lpm = false;
+}
+
+void stop_mode_entry(void) {
+ EXTI->PR = 0x7FFFF;
+ for (uint8_t i = 0; i < 8; i++) {
+ for (uint8_t j = 0; j < 32; j++) {
+ if (NVIC->ISPR[i] & (0x01UL < j)) {
+ NVIC->ICPR[i] = (0x01UL < j);
+ }
+ }
+ }
+ SCB->ICSR |= SCB_ICSR_PENDSTCLR_Msk; // Clear Systick IRQ Pending
+
+ /* Clear all bits except DBP and FCLKSD bit */
+ PWR->CR0 &= 0x09U;
+
+ /* STOP LP4 MODE S32KON */
+ PWR->CR0 |= 0x3B004U;
+ PWR->CFGR = 0x3B3;
+
+ PRE_LP();
+
+ /* Set SLEEPDEEP bit of Cortex System Control Register */
+ SCB->SCR |= SCB_SCR_SLEEPDEEP_Msk;
+
+ /* Request Wait For Interrupt */
+ __WFI();
+
+ POST_LP();
+
+ /* Clear SLEEPDEEP bit of Cortex System Control Register */
+ SCB->SCR &= (~SCB_SCR_SLEEPDEEP_Msk);
+}
diff --git a/keyboards/keychron/common/wireless/report_buffer.c b/keyboards/keychron/common/wireless/report_buffer.c
new file mode 100644
index 0000000000..dff6f6e6b1
--- /dev/null
+++ b/keyboards/keychron/common/wireless/report_buffer.c
@@ -0,0 +1,144 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "report_buffer.h"
+#include "wireless.h"
+#include "lpm.h"
+
+/* The report buffer is mainly used to fix key press lost issue of macro
+ * when wireless module fifo isn't large enough. The maximun macro
+ * string length is determined by this queue size, and should be
+ * REPORT_BUFFER_QUEUE_SIZE devided by 2 since each character is implemented
+ * by sending a key pressing then a key releasing report.
+ * Please note that it cosume sizeof(report_buffer_t) * REPORT_BUFFER_QUEUE_SIZE
+ * bytes RAM, with default setting, used RAM size is
+ * sizeof(report_buffer_t) * 256 = 34* 256 = 8704 bytes
+ */
+#ifndef REPORT_BUFFER_QUEUE_SIZE
+# define REPORT_BUFFER_QUEUE_SIZE 256
+#endif
+
+extern wt_func_t wireless_transport;
+
+/* report_interval value should be less than bluetooth connection interval because
+ * it takes some time for communicating between mcu and bluetooth module. Carefully
+ * set this value to feed the bt module so that we don't lost the key report nor lost
+ * the anchor point of bluetooth interval. The bluetooth connection interval varies
+ * if BLE is used, invoke report_buffer_set_inverval() to update the value
+ */
+uint8_t report_interval = DEFAULT_2P4G_REPORT_INVERVAL_MS;
+
+static uint32_t report_timer_buffer = 0;
+uint32_t retry_time_buffer = 0;
+report_buffer_t report_buffer_queue[REPORT_BUFFER_QUEUE_SIZE];
+uint16_t report_buffer_queue_head;
+uint16_t report_buffer_queue_tail;
+report_buffer_t kb_rpt;
+uint8_t retry = 0;
+
+void report_buffer_task(void);
+
+void report_buffer_init(void) {
+ // Initialise the report queue
+ memset(&report_buffer_queue, 0, sizeof(report_buffer_queue));
+ report_buffer_queue_head = 0;
+ report_buffer_queue_tail = 0;
+ retry = 0;
+ report_timer_buffer = timer_read32();
+}
+
+bool report_buffer_enqueue(report_buffer_t *report) {
+ uint16_t next = (report_buffer_queue_head + 1) % REPORT_BUFFER_QUEUE_SIZE;
+ if (next == report_buffer_queue_tail) {
+ return false;
+ }
+
+ report_buffer_queue[report_buffer_queue_head] = *report;
+ report_buffer_queue_head = next;
+ return true;
+}
+
+inline bool report_buffer_dequeue(report_buffer_t *report) {
+ if (report_buffer_queue_head == report_buffer_queue_tail) {
+ return false;
+ }
+
+ *report = report_buffer_queue[report_buffer_queue_tail];
+ report_buffer_queue_tail = (report_buffer_queue_tail + 1) % REPORT_BUFFER_QUEUE_SIZE;
+ return true;
+}
+
+bool report_buffer_is_empty() {
+ return report_buffer_queue_head == report_buffer_queue_tail;
+}
+
+void report_buffer_update_timer(void) {
+ report_timer_buffer = timer_read32();
+}
+
+bool report_buffer_next_inverval(void) {
+ return timer_elapsed32(report_timer_buffer) > report_interval;
+}
+
+void report_buffer_set_inverval(uint8_t interval) {
+ // OG_TRACE("report_buffer_set_inverval: %d\n\r", interval);
+ report_interval = interval;
+}
+
+uint8_t report_buffer_get_retry(void) {
+ return retry;
+}
+
+void report_buffer_set_retry(uint8_t times) {
+ retry = times;
+}
+
+void report_buffer_task(void) {
+ if (wireless_get_state() == WT_CONNECTED && (!report_buffer_is_empty() || retry) && report_buffer_next_inverval()) {
+ bool pending_data = false;
+
+ if (!retry) {
+ if (report_buffer_dequeue(&kb_rpt) && kb_rpt.type != REPORT_TYPE_NONE) {
+ if (timer_read32() > 2) {
+ pending_data = true;
+ retry = RETPORT_RETRY_COUNT;
+ retry_time_buffer = timer_read32();
+ }
+ }
+ } else {
+ if (timer_elapsed32(retry_time_buffer) > 2) {
+ pending_data = true;
+ --retry;
+ retry_time_buffer = timer_read32();
+ }
+ }
+
+ if (pending_data) {
+#if defined(NKRO_ENABLE) && defined(WIRELESS_NKRO_ENABLE)
+ if (kb_rpt.type == REPORT_TYPE_NKRO && wireless_transport.send_nkro) {
+ wireless_transport.send_nkro(&kb_rpt.nkro.mods);
+ } else if (kb_rpt.type == REPORT_TYPE_KB && wireless_transport.send_keyboard)
+ wireless_transport.send_keyboard(&kb_rpt.keyboard.mods);
+#else
+ if (kb_rpt.type == REPORT_TYPE_KB && wireless_transport.send_keyboard) wireless_transport.send_keyboard(&kb_rpt.keyboard.mods);
+#endif
+ if (kb_rpt.type == REPORT_TYPE_CONSUMER && wireless_transport.send_consumer) wireless_transport.send_consumer(kb_rpt.consumer);
+ report_timer_buffer = timer_read32();
+ lpm_timer_reset();
+ }
+ }
+}
diff --git a/keyboards/keychron/common/wireless/report_buffer.h b/keyboards/keychron/common/wireless/report_buffer.h
new file mode 100644
index 0000000000..639c5672ec
--- /dev/null
+++ b/keyboards/keychron/common/wireless/report_buffer.h
@@ -0,0 +1,61 @@
+/*/* Copyright 2022 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include "report.h"
+
+/* Default report interval value */
+#ifndef DEFAULT_BLE_REPORT_INVERVAL_MS
+# define DEFAULT_BLE_REPORT_INVERVAL_MS 3
+#endif
+
+/* Default report interval value */
+#ifndef DEFAULT_2P4G_REPORT_INVERVAL_MS
+# define DEFAULT_2P4G_REPORT_INVERVAL_MS 1
+#endif
+
+/* Default report interval value */
+#ifndef RETPORT_RETRY_COUNT
+# define RETPORT_RETRY_COUNT 30
+#endif
+
+enum {
+ REPORT_TYPE_NONE,
+ REPORT_TYPE_KB,
+ REPORT_TYPE_NKRO,
+ REPORT_TYPE_CONSUMER,
+};
+
+typedef struct {
+ uint8_t type;
+ union {
+ report_keyboard_t keyboard;
+ report_nkro_t nkro;
+ uint16_t consumer;
+ };
+} report_buffer_t;
+
+void report_buffer_init(void);
+bool report_buffer_enqueue(report_buffer_t *report);
+bool report_buffer_dequeue(report_buffer_t *report);
+bool report_buffer_is_empty(void);
+void report_buffer_update_timer(void);
+bool report_buffer_next_inverval(void);
+void report_buffer_set_inverval(uint8_t interval);
+uint8_t report_buffer_get_retry(void);
+void report_buffer_set_retry(uint8_t times);
+void report_buffer_task(void);
diff --git a/keyboards/keychron/common/wireless/rtc_timer.c b/keyboards/keychron/common/wireless/rtc_timer.c
new file mode 100644
index 0000000000..b5716703b0
--- /dev/null
+++ b/keyboards/keychron/common/wireless/rtc_timer.c
@@ -0,0 +1,43 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#include "hal.h"
+
+#if (HAL_USE_RTC)
+
+# include "rtc_timer.h"
+
+void rtc_timer_init(void) {
+ rtc_timer_clear();
+}
+
+void rtc_timer_clear(void) {
+ RTCDateTime tm = {0, 0, 0, 0, 0, 0};
+ rtcSetTime(&RTCD1, &tm);
+}
+
+uint32_t rtc_timer_read_ms(void) {
+ RTCDateTime tm;
+ rtcGetTime(&RTCD1, &tm);
+
+ return tm.millisecond;
+}
+
+uint32_t rtc_timer_elapsed_ms(uint32_t last) {
+ return TIMER_DIFF_32(rtc_timer_read_ms(), last);
+}
+
+#endif
diff --git a/keyboards/keychron/common/wireless/rtc_timer.h b/keyboards/keychron/common/wireless/rtc_timer.h
new file mode 100644
index 0000000000..efc0f088a4
--- /dev/null
+++ b/keyboards/keychron/common/wireless/rtc_timer.h
@@ -0,0 +1,35 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include "timer.h"
+#include
+
+#define RTC_MAX_TIME (24 * 3600 * 1000) // Set to 1 day
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+void rtc_timer_init(void);
+void rtc_timer_clear(void);
+uint32_t rtc_timer_read_ms(void);
+uint32_t rtc_timer_elapsed_ms(uint32_t last);
+
+#ifdef __cplusplus
+}
+#endif
diff --git a/keyboards/keychron/common/wireless/transport.c b/keyboards/keychron/common/wireless/transport.c
new file mode 100644
index 0000000000..77b48b9076
--- /dev/null
+++ b/keyboards/keychron/common/wireless/transport.c
@@ -0,0 +1,259 @@
+/*/* Copyright 2022 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "wireless.h"
+#include "indicator.h"
+#include "lpm.h"
+#include "mousekey.h"
+#if defined(PROTOCOL_CHIBIOS)
+# include
+#endif
+#include "transport.h"
+#include "lkbt51.h"
+
+#ifndef REINIT_LED_DRIVER
+# define REINIT_LED_DRIVER 0
+#endif
+
+#if defined(PROTOCOL_CHIBIOS)
+extern host_driver_t chibios_driver;
+#endif
+extern host_driver_t wireless_driver;
+extern keymap_config_t keymap_config;
+extern wt_func_t wireless_transport;
+
+static transport_t transport = TRANSPORT_NONE;
+
+#ifdef NKRO_ENABLE
+nkro_t nkro = {false, false};
+#endif
+
+static void transport_changed(transport_t new_transport);
+
+__attribute__((weak)) void bt_transport_enable(bool enable) {
+ if (enable) {
+ // if (host_get_driver() != &wireless_driver) {
+ host_set_driver(&wireless_driver);
+
+ /* Disconnect and reconnect to sync the wireless state
+ * TODO: query wireless state to sync
+ */
+ wireless_disconnect();
+
+ uint32_t t = timer_read32();
+ while (timer_elapsed32(t) < 100) {
+ wireless_transport.task();
+ }
+ // wireless_connect();
+ wireless_connect_ex(30, 0);
+ // TODO: Clear USB report
+ //}
+ } else {
+ indicator_stop();
+
+ if (wireless_get_state() == WT_CONNECTED && transport == TRANSPORT_BLUETOOTH) {
+ report_keyboard_t empty_report = {0};
+ wireless_driver.send_keyboard(&empty_report);
+ }
+ }
+}
+
+__attribute__((weak)) void p24g_transport_enable(bool enable) {
+ if (enable) {
+ // if (host_get_driver() != &wireless_driver) {
+ host_set_driver(&wireless_driver);
+
+ /* Disconnect and reconnect to sync the wireless state
+ * TODO: query bluetooth state to sync
+ */
+ wireless_disconnect();
+
+ uint32_t t = timer_read32();
+ while (timer_elapsed32(t) < 100) {
+ wireless_transport.task();
+ }
+ wireless_connect_ex(P24G_INDEX, 0);
+ // wireless_connect();
+ // TODO: Clear USB report
+ //}
+ } else {
+ indicator_stop();
+
+ if (wireless_get_state() == WT_CONNECTED && transport == TRANSPORT_P2P4) {
+ report_keyboard_t empty_report = {0};
+ wireless_driver.send_keyboard(&empty_report);
+ }
+ }
+}
+
+__attribute__((weak)) void usb_power_connect(void) {}
+__attribute__((weak)) void usb_power_disconnect(void) {}
+
+__attribute__((weak)) void usb_transport_enable(bool enable) {
+ if (enable) {
+ if (host_get_driver() != &chibios_driver) {
+// #if !defined(KEEP_USB_CONNECTION_IN_WIRELESS_MODE)
+// usb_power_connect();
+// usb_start(&USBD1);
+// #endif
+ host_set_driver(&chibios_driver);
+ }
+ } else {
+ if (USB_DRIVER.state == USB_ACTIVE) {
+ report_keyboard_t empty_report = {0};
+ chibios_driver.send_keyboard(&empty_report);
+ }
+
+#if !defined(KEEP_USB_CONNECTION_IN_WIRELESS_MODE)
+ usbStop(&USBD1);
+ usbDisconnectBus(&USBD1);
+ usb_power_disconnect();
+#endif
+ }
+}
+
+void set_transport(transport_t new_transport) {
+ if (transport != new_transport) {
+ if (transport == TRANSPORT_USB || ((transport != TRANSPORT_USB) && wireless_get_state() == WT_CONNECTED)) clear_keyboard();
+
+ transport = new_transport;
+
+ switch (transport) {
+ case TRANSPORT_USB:
+ usb_transport_enable(true);
+ bt_transport_enable(false);
+ wait_ms(5);
+ p24g_transport_enable(false);
+ wireless_disconnect();
+ lpm_timer_stop();
+ break;
+
+ case TRANSPORT_BLUETOOTH:
+ p24g_transport_enable(false);
+ wait_ms(1);
+ bt_transport_enable(true);
+ usb_transport_enable(false);
+ lpm_timer_reset();
+ break;
+
+ case TRANSPORT_P2P4:
+ bt_transport_enable(false);
+ wait_ms(1);
+ p24g_transport_enable(true);
+ usb_transport_enable(false);
+ lpm_timer_reset();
+ break;
+
+ default:
+ break;
+ }
+
+ transport_changed(transport);
+ }
+}
+
+transport_t get_transport(void) {
+ return transport;
+}
+
+#if (REINIT_LED_DRIVER)
+/* Changing transport may cause bronw-out reset of led driver
+ * withoug MCU reset, which lead backlight to not work,
+ * reinit the led driver workgound this issue */
+static void reinit_led_drvier(void) {
+ /* Wait circuit to discharge for a while */
+ systime_t start = chVTGetSystemTime();
+ while (chTimeI2MS(chVTTimeElapsedSinceX(start)) < 100) {
+ };
+
+# ifdef LED_MATRIX_ENABLE
+ led_matrix_init();
+# endif
+# ifdef RGB_MATRIX_ENABLE
+ rgb_matrix_init();
+# endif
+}
+#endif
+
+void transport_changed(transport_t new_transport) {
+ kc_printf("transport_changed %d\n\r", new_transport);
+ indicator_init();
+
+#if (REINIT_LED_DRIVER)
+ reinit_led_drvier();
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) && defined(RGB_MATRIX_TIMEOUT)
+# if (RGB_MATRIX_TIMEOUT > 0)
+ rgb_matrix_disable_timeout_set(RGB_MATRIX_TIMEOUT_INFINITE);
+ rgb_matrix_disable_time_reset();
+# endif
+#endif
+#if defined(LED_MATRIX_ENABLE) && defined(LED_MATRIX_TIMEOUT)
+# if (LED_MATRIX_TIMEOUT > 0)
+ led_matrix_disable_timeout_set(LED_MATRIX_TIMEOUT_INFINITE);
+ led_matrix_disable_time_reset();
+# endif
+#endif
+}
+
+void usb_remote_wakeup(void) {
+ if (USB_DRIVER.state == USB_SUSPENDED) {
+ while (USB_DRIVER.state == USB_SUSPENDED) {
+ wireless_pre_task();
+ if (get_transport() != TRANSPORT_USB) {
+ suspend_wakeup_init_quantum();
+ return;
+ }
+ /* Do this in the suspended state */
+ suspend_power_down(); // on AVR this deep sleeps for 15ms
+ /* Remote wakeup */
+ if (suspend_wakeup_condition()
+#ifdef ENCODER_ENABLE
+ //|| encoder_read()
+#endif
+ ) {
+ usbWakeupHost(&USB_DRIVER);
+ wait_ms(300);
+#ifdef MOUSEKEY_ENABLE
+ // Wiggle to wakeup
+ mousekey_on(KC_MS_LEFT);
+ mousekey_send();
+ wait_ms(10);
+ mousekey_on(KC_MS_RIGHT);
+ mousekey_send();
+ wait_ms(10);
+ mousekey_off((KC_MS_RIGHT));
+ mousekey_send();
+#else
+ set_mods(0x02);
+ send_keyboard_report();
+ wait_ms(10);
+ del_mods(0x02);
+ send_keyboard_report();
+#endif
+ }
+ }
+ /* Woken up */
+ // variables has been already cleared by the wakeup hook
+ send_keyboard_report();
+#ifdef MOUSEKEY_ENABLE
+ mousekey_send();
+#endif /* MOUSEKEY_ENABLE */
+ usb_event_queue_task();
+ }
+}
diff --git a/keyboards/keychron/common/wireless/transport.h b/keyboards/keychron/common/wireless/transport.h
new file mode 100644
index 0000000000..9ac7810e58
--- /dev/null
+++ b/keyboards/keychron/common/wireless/transport.h
@@ -0,0 +1,42 @@
+/*/* Copyright 2022 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+typedef enum {
+ TRANSPORT_NONE,
+ TRANSPORT_USB = 0x01 << 0,
+ TRANSPORT_BLUETOOTH = 0x01 << 1,
+ TRANSPORT_P2P4 = 0x01 << 2,
+ TRANSPORT_MAX,
+} transport_t;
+
+#ifdef NKRO_ENABLE
+typedef struct {
+ bool usb : 1;
+ bool bluetooth : 1;
+} nkro_t;
+#endif
+
+#define TRANSPORT_WIRELESS (TRANSPORT_BLUETOOTH | TRANSPORT_P2P4)
+
+void set_transport(transport_t new_transport);
+transport_t get_transport(void);
+
+void usb_power_connect(void);
+void usb_power_disconnect(void);
+void usb_transport_enable(bool enable);
+void usb_remote_wakeup(void);
diff --git a/keyboards/keychron/common/wireless/wireless.c b/keyboards/keychron/common/wireless/wireless.c
new file mode 100644
index 0000000000..c5789d1467
--- /dev/null
+++ b/keyboards/keychron/common/wireless/wireless.c
@@ -0,0 +1,541 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "wireless.h"
+#include "report_buffer.h"
+#include "lpm.h"
+#include "battery.h"
+#include "indicator.h"
+#include "transport.h"
+#include "rtc_timer.h"
+#include "keychron_wireless_common.h"
+#include "keychron_task.h"
+
+extern uint8_t pairing_indication;
+extern host_driver_t chibios_driver;
+extern report_buffer_t kb_rpt;
+extern uint32_t retry_time_buffer;
+extern uint8_t retry;
+
+static uint8_t host_index = 0;
+static uint8_t led_state = 0;
+
+extern wt_func_t wireless_transport;
+static wt_state_t wireless_state = WT_RESET;
+static bool pincodeEntry = false;
+uint8_t wireless_report_protocol = true;
+
+/* declarations */
+uint8_t wreless_keyboard_leds(void);
+void wireless_send_keyboard(report_keyboard_t *report);
+void wireless_send_nkro(report_nkro_t *report);
+void wireless_send_mouse(report_mouse_t *report);
+void wireless_send_extra(report_extra_t *report);
+bool process_record_wireless(uint16_t keycode, keyrecord_t *record);
+
+/* host struct */
+host_driver_t wireless_driver = {wreless_keyboard_leds, wireless_send_keyboard, wireless_send_nkro, wireless_send_mouse, wireless_send_extra};
+
+#define WT_EVENT_QUEUE_SIZE 16
+wireless_event_t wireless_event_queue[WT_EVENT_QUEUE_SIZE];
+uint8_t wireless_event_queue_head;
+uint8_t wireless_event_queue_tail;
+
+void wireless_event_queue_init(void) {
+ // Initialise the event queue
+ memset(&wireless_event_queue, 0, sizeof(wireless_event_queue));
+ wireless_event_queue_head = 0;
+ wireless_event_queue_tail = 0;
+}
+
+bool wireless_event_enqueue(wireless_event_t event) {
+ uint8_t next = (wireless_event_queue_head + 1) % WT_EVENT_QUEUE_SIZE;
+ if (next == wireless_event_queue_tail) {
+ /* Override the first report */
+ wireless_event_queue_tail = (wireless_event_queue_tail + 1) % WT_EVENT_QUEUE_SIZE;
+ }
+ wireless_event_queue[wireless_event_queue_head] = event;
+ wireless_event_queue_head = next;
+ return true;
+}
+
+static inline bool wireless_event_dequeue(wireless_event_t *event) {
+ if (wireless_event_queue_head == wireless_event_queue_tail) {
+ return false;
+ }
+ *event = wireless_event_queue[wireless_event_queue_tail];
+ wireless_event_queue_tail = (wireless_event_queue_tail + 1) % WT_EVENT_QUEUE_SIZE;
+ return true;
+}
+
+/*
+ * Bluetooth init.
+ */
+void wireless_init(void) {
+ wireless_state = WT_INITIALIZED;
+
+ wireless_event_queue_init();
+#ifndef DISABLE_REPORT_BUFFER
+ report_buffer_init();
+#endif
+ indicator_init();
+#ifdef BLUETOOTH_INT_INPUT_PIN
+ gpio_set_pin_input_high(BLUETOOTH_INT_INPUT_PIN);
+#endif
+
+ battery_init();
+ lpm_init();
+#if HAL_USE_RTC
+ rtc_timer_init();
+#endif
+}
+
+/*
+ * Bluetooth trasponrt init. Bluetooth module driver shall use this function to register a callback
+ * to its implementation.
+ */
+void wireless_set_transport(wt_func_t *transport) {
+ if (transport) memcpy(&wireless_transport, transport, sizeof(wt_func_t));
+}
+
+/*
+ * Enter pairing with current host index
+ */
+void wireless_pairing(void) {
+ if (battery_is_critical_low()) return;
+
+ wireless_pairing_ex(0, NULL);
+ wireless_state = WT_PARING;
+}
+
+/*
+ * Enter pairing with specified host index and param
+ */
+void wireless_pairing_ex(uint8_t host_idx, void *param) {
+ kc_printf("wireless_pairing_ex %d\n\r", host_idx);
+ if (battery_is_critical_low()) return;
+
+ if (wireless_transport.pairing_ex) wireless_transport.pairing_ex(host_idx, param);
+ wireless_state = WT_PARING;
+
+ host_index = host_idx;
+}
+
+/*
+ * Initiate connection request to paired host
+ */
+void wireless_connect(void) {
+ /* Work around empty report after wakeup, which leads to reconneect/disconnected loop */
+ if (battery_is_critical_low() || timer_read32() == 0) return;
+
+ if (wireless_state == WT_RECONNECTING && !indicator_is_running()) {
+ indicator_set(wireless_state, host_index);
+ }
+ wireless_transport.connect_ex(0, 0);
+ wireless_state = WT_RECONNECTING;
+}
+
+/*
+ * Initiate connection request to paired host with argument
+ */
+void wireless_connect_ex(uint8_t host_idx, uint16_t timeout) {
+ kc_printf("wireless_connect_ex %d\n\r", host_idx);
+ if (battery_is_critical_low()) return;
+
+ if (host_idx != 0) {
+ /* Do nothing when trying to connect to current connected host*/
+ if (host_index == host_idx && wireless_state == WT_CONNECTED) return;
+
+ host_index = host_idx;
+ led_state = 0;
+ }
+ wireless_transport.connect_ex(host_idx, timeout);
+ wireless_state = WT_RECONNECTING;
+}
+
+/* Initiate a disconnection */
+void wireless_disconnect(void) {
+ kc_printf("wireless_disconnect\n\r");
+ if (wireless_transport.disconnect) wireless_transport.disconnect();
+}
+
+/* Called when the BT device is reset. */
+static void wireless_enter_reset(uint8_t reason) {
+ kc_printf("wireless_enter_reset\n\r");
+ wireless_state = WT_RESET;
+ wireless_enter_reset_kb(reason);
+}
+
+/* Enters discoverable state. Upon entering this state we perform the following actions:
+ * - change state to WT_PARING
+ * - set pairing indication
+ */
+static void wireless_enter_discoverable(uint8_t host_idx) {
+ kc_printf("wireless_enter_discoverable: %d\n\r", host_idx);
+ host_index = host_idx;
+
+ wireless_state = WT_PARING;
+ indicator_set(wireless_state, host_idx);
+ wireless_enter_discoverable_kb(host_idx);
+}
+
+/*
+ * Enters reconnecting state. Upon entering this state we perform the following actions:
+ * - change state to RECONNECTING
+ * - set reconnect indication
+ */
+static void wireless_enter_reconnecting(uint8_t host_idx) {
+ host_index = host_idx;
+
+ kc_printf("wireless_reconnecting %d\n\r", host_idx);
+ wireless_state = WT_RECONNECTING;
+ indicator_set(wireless_state, host_idx);
+ wireless_enter_reconnecting_kb(host_idx);
+}
+
+/* Enters connected state. Upon entering this state we perform the following actions:
+ * - change state to CONNECTED
+ * - set connected indication
+ * - enable NKRO if it is support
+ */
+static void wireless_enter_connected(uint8_t host_idx) {
+ kc_printf("wireless_connected %d\n\r", host_idx);
+
+ wireless_state = WT_CONNECTED;
+ indicator_set(wireless_state, host_idx);
+ host_index = host_idx;
+
+ clear_keyboard();
+
+ /* Enable NKRO since it may be disabled in pin code entry */
+#if defined(NKRO_ENABLE) && !defined(WIRELESS_NKRO_ENABLE)
+ keymap_config.nkro = false;
+#endif
+
+ wireless_enter_connected_kb(host_idx);
+ if (battery_is_empty()) {
+ indicator_battery_low_enable(true);
+ }
+ if (wireless_transport.update_bat_level) wireless_transport.update_bat_level(battery_get_percentage());
+ lpm_timer_reset();
+}
+
+/* Enters disconnected state. Upon entering this state we perform the following actions:
+ * - change state to DISCONNECTED
+ * - set disconnected indication
+ */
+static void wireless_enter_disconnected(uint8_t host_idx, uint8_t reason) {
+ kc_printf("wireless_disconnected %d, %d\n\r", host_idx, reason);
+
+ uint8_t previous_state = wireless_state;
+ led_state = 0;
+ if (get_transport() & TRANSPORT_WIRELESS)
+ led_update_kb((led_t)led_state);
+
+ wireless_state = WT_DISCONNECTED;
+
+ if (previous_state == WT_CONNECTED) {
+ lpm_timer_reset();
+ indicator_set(WT_SUSPEND, host_idx);
+ } else {
+ indicator_set(wireless_state, host_idx);
+#if defined(RGB_MATRIX) || defined(LED_MATRIX)
+ if (reason && (get_transport() & TRANSPORT_WIRELESS))
+ indicator_set_backlit_timeout(DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT*1000);
+#endif
+ }
+
+#ifndef DISABLE_REPORT_BUFFER
+ report_buffer_init();
+#endif
+ retry = 0;
+ wireless_enter_disconnected_kb(host_idx, reason);
+
+ indicator_battery_low_enable(false);
+}
+
+/* Enter pin code entry state. */
+static void wireless_enter_bluetooth_pin_code_entry(void) {
+#if defined(NKRO_ENABLE)
+ keymap_config.nkro = FALSE;
+#endif
+ pincodeEntry = true;
+ wireless_enter_bluetooth_pin_code_entry_kb();
+}
+
+/* Exit pin code entry state. */
+static void wireless_exit_bluetooth_pin_code_entry(void) {
+#if defined(NKRO_ENABLE) || defined(WIRELESS_NKRO_ENABLE)
+ keymap_config.raw = eeconfig_read_keymap();
+#endif
+ pincodeEntry = false;
+ wireless_exit_bluetooth_pin_code_entry_kb();
+}
+
+/* Enters disconnected state. Upon entering this state we perform the following actions:
+ * - change state to DISCONNECTED
+ * - set disconnected indication
+ */
+static void wireless_enter_sleep(void) {
+ kc_printf("wireless_enter_sleep %d\n\r", wireless_state);
+
+ led_state = 0;
+
+ if (wireless_state == WT_CONNECTED || wireless_state == WT_PARING) {
+ wireless_state = WT_SUSPEND;
+ kc_printf("WT_SUSPEND\n\r");
+ lpm_timer_reset();
+
+ wireless_enter_sleep_kb();
+ indicator_set(wireless_state, 0);
+ indicator_battery_low_enable(false);
+ }
+}
+
+__attribute__((weak)) void wireless_enter_reset_kb(uint8_t reason) {}
+__attribute__((weak)) void wireless_enter_discoverable_kb(uint8_t host_idx) {}
+__attribute__((weak)) void wireless_enter_reconnecting_kb(uint8_t host_idx) {}
+__attribute__((weak)) void wireless_enter_connected_kb(uint8_t host_idx) {}
+__attribute__((weak)) void wireless_enter_disconnected_kb(uint8_t host_idx, uint8_t reason) {}
+__attribute__((weak)) void wireless_enter_bluetooth_pin_code_entry_kb(void) {}
+__attribute__((weak)) void wireless_exit_bluetooth_pin_code_entry_kb(void) {}
+__attribute__((weak)) void wireless_enter_sleep_kb(void) {}
+
+/* */
+static void wireless_hid_set_protocol(bool report_protocol) {
+ wireless_report_protocol = false;
+}
+
+uint8_t wreless_keyboard_leds(void) {
+ if (wireless_state == WT_CONNECTED) {
+ return led_state;
+ }
+
+ return 0;
+}
+
+extern keymap_config_t keymap_config;
+
+void wireless_send_keyboard(report_keyboard_t *report) {
+ if (battery_is_critical_low()) return;
+
+ if (wireless_state == WT_PARING && !pincodeEntry) return;
+
+ if (wireless_state == WT_CONNECTED || (wireless_state == WT_PARING && pincodeEntry)) {
+ if (wireless_transport.send_keyboard) {
+#ifndef DISABLE_REPORT_BUFFER
+ bool empty = report_buffer_is_empty();
+
+ report_buffer_t report_buffer;
+ report_buffer.type = REPORT_TYPE_KB;
+ memcpy(&report_buffer.keyboard, report, sizeof(report_keyboard_t));
+ report_buffer_enqueue(&report_buffer);
+
+ if (empty)
+ report_buffer_task();
+#else
+ wireless_transport.send_keyboard(&report->mods);
+#endif
+ }
+ } else if (wireless_state != WT_RESET) {
+ wireless_connect();
+ }
+}
+
+void wireless_send_nkro(report_nkro_t *report) {
+ if (battery_is_critical_low()) return;
+
+ if (wireless_state == WT_PARING && !pincodeEntry) return;
+
+ if (wireless_state == WT_CONNECTED || (wireless_state == WT_PARING && pincodeEntry)) {
+ if (wireless_transport.send_nkro) {
+#ifndef DISABLE_REPORT_BUFFER
+ bool empty = report_buffer_is_empty();
+
+ report_buffer_t report_buffer;
+ report_buffer.type = REPORT_TYPE_NKRO;
+ memcpy(&report_buffer.nkro, report, sizeof(report_nkro_t));
+ report_buffer_enqueue(&report_buffer);
+
+ if (empty)
+ report_buffer_task();
+#else
+ wireless_transport.send_nkro(&report->mods);
+#endif
+ }
+ } else if (wireless_state != WT_RESET) {
+ wireless_connect();
+ }
+}
+
+void wireless_send_mouse(report_mouse_t *report) {
+ if (battery_is_critical_low()) return;
+
+ if (wireless_state == WT_CONNECTED) {
+ if (wireless_transport.send_mouse) wireless_transport.send_mouse((uint8_t *)report);
+ } else if (wireless_state != WT_RESET) {
+ wireless_connect();
+ }
+}
+
+void wireless_send_system(uint16_t data) {
+ if (wireless_state == WT_CONNECTED) {
+ if (wireless_transport.send_system) wireless_transport.send_system(data);
+ } else if (wireless_state != WT_RESET) {
+ wireless_connect();
+ }
+}
+
+void wireless_send_consumer(uint16_t data) {
+ if (wireless_state == WT_CONNECTED) {
+#ifndef DISABLE_REPORT_BUFFER
+ if (report_buffer_is_empty() && report_buffer_next_inverval()) {
+ if (wireless_transport.send_consumer) wireless_transport.send_consumer(data);
+ report_buffer_update_timer();
+ } else {
+ report_buffer_t report_buffer;
+ report_buffer.type = REPORT_TYPE_CONSUMER;
+ report_buffer.consumer = data;
+ report_buffer_enqueue(&report_buffer);
+ }
+#else
+ if (wireless_transport.send_consumer) wireless_transport.send_consumer(data);
+#endif
+ } else if (wireless_state != WT_RESET) {
+ wireless_connect();
+ }
+}
+
+void wireless_send_extra(report_extra_t *report) {
+ if (battery_is_critical_low()) return;
+
+ if (report->report_id == REPORT_ID_SYSTEM) {
+ wireless_send_system(report->usage);
+ } else if (report->report_id == REPORT_ID_CONSUMER) {
+ wireless_send_consumer(report->usage);
+ }
+}
+
+void wireless_low_battery_shutdown(void) {
+ indicator_battery_low_enable(false);
+
+
+ report_buffer_init();
+ clear_keyboard(); //
+ wait_ms(50); // wait a while for bt module to free buffer by sending report
+
+ // Release all keys by sending empty reports
+ if (keymap_config.nkro) {
+ report_nkro_t empty_nkro_report;
+ memset(&empty_nkro_report, 0, sizeof(empty_nkro_report));
+ wireless_transport.send_nkro(&empty_nkro_report.mods);
+ } else {
+ report_keyboard_t empty_report;
+ memset(&empty_report, 0, sizeof(empty_report));
+ wireless_transport.send_keyboard(&empty_report.mods);
+ }
+ wait_ms(10);
+ wireless_transport.send_consumer(0);
+ wait_ms(10);
+ report_mouse_t empty_mouse_report;
+ memset(&empty_mouse_report, 0, sizeof(empty_mouse_report));
+ wireless_transport.send_mouse((uint8_t *)&empty_mouse_report);
+ wait_ms(300); // Wait for bt module to send all buffered report
+
+ wireless_disconnect();
+}
+
+void wireless_event_task(void) {
+ wireless_event_t event;
+ while (wireless_event_dequeue(&event)) {
+ switch (event.evt_type) {
+ case EVT_RESET:
+ wireless_enter_reset(event.params.reason);
+ break;
+ case EVT_CONNECTED:
+ wireless_enter_connected(event.params.hostIndex);
+ break;
+ case EVT_DISCOVERABLE:
+ wireless_enter_discoverable(event.params.hostIndex);
+ break;
+ case EVT_RECONNECTING:
+ wireless_enter_reconnecting(event.params.hostIndex);
+ break;
+ case EVT_DISCONNECTED:
+ wireless_enter_disconnected(event.params.hostIndex, event.data);
+ break;
+ case EVT_BT_PINCODE_ENTRY:
+ wireless_enter_bluetooth_pin_code_entry();
+ break;
+ case EVT_EXIT_BT_PINCODE_ENTRY:
+ wireless_exit_bluetooth_pin_code_entry();
+ break;
+ case EVT_SLEEP:
+ wireless_enter_sleep();
+ break;
+ case EVT_HID_INDICATOR:
+ led_state = event.params.led;
+ break;
+ case EVT_HID_SET_PROTOCOL:
+ wireless_hid_set_protocol(event.params.protocol);
+ break;
+ case EVT_CONECTION_INTERVAL:
+ report_buffer_set_inverval(event.params.interval);
+ break;
+ default:
+ break;
+ }
+ }
+}
+
+void wireless_task(void) {
+ wireless_transport.task();
+ wireless_event_task();
+#ifndef DISABLE_REPORT_BUFFER
+ report_buffer_task();
+#endif
+ indicator_task();
+ keychron_wireless_common_task();
+ battery_task();
+ lpm_task();
+}
+
+void send_string_task(void) {
+ if ((get_transport() & TRANSPORT_WIRELESS) && wireless_get_state() == WT_CONNECTED) {
+ wireless_transport.task();
+#ifndef DISABLE_REPORT_BUFFER
+ report_buffer_task();
+#endif
+ }
+}
+wt_state_t wireless_get_state(void) {
+ return wireless_state;
+};
+
+bool process_record_wireless(uint16_t keycode, keyrecord_t *record) {
+ if (get_transport() & TRANSPORT_WIRELESS) {
+ lpm_timer_reset();
+
+ if (battery_is_empty() && wireless_get_state() == WT_CONNECTED && record->event.pressed) {
+ indicator_battery_low_enable(true);
+ }
+ }
+
+ if (!process_record_keychron_wireless(keycode, record)) return false;
+
+ return true;
+}
diff --git a/keyboards/keychron/common/wireless/wireless.h b/keyboards/keychron/common/wireless/wireless.h
new file mode 100644
index 0000000000..0d90c9a18e
--- /dev/null
+++ b/keyboards/keychron/common/wireless/wireless.h
@@ -0,0 +1,101 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include "wireless_event_type.h"
+#include "action.h"
+
+#ifdef KC_DEBUG
+# define kc_printf dprintf
+#else
+# define kc_printf(format, ...)
+#endif
+
+/* Low power mode */
+#ifndef LOW_POWER_MODE
+# define LOW_POWER_MODE PM_STOP
+#endif
+
+/* Wake pin used for blueooth module/controller to wake up MCU in low power mode*/
+#ifndef BLUETOOTH_INT_INPUT_PIN
+# define WAKE_PIN A5
+#endif
+
+// clang-format off
+/* Type of an enumeration of the possible wireless transport state.*/
+typedef enum {
+ WT_RESET,
+ WT_INITIALIZED, // 1
+ WT_DISCONNECTED, // 2
+ WT_CONNECTED, // 3
+ WT_PARING, // 4
+ WT_RECONNECTING, // 5
+ WT_SUSPEND
+} wt_state_t;
+
+//extern event_listener_t wireless_driver;
+
+typedef struct {
+ void (*init)(bool);
+ void (*connect_ex)(uint8_t, uint16_t);
+ void (*pairing_ex)(uint8_t, void *);
+ void (*disconnect)(void);
+ void (*send_keyboard)(uint8_t *);
+ void (*send_nkro)(uint8_t *);
+ void (*send_consumer)(uint16_t);
+ void (*send_system)(uint16_t);
+ void (*send_mouse)(uint8_t *);
+ void (*update_bat_level)(uint8_t);
+ void (*task)(void);
+} wt_func_t;
+// clang-format on
+
+extern void register_wt_tasks(void);
+
+void wireless_init(void);
+void wireless_set_transport(wt_func_t *transport);
+void wireless(void);
+
+bool wireless_event_enqueue(wireless_event_t event);
+
+void wireless_connect(void);
+void wireless_connect_ex(uint8_t host_idx, uint16_t timeout);
+void wireless_disconnect(void);
+
+void wireless_pairing(void);
+void wireless_pairing_ex(uint8_t host_idx, void *param);
+// bool bluetooth_is_activated(void);
+
+void wireless_enter_reset_kb(uint8_t reason);
+void wireless_enter_discoverable_kb(uint8_t host_idx);
+void wireless_enter_reconnecting_kb(uint8_t host_idx);
+void wireless_enter_connected_kb(uint8_t host_idx);
+void wireless_enter_disconnected_kb(uint8_t host_idx, uint8_t reason);
+void wireless_enter_bluetooth_pin_code_entry_kb(void);
+void wireless_exit_bluetooth_pin_code_entry_kb(void);
+void wireless_enter_sleep_kb(void);
+
+void wireless_task(void);
+void wireless_pre_task(void);
+void wireless_post_task(void);
+void send_string_task(void);
+
+wt_state_t wireless_get_state(void);
+
+void wireless_low_battery_shutdown(void);
+
+bool process_record_wireless(uint16_t keycode, keyrecord_t *record);
diff --git a/keyboards/keychron/common/wireless/wireless.mk b/keyboards/keychron/common/wireless/wireless.mk
new file mode 100644
index 0000000000..30b9fa9819
--- /dev/null
+++ b/keyboards/keychron/common/wireless/wireless.mk
@@ -0,0 +1,32 @@
+OPT_DEFS += -DLK_WIRELESS_ENABLE
+OPT_DEFS += -DNO_USB_STARTUP_CHECK
+OPT_DEFS += -DCORTEX_ENABLE_WFI_IDLE=TRUE
+OPT_DEFS += -DWIRELESS_NKRO_ENABLE
+
+INFO_RULES_MK = $(shell $(QMK_BIN) generate-rules-mk --quiet --escape --keyboard $(KEYBOARD) --output $(INTERMEDIATE_OUTPUT)/src/info_rules.mk)
+include $(INFO_RULES_MK)
+
+WIRELESS_DIR = common/wireless
+SRC += \
+ $(WIRELESS_DIR)/wireless.c \
+ $(WIRELESS_DIR)/report_buffer.c \
+ $(WIRELESS_DIR)/lkbt51.c \
+ $(WIRELESS_DIR)/indicator.c \
+ $(WIRELESS_DIR)/wireless_main.c \
+ $(WIRELESS_DIR)/transport.c \
+ $(WIRELESS_DIR)/lpm.c \
+ $(WIRELESS_DIR)/battery.c \
+ $(WIRELESS_DIR)/bat_level_animation.c \
+ $(WIRELESS_DIR)/rtc_timer.c \
+ $(WIRELESS_DIR)/keychron_wireless_common.c
+
+ifeq ($(strip $(MCU)), STM32F401)
+SRC += $(WIRELESS_DIR)/lpm_stm32f401.c
+endif
+
+ifeq ($(strip $(MCU)), WB32F3G71)
+SRC += $(WIRELESS_DIR)/lpm_wb32f3g71.c
+endif
+
+VPATH += $(TOP_DIR)/keyboards/keychron/$(WIRELESS_DIR)
+
diff --git a/keyboards/keychron/common/wireless/wireless_config.h b/keyboards/keychron/common/wireless/wireless_config.h
new file mode 100644
index 0000000000..6e0ba9e8ec
--- /dev/null
+++ b/keyboards/keychron/common/wireless/wireless_config.h
@@ -0,0 +1,36 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include "config.h"
+
+//
+#ifndef BT_HOST_DEVICES_COUNT
+# define BT_HOST_DEVICES_COUNT 3
+#endif
+
+#define P2P4G_HOST_DEVICES_COUNT 1
+
+// Uint: Second
+#ifndef DISCONNECTED_BACKLIGHT_OFF_DELAY_TIME
+# define DISCONNECTED_BACKLIGHT_OFF_DELAY_TIME 40
+#endif
+
+// Uint: Second, the timer restarts on key activities.
+#ifndef CONNECTED_BACKLIGHT_OFF_DELAY_TIME
+# define CONNECTED_BACKLIGHT_OFF_DELAY_TIME 600
+#endif
diff --git a/keyboards/keychron/common/wireless/wireless_event_type.h b/keyboards/keychron/common/wireless/wireless_event_type.h
new file mode 100644
index 0000000000..466cb25b0b
--- /dev/null
+++ b/keyboards/keychron/common/wireless/wireless_event_type.h
@@ -0,0 +1,45 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Type of an enumeration of the possible wireless events.*/
+typedef enum {
+ EVT_NONE = 0,
+ EVT_RESET,
+ EVT_DISCOVERABLE,
+ EVT_RECONNECTING,
+ EVT_CONNECTED,
+ EVT_DISCONNECTED,
+ EVT_BT_PINCODE_ENTRY,
+ EVT_EXIT_BT_PINCODE_ENTRY,
+ EVT_SLEEP,
+ EVT_HID_SET_PROTOCOL,
+ EVT_HID_INDICATOR,
+ EVT_CONECTION_INTERVAL,
+} event_type_t;
+
+typedef struct {
+ event_type_t evt_type; /*The type of the event. */
+ union {
+ uint8_t reason; /* Parameters to WT_RESET event */
+ uint8_t hostIndex; /* Parameters to connection event from EVT_DISCOVERABLE to EVT_DISCONECTED */
+ uint8_t led; /* Parameters to EVT_HID_INDICATOR event */
+ uint8_t protocol; /* Parameters to EVT_HID_SET_PROTOCOL event */
+ uint8_t interval; /* Parameters to EVT_CONECTION_INTERVAL event */
+ } params;
+ uint8_t data;
+} wireless_event_t;
diff --git a/keyboards/keychron/common/wireless/wireless_main.c b/keyboards/keychron/common/wireless/wireless_main.c
new file mode 100644
index 0000000000..146b3a1dec
--- /dev/null
+++ b/keyboards/keychron/common/wireless/wireless_main.c
@@ -0,0 +1,36 @@
+/* Copyright 2023 ~ 2025 @ lokher (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "wireless.h"
+#include "transport.h"
+#include "factory_test.h"
+#include "keychron_task.h"
+
+__attribute__((weak)) void wireless_pre_task(void) {}
+__attribute__((weak)) void wireless_post_task(void) {}
+
+bool wireless_tasks(void) {
+ wireless_pre_task();
+ wireless_task();
+ wireless_post_task();
+
+ /* usb_remote_wakeup() should be invoked last so that we have chance
+ * to switch to wireless after start-up when usb is not connected
+ */
+ if (get_transport() == TRANSPORT_USB) usb_remote_wakeup();
+ return true;
+}
diff --git a/keyboards/keychron/k10_max/ansi/rgb/config.h b/keyboards/keychron/k10_max/ansi/rgb/config.h
new file mode 100644
index 0000000000..9176ee1fd0
--- /dev/null
+++ b/keyboards/keychron/k10_max/ansi/rgb/config.h
@@ -0,0 +1,43 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 108
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define NUM_LOCK_INDEX 36
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k10_max/ansi/rgb/keyboard.json b/keyboards/keychron/k10_max/ansi/rgb/keyboard.json
new file mode 100644
index 0000000000..a103b78158
--- /dev/null
+++ b/keyboards/keychron/k10_max/ansi/rgb/keyboard.json
@@ -0,0 +1,40 @@
+{
+ "usb": {
+ "pid": "0x0AA0",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "indicators": {
+ "caps_lock": "C9",
+ "on_state": 1
+ }
+}
diff --git a/keyboards/keychron/k10_max/ansi/rgb/keymaps/default/keymap.c b/keyboards/keychron/k10_max/ansi/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..8326bb11d9
--- /dev/null
+++ b/keyboards/keychron/k10_max/ansi/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_108(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, RGB_MOD, KC_F13, KC_F14, KC_F15, KC_F16,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [MAC_FN] = LAYOUT_ansi_108(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_108(
+ 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_CTANA, RGB_MOD, _______, _______, _______, _______,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [WIN_FN] = LAYOUT_ansi_108(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k10_max/ansi/rgb/rgb.c b/keyboards/keychron/k10_max/ansi/rgb/rgb.c
new file mode 100644
index 0000000000..2aa6751073
--- /dev/null
+++ b/keyboards/keychron/k10_max/ansi/rgb/rgb.c
@@ -0,0 +1,175 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB10_CA6, CB12_CA6, CB11_CA6},
+ {1, CB10_CA5, CB12_CA5, CB11_CA5},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to RGB Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18 },
+ { 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38 },
+ { 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58 },
+ { 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78 },
+ { 79, __, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, __, 90, __, 91, __, 92, 93, 94 },
+ { 95, 96, 97, __, __, __, 98, __, __, __, 99, 100, 101, 102, 103, 104, 105, __, 106, 107 },
+ },
+ {
+ // RGB Index to Physical Position
+ {0, 0}, {21, 0}, {31, 0}, {42, 0}, {52, 0}, {68, 0}, {78, 0}, {89, 0}, {99, 0}, {115, 0}, {125, 0}, {136, 0}, {146, 0}, {159, 0}, {169, 0}, {180, 0}, {193, 0}, {203, 0}, {214, 0},
+ {0,15}, {10,15}, {21,15}, {31,15}, {42,15}, {52,15}, {63,15}, {73,15}, {83,15}, {94,15}, {104,15}, {115,15}, {125,15}, {141,15}, {159,15}, {169,15}, {180,15}, {193,15}, {203,15}, {214,15},
+ {3,27}, {16,27}, {26,27}, {36,27}, {47,27}, {57,27}, {68,27}, {78,27}, {89,27}, {99,27}, {109,27}, {120,27}, {130,27}, {143,27}, {159,27}, {169,27}, {180,27}, {193,27}, {203,27}, {214,27},
+ {4,40}, {18,40}, {29,40}, {39,40}, {50,40}, {60,40}, {70,40}, {81,40}, {91,40}, {102,40},{112,40}, {123,40}, {139,40}, {224, 0}, {224,15}, {224,34}, {224,58}, {193,40}, {203,40}, {214,40},
+ {7,52}, {23,52}, {34,52}, {44,52}, {55,52}, {65,52}, {76,52}, {86,52}, {96,52}, {107,52}, {117,52}, {137,52}, {169,52}, {193,52}, {203,52}, {214,52},
+ {1,64}, {14,64}, {27,64}, {66,64}, {105,64}, {118,64}, {131,64}, {145,64}, {159,64}, {169,64}, {180,64}, {198,64}, {214,64},
+ },
+ {
+ // RGB Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k10_max/ansi/rgb/rules.mk b/keyboards/keychron/k10_max/ansi/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k10_max/ansi/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k10_max/ansi/white/config.h b/keyboards/keychron/k10_max/ansi/white/config.h
new file mode 100644
index 0000000000..a572567a35
--- /dev/null
+++ b/keyboards/keychron/k10_max/ansi/white/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 108
+# define LED_MATRIX_VAL_STEP 16
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 9 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x56, 0x56, 0x56, 0x56, 0x56, 0x56, 0x56, 0x56, 0x56, 0x56, 0x56, 0x56 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_NUM_LOCK
+# define NUM_LOCK_INDEX 36
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k10_max/ansi/white/keyboard.json b/keyboards/keychron/k10_max/ansi/white/keyboard.json
new file mode 100644
index 0000000000..5b73b8e274
--- /dev/null
+++ b/keyboards/keychron/k10_max/ansi/white/keyboard.json
@@ -0,0 +1,34 @@
+{
+ "usb": {
+ "pid": "0x0AA3",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true,
+ "encoder": false
+ },
+ "indicators": {
+ "num_lock": "B2"
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k10_max/ansi/white/keymaps/default/keymap.c b/keyboards/keychron/k10_max/ansi/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..53b211b577
--- /dev/null
+++ b/keyboards/keychron/k10_max/ansi/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_108(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, BL_STEP, KC_F13, KC_F14, KC_F15, KC_F16,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [MAC_FN] = LAYOUT_ansi_108(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_108(
+ 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_CTANA, BL_STEP, _______, _______, _______, _______,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [WIN_FN] = LAYOUT_ansi_108(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k10_max/ansi/white/rules.mk b/keyboards/keychron/k10_max/ansi/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k10_max/ansi/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k10_max/ansi/white/white.c b/keyboards/keychron/k10_max/ansi/white/white.c
new file mode 100644
index 0000000000..7d8b80645c
--- /dev/null
+++ b/keyboards/keychron/k10_max/ansi/white/white.c
@@ -0,0 +1,172 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA16},
+ {0, CB1_CA14},
+ {0, CB1_CA13},
+ {0, CB1_CA12},
+ {0, CB1_CA11},
+ {0, CB1_CA10},
+ {0, CB1_CA9},
+ {0, CB1_CA8},
+ {0, CB1_CA7},
+ {0, CB1_CA6},
+ {0, CB1_CA5},
+ {0, CB1_CA4},
+ {0, CB1_CA3},
+ {0, CB1_CA2},
+ {0, CB1_CA1},
+ {0, CB7_CA1},
+ {0, CB7_CA2},
+ {0, CB7_CA3},
+ {0, CB7_CA4},
+
+ {0, CB2_CA16},
+ {0, CB2_CA15},
+ {0, CB2_CA14},
+ {0, CB2_CA13},
+ {0, CB2_CA12},
+ {0, CB2_CA11},
+ {0, CB2_CA10},
+ {0, CB2_CA9},
+ {0, CB2_CA8},
+ {0, CB2_CA7},
+ {0, CB2_CA6},
+ {0, CB2_CA5},
+ {0, CB2_CA4},
+ {0, CB2_CA3},
+ {0, CB2_CA2},
+ {0, CB2_CA1},
+ {0, CB8_CA1},
+ {0, CB8_CA2},
+ {0, CB8_CA3},
+ {0, CB8_CA4},
+
+ {0, CB3_CA16},
+ {0, CB3_CA15},
+ {0, CB3_CA14},
+ {0, CB3_CA13},
+ {0, CB3_CA12},
+ {0, CB3_CA11},
+ {0, CB3_CA10},
+ {0, CB3_CA9},
+ {0, CB3_CA8},
+ {0, CB3_CA7},
+ {0, CB3_CA6},
+ {0, CB3_CA5},
+ {0, CB3_CA4},
+ {0, CB3_CA3},
+ {0, CB3_CA2},
+ {0, CB3_CA1},
+ {0, CB7_CA6},
+ {0, CB7_CA7},
+ {0, CB7_CA8},
+ {0, CB7_CA9},
+
+ {0, CB4_CA16},
+ {0, CB4_CA15},
+ {0, CB4_CA14},
+ {0, CB4_CA13},
+ {0, CB4_CA12},
+ {0, CB4_CA11},
+ {0, CB4_CA10},
+ {0, CB4_CA9},
+ {0, CB4_CA8},
+ {0, CB4_CA7},
+ {0, CB4_CA6},
+ {0, CB4_CA5},
+ {0, CB4_CA4},
+ {0, CB7_CA5},
+ {0, CB8_CA5},
+ {0, CB7_CA10},
+ {0, CB8_CA10},
+ {0, CB8_CA7},
+ {0, CB8_CA8},
+ {0, CB8_CA9},
+
+ {0, CB5_CA16},
+ {0, CB5_CA14},
+ {0, CB5_CA13},
+ {0, CB5_CA12},
+ {0, CB5_CA11},
+ {0, CB5_CA10},
+ {0, CB5_CA9},
+ {0, CB5_CA8},
+ {0, CB5_CA7},
+ {0, CB5_CA6},
+ {0, CB5_CA5},
+ {0, CB5_CA3},
+ {0, CB5_CA1},
+ {0, CB8_CA6},
+ {0, CB8_CA11},
+ {0, CB8_CA12},
+
+ {0, CB6_CA16},
+ {0, CB6_CA15},
+ {0, CB6_CA14},
+ {0, CB6_CA10},
+ {0, CB6_CA6},
+ {0, CB6_CA5},
+ {0, CB6_CA4},
+ {0, CB6_CA3},
+ {0, CB6_CA2},
+ {0, CB6_CA1},
+ {0, CB7_CA13},
+ {0, CB7_CA11},
+ {0, CB7_CA12},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18 },
+ { 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38 },
+ { 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58 },
+ { 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78 },
+ { 79, __, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, __, 90, __, 91, __, 92, 93, 94 },
+ { 95, 96, 97, __, __, __, 98, __, __, __, 99, 100, 101, 102, 103, 104, 105, __, 106, 107 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {21, 0}, {31, 0}, {42, 0}, {52, 0}, {68, 0}, {78, 0}, {89, 0}, {99, 0}, {115, 0}, {125, 0}, {136, 0}, {146, 0}, {159, 0}, {169, 0}, {180, 0}, {193, 0}, {203, 0}, {214, 0},
+ {0,15}, {10,15}, {21,15}, {31,15}, {42,15}, {52,15}, {63,15}, {73,15}, {83,15}, {94,15}, {104,15}, {115,15}, {125,15}, {141,15}, {159,15}, {169,15}, {180,15}, {193,15}, {203,15}, {214,15},
+ {3,27}, {16,27}, {26,27}, {36,27}, {47,27}, {57,27}, {68,27}, {78,27}, {89,27}, {99,27}, {109,27}, {120,27}, {130,27}, {143,27}, {159,27}, {169,27}, {180,27}, {193,27}, {203,27}, {214,27},
+ {4,40}, {18,40}, {29,40}, {39,40}, {50,40}, {60,40}, {70,40}, {81,40}, {91,40}, {102,40},{112,40}, {123,40}, {139,40}, {224, 0}, {224,15}, {224,34}, {224,58}, {193,40}, {203,40}, {214,40},
+ {7,52}, {23,52}, {34,52}, {44,52}, {55,52}, {65,52}, {76,52}, {86,52}, {96,52}, {107,52}, {117,52}, {137,52}, {169,52}, {193,52}, {203,52}, {214,52},
+ {1,64}, {14,64}, {27,64}, {66,64}, {105,64}, {118,64}, {131,64}, {145,64}, {159,64}, {169,64}, {180,64}, {198,64}, {214,64},
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k10_max/board.h b/keyboards/keychron/k10_max/board.h
new file mode 100644
index 0000000000..ec3fc1786a
--- /dev/null
+++ b/keyboards/keychron/k10_max/board.h
@@ -0,0 +1,225 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLDOWN(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLDOWN(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
diff --git a/keyboards/keychron/k10_max/config.h b/keyboards/keychron/k10_max/config.h
new file mode 100644
index 0000000000..f0c0352466
--- /dev/null
+++ b/keyboards/keychron/k10_max/config.h
@@ -0,0 +1,83 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A9
+# define BT_MODE_SELECT_PIN A10
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN C5
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+# define BT_INDICATION_LED_PIN_LIST \
+ { B15, B15, B15 }
+# define BT_INDICATION_LED_ON_STATE 0
+
+# define P24G_HOST_DEVICES_COUNT 1
+# define P24G_INDICATION_LED_PIN_LIST \
+ { B14 }
+
+# if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define P24G_INDICATION_LED_MATRIX_INDEX 23
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 20, 21, 22 }
+# define BAT_LEVEL_LED_LIST \
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/k10_max/halconf.h b/keyboards/keychron/k10_max/halconf.h
new file mode 100644
index 0000000000..4b823aa657
--- /dev/null
+++ b/keyboards/keychron/k10_max/halconf.h
@@ -0,0 +1,28 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/k10_max/info.json b/keyboards/keychron/k10_max/info.json
new file mode 100644
index 0000000000..3c5e7d1d73
--- /dev/null
+++ b/keyboards/keychron/k10_max/info.json
@@ -0,0 +1,281 @@
+{
+ "keyboard_name": "Keychron K10 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "Keychron",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey": true,
+ "mousekey": true,
+ "dip_switch": true,
+ "encoder": false,
+ "encoder_map": false,
+ "nkro": true,
+ "raw": true,
+ "sendstring": true
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch" :{
+ "pins": ["B12"]
+ },
+ "dynamic_keymap": {
+ "layer_count": 4
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "indicators": {
+ "caps_lock": "C9",
+ "on_state": 1
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A13", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "B10"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "layouts": {
+ "LAYOUT_ansi_108": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.5, "y": 0},
+ {"matrix": [0, 10], "x": 11, "y": 0},
+ {"matrix": [0, 11], "x": 12, "y": 0},
+ {"matrix": [0, 12], "x": 13, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+ {"matrix": [0, 15], "x": 16.25, "y": 0},
+ {"matrix": [0, 16], "x": 17.25, "y": 0},
+ {"matrix": [0, 17], "x": 18.5, "y": 0},
+ {"matrix": [0, 18], "x": 19.5, "y": 0},
+ {"matrix": [0, 19], "x": 20.5, "y": 0},
+ {"matrix": [3, 13], "x": 21.5, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 15], "x": 16.25, "y": 1.25},
+ {"matrix": [1, 16], "x": 17.25, "y": 1.25},
+ {"matrix": [1, 17], "x": 18.5, "y": 1.25},
+ {"matrix": [1, 18], "x": 19.5, "y": 1.25},
+ {"matrix": [1, 19], "x": 20.5, "y": 1.25},
+ {"matrix": [3, 14], "x": 21.5, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 13], "x": 13.5, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 16.25, "y": 2.25},
+ {"matrix": [2, 16], "x": 17.25, "y": 2.25},
+ {"matrix": [2, 17], "x": 18.5, "y": 2.25},
+ {"matrix": [2, 18], "x": 19.5, "y": 2.25},
+ {"matrix": [2, 19], "x": 20.5, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 17], "x": 18.5, "y": 3.25},
+ {"matrix": [3, 18], "x": 19.5, "y": 3.25},
+ {"matrix": [3, 19], "x": 20.5, "y": 3.25},
+ {"matrix": [3, 15], "x": 21.5, "y": 2.25, "h": 2},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 12.25, "y": 4.25, "w": 2.75},
+ {"matrix": [4, 15], "x": 16.25, "y": 4.25},
+ {"matrix": [4, 17], "x": 18.5, "y": 4.25},
+ {"matrix": [4, 18], "x": 19.5, "y": 4.25},
+ {"matrix": [4, 19], "x": 20.5, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.25},
+ {"matrix": [5, 15], "x": 16.25, "y": 5.25},
+ {"matrix": [5, 16], "x": 17.25, "y": 5.25},
+ {"matrix": [5, 18], "x": 18.5, "y": 5.25, "w": 2},
+ {"matrix": [5, 19], "x": 20.5, "y": 5.25},
+ {"matrix": [3, 16], "x": 21.5, "y": 4.25, "h": 2}
+ ]
+ },
+ "LAYOUT_iso_109": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.5, "y": 0},
+ {"matrix": [0, 10], "x": 11, "y": 0},
+ {"matrix": [0, 11], "x": 12, "y": 0},
+ {"matrix": [0, 12], "x": 13, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+ {"matrix": [0, 15], "x": 16.25, "y": 0},
+ {"matrix": [0, 16], "x": 17.25, "y": 0},
+ {"matrix": [0, 17], "x": 18.5, "y": 0},
+ {"matrix": [0, 18], "x": 19.5, "y": 0},
+ {"matrix": [0, 19], "x": 20.5, "y": 0},
+ {"matrix": [3, 13], "x": 21.5, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 15], "x": 16.25, "y": 1.25},
+ {"matrix": [1, 16], "x": 17.25, "y": 1.25},
+ {"matrix": [1, 17], "x": 18.5, "y": 1.25},
+ {"matrix": [1, 18], "x": 19.5, "y": 1.25},
+ {"matrix": [1, 19], "x": 20.5, "y": 1.25},
+ {"matrix": [3, 14], "x": 21.5, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 16.25, "y": 2.25},
+ {"matrix": [2, 16], "x": 17.25, "y": 2.25},
+ {"matrix": [2, 17], "x": 18.5, "y": 2.25},
+ {"matrix": [2, 18], "x": 19.5, "y": 2.25},
+ {"matrix": [2, 19], "x": 20.5, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25},
+ {"matrix": [2, 13], "x": 13.75, "y": 2.25, "w": 1.25, "h": 2},
+ {"matrix": [3, 17], "x": 18.5, "y": 3.25},
+ {"matrix": [3, 18], "x": 19.5, "y": 3.25},
+ {"matrix": [3, 19], "x": 20.5, "y": 3.25},
+ {"matrix": [3, 15], "x": 21.5, "y": 2.25, "h": 2},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 12.25, "y": 4.25, "w": 2.75},
+ {"matrix": [4, 15], "x": 16.25, "y": 4.25},
+ {"matrix": [4, 17], "x": 18.5, "y": 4.25},
+ {"matrix": [4, 18], "x": 19.5, "y": 4.25},
+ {"matrix": [4, 19], "x": 20.5, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.25},
+ {"matrix": [5, 15], "x": 16.25, "y": 5.25},
+ {"matrix": [5, 16], "x": 17.25, "y": 5.25},
+ {"matrix": [5, 18], "x": 18.5, "y": 5.25, "w": 2},
+ {"matrix": [5, 19], "x": 20.5, "y": 5.25},
+ {"matrix": [3, 16], "x": 21.5, "y": 4.25, "h": 2}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/k10_max/iso/rgb/config.h b/keyboards/keychron/k10_max/iso/rgb/config.h
new file mode 100644
index 0000000000..55df745208
--- /dev/null
+++ b/keyboards/keychron/k10_max/iso/rgb/config.h
@@ -0,0 +1,43 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 109
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define NUM_LOCK_INDEX 36
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k10_max/iso/rgb/keyboard.json b/keyboards/keychron/k10_max/iso/rgb/keyboard.json
new file mode 100644
index 0000000000..ecb4228294
--- /dev/null
+++ b/keyboards/keychron/k10_max/iso/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0AA1",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k10_max/iso/rgb/keymaps/default/keymap.c b/keyboards/keychron/k10_max/iso/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..1f50373d89
--- /dev/null
+++ b/keyboards/keychron/k10_max/iso/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_109(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, RGB_MOD, KC_F13, KC_F14, KC_F15, KC_F16,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [MAC_FN] = LAYOUT_iso_109(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_109(
+ 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_CTANA, RGB_MOD, _______, _______, _______, _______,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [WIN_FN] = LAYOUT_iso_109(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k10_max/iso/rgb/rgb.c b/keyboards/keychron/k10_max/iso/rgb/rgb.c
new file mode 100644
index 0000000000..5ce7babb10
--- /dev/null
+++ b/keyboards/keychron/k10_max/iso/rgb/rgb.c
@@ -0,0 +1,176 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB10_CA6, CB12_CA6, CB11_CA6},
+ {1, CB10_CA5, CB12_CA5, CB11_CA5},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to RGB Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18 },
+ { 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38 },
+ { 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58 },
+ { 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78 },
+ { 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, __, 91, __, 92, __, 93, 94, 95 },
+ { 96, 97, 98, __, __, __, 99, __, __, __, 100, 101, 102, 103, 104, 105, 106, __, 107, 108 },
+ },
+ {
+ // RGB Index to Physical Position
+ {0, 0}, {21, 0}, {31, 0}, {42, 0}, {52, 0}, {68, 0}, {78, 0}, {89, 0}, {99, 0}, {115, 0}, {125, 0}, {136, 0}, {146, 0}, {159, 0}, {169, 0}, {180, 0}, {193, 0}, {203, 0}, {214, 0},
+ {0,15}, {10,15}, {21,15}, {31,15}, {42,15}, {52,15}, {63,15}, {73,15}, {83,15}, {94,15}, {104,15}, {115,15}, {125,15}, {141,15}, {159,15}, {169,15}, {180,15}, {193,15}, {203,15}, {214,15},
+ {3,27}, {16,27}, {26,27}, {36,27}, {47,27}, {57,27}, {68,27}, {78,27}, {89,27}, {99,27}, {109,27}, {120,27}, {130,27}, {143,33}, {159,27}, {169,27}, {180,27}, {193,27}, {203,27}, {214,27},
+ {4,40}, {18,40}, {29,40}, {39,40}, {50,40}, {60,40}, {70,40}, {81,40}, {91,40}, {102,40},{112,40}, {123,40}, {134,40}, {224, 0}, {224,15}, {224,34}, {224,58}, {193,40}, {203,40}, {214,40},
+ {1,52}, {13,52}, {23,52}, {34,52}, {44,52}, {55,52}, {65,52}, {76,52}, {86,52}, {96,52}, {107,52}, {117,52}, {137,52}, {169,52}, {193,52}, {203,52}, {214,52},
+ {1,64}, {14,64}, {27,64}, {66,64}, {105,64}, {118,64}, {131,64}, {145,64}, {159,64}, {169,64}, {180,64}, {198,64}, {214,64},
+ },
+ {
+ // RGB Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k10_max/iso/rgb/rules.mk b/keyboards/keychron/k10_max/iso/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k10_max/iso/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k10_max/iso/white/config.h b/keyboards/keychron/k10_max/iso/white/config.h
new file mode 100644
index 0000000000..a29cc783a7
--- /dev/null
+++ b/keyboards/keychron/k10_max/iso/white/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 109
+# define LED_MATRIX_VAL_STEP 16
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 9 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x56, 0x56, 0x56, 0x56, 0x56, 0x56, 0x56, 0x56, 0x56, 0x56, 0x56, 0x56 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Low battery indicating led */
+# define DIM_NUM_LOCK
+# define NUM_LOCK_INDEX 36
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k10_max/iso/white/keyboard.json b/keyboards/keychron/k10_max/iso/white/keyboard.json
new file mode 100644
index 0000000000..3ce478c3ec
--- /dev/null
+++ b/keyboards/keychron/k10_max/iso/white/keyboard.json
@@ -0,0 +1,33 @@
+{
+ "usb": {
+ "pid": "0x0AA4",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "indicators": {
+ "num_lock": "B2"
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k10_max/iso/white/keymaps/default/keymap.c b/keyboards/keychron/k10_max/iso/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..9873b3f051
--- /dev/null
+++ b/keyboards/keychron/k10_max/iso/white/keymaps/default/keymap.c
@@ -0,0 +1,68 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_109(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, BL_STEP, KC_F13, KC_F14, KC_F15, KC_F16,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [MAC_FN] = LAYOUT_iso_109(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_109(
+ 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_CTANA, BL_STEP, _______, _______, _______, _______,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [WIN_FN] = LAYOUT_iso_109(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
+
diff --git a/keyboards/keychron/k10_max/iso/white/rules.mk b/keyboards/keychron/k10_max/iso/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k10_max/iso/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k10_max/iso/white/white.c b/keyboards/keychron/k10_max/iso/white/white.c
new file mode 100644
index 0000000000..147bfcad73
--- /dev/null
+++ b/keyboards/keychron/k10_max/iso/white/white.c
@@ -0,0 +1,173 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA16},
+ {0, CB1_CA14},
+ {0, CB1_CA13},
+ {0, CB1_CA12},
+ {0, CB1_CA11},
+ {0, CB1_CA10},
+ {0, CB1_CA9},
+ {0, CB1_CA8},
+ {0, CB1_CA7},
+ {0, CB1_CA6},
+ {0, CB1_CA5},
+ {0, CB1_CA4},
+ {0, CB1_CA3},
+ {0, CB1_CA2},
+ {0, CB1_CA1},
+ {0, CB7_CA1},
+ {0, CB7_CA2},
+ {0, CB7_CA3},
+ {0, CB7_CA4},
+
+ {0, CB2_CA16},
+ {0, CB2_CA15},
+ {0, CB2_CA14},
+ {0, CB2_CA13},
+ {0, CB2_CA12},
+ {0, CB2_CA11},
+ {0, CB2_CA10},
+ {0, CB2_CA9},
+ {0, CB2_CA8},
+ {0, CB2_CA7},
+ {0, CB2_CA6},
+ {0, CB2_CA5},
+ {0, CB2_CA4},
+ {0, CB2_CA3},
+ {0, CB2_CA2},
+ {0, CB2_CA1},
+ {0, CB8_CA1},
+ {0, CB8_CA2},
+ {0, CB8_CA3},
+ {0, CB8_CA4},
+
+ {0, CB3_CA16},
+ {0, CB3_CA15},
+ {0, CB3_CA14},
+ {0, CB3_CA13},
+ {0, CB3_CA12},
+ {0, CB3_CA11},
+ {0, CB3_CA10},
+ {0, CB3_CA9},
+ {0, CB3_CA8},
+ {0, CB3_CA7},
+ {0, CB3_CA6},
+ {0, CB3_CA5},
+ {0, CB3_CA4},
+ {0, CB3_CA3},
+ {0, CB3_CA2},
+ {0, CB3_CA1},
+ {0, CB7_CA6},
+ {0, CB7_CA7},
+ {0, CB7_CA8},
+ {0, CB7_CA9},
+
+ {0, CB4_CA16},
+ {0, CB4_CA15},
+ {0, CB4_CA14},
+ {0, CB4_CA13},
+ {0, CB4_CA12},
+ {0, CB4_CA11},
+ {0, CB4_CA10},
+ {0, CB4_CA9},
+ {0, CB4_CA8},
+ {0, CB4_CA7},
+ {0, CB4_CA6},
+ {0, CB4_CA5},
+ {0, CB4_CA4},
+ {0, CB7_CA5},
+ {0, CB8_CA5},
+ {0, CB7_CA10},
+ {0, CB8_CA10},
+ {0, CB8_CA7},
+ {0, CB8_CA8},
+ {0, CB8_CA9},
+
+ {0, CB5_CA16},
+ {0, CB5_CA15},
+ {0, CB5_CA14},
+ {0, CB5_CA13},
+ {0, CB5_CA12},
+ {0, CB5_CA11},
+ {0, CB5_CA10},
+ {0, CB5_CA9},
+ {0, CB5_CA8},
+ {0, CB5_CA7},
+ {0, CB5_CA6},
+ {0, CB5_CA5},
+ {0, CB5_CA3},
+ {0, CB5_CA1},
+ {0, CB8_CA6},
+ {0, CB8_CA11},
+ {0, CB8_CA12},
+
+ {0, CB6_CA16},
+ {0, CB6_CA15},
+ {0, CB6_CA14},
+ {0, CB6_CA10},
+ {0, CB6_CA6},
+ {0, CB6_CA5},
+ {0, CB6_CA4},
+ {0, CB6_CA3},
+ {0, CB6_CA2},
+ {0, CB6_CA1},
+ {0, CB7_CA13},
+ {0, CB7_CA11},
+ {0, CB7_CA12},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18 },
+ { 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38 },
+ { 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58 },
+ { 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78 },
+ { 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, __, 91, __, 92, __, 93, 94, 95 },
+ { 96, 97, 98, __, __, __, 99, __, __, __, 100, 101, 102, 103, 104, 105, 106, __, 107, 108 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {21, 0}, {31, 0}, {42, 0}, {52, 0}, {68, 0}, {78, 0}, {89, 0}, {99, 0}, {115, 0}, {125, 0}, {136, 0}, {146, 0}, {159, 0}, {169, 0}, {180, 0}, {193, 0}, {203, 0}, {214, 0},
+ {0,15}, {10,15}, {21,15}, {31,15}, {42,15}, {52,15}, {63,15}, {73,15}, {83,15}, {94,15}, {104,15}, {115,15}, {125,15}, {141,15}, {159,15}, {169,15}, {180,15}, {193,15}, {203,15}, {214,15},
+ {3,27}, {16,27}, {26,27}, {36,27}, {47,27}, {57,27}, {68,27}, {78,27}, {89,27}, {99,27}, {109,27}, {120,27}, {130,27}, {143,33}, {159,27}, {169,27}, {180,27}, {193,27}, {203,27}, {214,27},
+ {4,40}, {18,40}, {29,40}, {39,40}, {50,40}, {60,40}, {70,40}, {81,40}, {91,40}, {102,40},{112,40}, {123,40}, {134,40}, {224, 0}, {224,15}, {224,34}, {224,58}, {193,40}, {203,40}, {214,40},
+ {1,52}, {13,52}, {23,52}, {34,52}, {44,52}, {55,52}, {65,52}, {76,52}, {86,52}, {96,52}, {107,52}, {117,52}, {137,52}, {169,52}, {193,52}, {203,52}, {214,52},
+ {1,64}, {14,64}, {27,64}, {66,64}, {105,64}, {118,64}, {131,64}, {145,64}, {159,64}, {169,64}, {180,64}, {198,64}, {214,64},
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k10_max/k10_max.c b/keyboards/keychron/k10_max/k10_max.c
new file mode 100644
index 0000000000..878a0ba189
--- /dev/null
+++ b/keyboards/keychron/k10_max/k10_max.c
@@ -0,0 +1,96 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "transport.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef LK_WIRELESS_ENABLE
+pin_t bt_led_pins[] = BT_INDICATION_LED_PIN_LIST;
+pin_t p24g_led_pins[] = P24G_INDICATION_LED_PIN_LIST;
+#endif
+
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 2));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+ if (!host_keyboard_led_state().caps_lock) gpio_write_pin(LED_CAPS_LOCK_PIN, !LED_PIN_ON_STATE);
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+ for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(bt_led_pins[i], 1);
+ for (uint8_t i = 0; i < sizeof(p24g_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(p24g_led_pins[i], 1);
+#endif
+
+ } else {
+ gpio_write_pin(LED_CAPS_LOCK_PIN, LED_PIN_ON_STATE);
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+ if (get_transport() != TRANSPORT_P2P4)
+ for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(bt_led_pins[i], 0);
+ if (get_transport() != TRANSPORT_BLUETOOTH)
+ for (uint8_t i = 0; i < sizeof(p24g_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(p24g_led_pins[i], 0);
+#endif
+ }
+ }
+
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/k10_max/mcuconf.h b/keyboards/keychron/k10_max/mcuconf.h
new file mode 100644
index 0000000000..a616c82cdf
--- /dev/null
+++ b/keyboards/keychron/k10_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/k10_max/readme.md b/keyboards/keychron/k10_max/readme.md
new file mode 100644
index 0000000000..263d3985e7
--- /dev/null
+++ b/keyboards/keychron/k10_max/readme.md
@@ -0,0 +1,29 @@
+# Keychron K10 Max
+
+
+
+A customizable 108 keys TKL keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron K10 Max
+* Hardware Availability: [Keychron K10 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-k10-max-qmk-wireless-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/k10_max/ansi/rgb:default
+ make keychron/k10_max/ansi/white:default
+
+ make keychron/k10_max/iso/rgb:default
+ make keychron/k10_max/iso/white:default
+
+Flashing example for this keyboard:
+
+ make keychron/k10_max/ansi/rgb:default:flash
+ make keychron/k10_max/ansi/white:default:flash
+
+ make keychron/k10_max/iso/rgb:default:flash
+ make keychron/k10_max/iso/white:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/k10_max/rules.mk b/keyboards/keychron/k10_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/k10_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/k10_max/via_json/k10_max_ansi_rgb.json b/keyboards/keychron/k10_max/via_json/k10_max_ansi_rgb.json
new file mode 100644
index 0000000000..e975bcfbc3
--- /dev/null
+++ b/keyboards/keychron/k10_max/via_json/k10_max_ansi_rgb.json
@@ -0,0 +1,345 @@
+{
+ "name": "Keychron K10 Max ANSI RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0AA0",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 20},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#aaaaaa"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 17",
+ "0, 18",
+ "0, 19",
+ "3, 13"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "1, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#cccccc"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 17",
+ "1, 18",
+ "1, 19",
+ "3, 14"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#cccccc"
+ },
+ "2, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#cccccc"
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "2, 17",
+ "2, 18",
+ "2, 19",
+ {
+ "h": 2,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#cccccc"
+ },
+ "3, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 12",
+ {
+ "x": 3.5,
+ "c": "#aaaaaa"
+ },
+ "3, 17",
+ "3, 18",
+ "3, 19"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#cccccc"
+ },
+ "4, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#cccccc"
+ },
+ "4, 13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 15",
+ {
+ "x": 1.25
+ },
+ "4, 17",
+ "4, 18",
+ "4, 19",
+ {
+ "h": 2
+ },
+ "3, 16"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#aaaaaa"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16",
+ {
+ "x": 0.25,
+ "w": 2
+ },
+ "5, 18",
+ "5, 19"
+ ]
+ ]
+ }
+ }
\ No newline at end of file
diff --git a/keyboards/keychron/k10_max/via_json/k10_max_ansi_white.json b/keyboards/keychron/k10_max/via_json/k10_max_ansi_white.json
new file mode 100644
index 0000000000..12c8422dc1
--- /dev/null
+++ b/keyboards/keychron/k10_max/via_json/k10_max_ansi_white.json
@@ -0,0 +1,284 @@
+{
+ "name": "Keychron K10 Max ANSI White",
+ "vendorId": "0x3434",
+ "productId": "0x0AA3",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 20},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#aaaaaa"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 17",
+ "0, 18",
+ "0, 19",
+ "3, 13"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "1, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#cccccc"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 17",
+ "1, 18",
+ "1, 19",
+ "3, 14"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#cccccc"
+ },
+ "2, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#cccccc"
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "2, 17",
+ "2, 18",
+ "2, 19",
+ {
+ "h": 2,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#cccccc"
+ },
+ "3, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 12",
+ {
+ "x": 3.5,
+ "c": "#aaaaaa"
+ },
+ "3, 17",
+ "3, 18",
+ "3, 19"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#cccccc"
+ },
+ "4, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#cccccc"
+ },
+ "4, 13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 15",
+ {
+ "x": 1.25
+ },
+ "4, 17",
+ "4, 18",
+ "4, 19",
+ {
+ "h": 2
+ },
+ "3, 16"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#aaaaaa"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16",
+ {
+ "x": 0.25,
+ "w": 2
+ },
+ "5, 18",
+ "5, 19"
+ ]
+ ]
+ }
+ }
\ No newline at end of file
diff --git a/keyboards/keychron/k10_max/via_json/k10_max_iso_rgb.json b/keyboards/keychron/k10_max/via_json/k10_max_iso_rgb.json
new file mode 100644
index 0000000000..8b09edb2a5
--- /dev/null
+++ b/keyboards/keychron/k10_max/via_json/k10_max_iso_rgb.json
@@ -0,0 +1,347 @@
+{
+ "name": "Keychron K10 Max ISO RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0AA1",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 20},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#aaaaaa"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 17",
+ "0, 18",
+ "0, 19",
+ "3, 13"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "1, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#cccccc"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 17",
+ "1, 18",
+ "1, 19",
+ "3, 14"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#cccccc"
+ },
+ "2, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "c": "#cccccc",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "2, 17",
+ "2, 18",
+ "2, 19",
+ {
+ "h": 2,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#cccccc"
+ },
+ "3, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 12",
+ {
+ "x": 4.75,
+ "c": "#aaaaaa"
+ },
+ "3, 17",
+ "3, 18",
+ "3, 19"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "4, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 1",
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#cccccc"
+ },
+ "4, 13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 15",
+ {
+ "x": 1.25
+ },
+ "4, 17",
+ "4, 18",
+ "4, 19",
+ {
+ "h": 2
+ },
+ "3, 16"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#aaaaaa"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16",
+ {
+ "x": 0.25,
+ "w": 2
+ },
+ "5, 18",
+ "5, 19"
+ ]
+ ]
+ }
+ }
\ No newline at end of file
diff --git a/keyboards/keychron/k10_max/via_json/k10_max_iso_white.json b/keyboards/keychron/k10_max/via_json/k10_max_iso_white.json
new file mode 100644
index 0000000000..616914f362
--- /dev/null
+++ b/keyboards/keychron/k10_max/via_json/k10_max_iso_white.json
@@ -0,0 +1,286 @@
+{
+ "name": "Keychron K10 Max ISO White",
+ "vendorId": "0x3434",
+ "productId": "0x0AA4",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 20},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#aaaaaa"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 17",
+ "0, 18",
+ "0, 19",
+ "3, 13"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "1, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#cccccc"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 17",
+ "1, 18",
+ "1, 19",
+ "3, 14"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#cccccc"
+ },
+ "2, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "c": "#cccccc",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "2, 17",
+ "2, 18",
+ "2, 19",
+ {
+ "h": 2,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#cccccc"
+ },
+ "3, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 12",
+ {
+ "x": 4.75,
+ "c": "#aaaaaa"
+ },
+ "3, 17",
+ "3, 18",
+ "3, 19"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "4, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 1",
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#cccccc"
+ },
+ "4, 13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 15",
+ {
+ "x": 1.25
+ },
+ "4, 17",
+ "4, 18",
+ "4, 19",
+ {
+ "h": 2
+ },
+ "3, 16"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#aaaaaa"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16",
+ {
+ "x": 0.25,
+ "w": 2
+ },
+ "5, 18",
+ "5, 19"
+ ]
+ ]
+ }
+ }
\ No newline at end of file
diff --git a/keyboards/keychron/k11_max/ansi_encoder/rgb/config.h b/keyboards/keychron/k11_max/ansi_encoder/rgb/config.h
new file mode 100644
index 0000000000..f3b4801be7
--- /dev/null
+++ b/keyboards/keychron/k11_max/ansi_encoder/rgb/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 68
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 29
+# define LOW_BAT_IND_INDEX \
+ { 60, 63 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k11_max/ansi_encoder/rgb/keyboard.json b/keyboards/keychron/k11_max/ansi_encoder/rgb/keyboard.json
new file mode 100644
index 0000000000..3bf519bb46
--- /dev/null
+++ b/keyboards/keychron/k11_max/ansi_encoder/rgb/keyboard.json
@@ -0,0 +1,45 @@
+{
+ "usb": {
+ "pid": "0x0AB3",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true,
+ "encoder": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "A8",
+ "pin_b": "C9"
+ }
+ ]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k11_max/ansi_encoder/rgb/keymaps/default/keymap.c b/keyboards/keychron/k11_max/ansi_encoder/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..04f1767750
--- /dev/null
+++ b/keyboards/keychron/k11_max/ansi_encoder/rgb/keymaps/default/keymap.c
@@ -0,0 +1,82 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_69_ansi(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN1), MO(FN2), KC_SPC, KC_RCMMD, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_BASE] = LAYOUT_69_ansi(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN1), MO(FN2), KC_SPC, KC_RALT, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN1] = LAYOUT_69_ansi(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD,RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_INS,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, NK_TOGG, _______, _______, _______, _______, _______, KC_PGUP,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_PGDN, _______),
+
+ [WIN_FN1] = LAYOUT_69_ansi(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_INS,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, NK_TOGG, _______, _______, _______, _______, _______, KC_PGUP,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_PGDN, _______),
+
+ [FN2] = LAYOUT_69_ansi(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+ const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN1] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_FN1] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [FN2] = {ENCODER_CCW_CW(_______, _______)},
+ };
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k11_max/ansi_encoder/rgb/rgb.c b/keyboards/keychron/k11_max/ansi_encoder/rgb/rgb.c
new file mode 100644
index 0000000000..bb879b8667
--- /dev/null
+++ b/keyboards/keychron/k11_max/ansi_encoder/rgb/rgb.c
@@ -0,0 +1,131 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t PROGMEM g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA8, CB4_CA8, CB5_CA8},
+ {1, CB6_CA10, CB4_CA10, CB5_CA10},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, __, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, __, 41, __, 42 },
+ { 43, __, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, __, 54, 55, 56 },
+ { 57, 58, 59, __, __, 60, 61, 62, __, 63, __, __, 64, 65, 66, 67 },
+ },
+ {
+ // LED Index to Physical Position
+ {8, 1}, {20, 1}, {33, 0}, {48, 3}, {61, 6}, {74, 8}, {87,11}, {106,11}, {119, 8}, {132, 6}, {145, 3}, {160, 0}, {173, 1}, {193, 1},
+ {8,14}, {24,14}, {39,14}, {52,17}, {65,20}, {78,22}, {103,25},{116,22}, {129,20}, {142,17}, {155,14}, {170,14}, {183,14}, {200,14}, {222,14},
+ {8,27}, {24,27}, {39,28}, {52,30}, {65,33}, {78,36}, {109,37},{122,34}, {135,32}, {148,29}, {162,27}, {176,27}, {197,27}, {224,27},
+ {8,40}, {28,40}, {43,42}, {56,44}, {69,47}, {82,50}, {102,52}, {115,49}, {128,46}, {141,44}, {154,44}, {169,40}, {189,40}, {209,43},
+ {0,53}, {16,53}, {42,55}, {65,60}, {86,64}, {107,64}, {131,59}, {156,54}, {196,56}, {209,56}, {222,56},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/k11_max/ansi_encoder/rgb/rules.mk b/keyboards/keychron/k11_max/ansi_encoder/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k11_max/ansi_encoder/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k11_max/ansi_encoder/white/config.h b/keyboards/keychron/k11_max/ansi_encoder/white/config.h
new file mode 100644
index 0000000000..a923580dde
--- /dev/null
+++ b/keyboards/keychron/k11_max/ansi_encoder/white/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 68
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 29
+# define LOW_BAT_IND_INDEX \
+ { 60, 63 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k11_max/ansi_encoder/white/keyboard.json b/keyboards/keychron/k11_max/ansi_encoder/white/keyboard.json
new file mode 100644
index 0000000000..6e904cac72
--- /dev/null
+++ b/keyboards/keychron/k11_max/ansi_encoder/white/keyboard.json
@@ -0,0 +1,39 @@
+{
+ "usb": {
+ "pid": "0x0AB9",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true,
+ "encoder": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "A8",
+ "pin_b": "C9"
+ }
+ ]
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k11_max/ansi_encoder/white/keymaps/default/keymap.c b/keyboards/keychron/k11_max/ansi_encoder/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..5ce4d013be
--- /dev/null
+++ b/keyboards/keychron/k11_max/ansi_encoder/white/keymaps/default/keymap.c
@@ -0,0 +1,83 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_69_ansi(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN1), MO(FN2), KC_SPC, KC_RCMMD, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_BASE] = LAYOUT_69_ansi(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN1), MO(FN2), KC_SPC, KC_RALT, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN1] = LAYOUT_69_ansi(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL,KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_INS,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, NK_TOGG, _______, _______, _______, _______, _______, KC_PGUP,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_PGDN, _______),
+
+ [WIN_FN1] = LAYOUT_69_ansi(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_INS,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, NK_TOGG, _______, _______, _______, _______, _______, KC_PGUP,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_PGDN, _______),
+
+ [FN2] = LAYOUT_69_ansi(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN1] = {ENCODER_CCW_CW(BL_DOWN, BL_UP)},
+ [WIN_FN1] = {ENCODER_CCW_CW(BL_DOWN, BL_UP)},
+ [FN2] = {ENCODER_CCW_CW(_______, _______)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
+
diff --git a/keyboards/keychron/k11_max/ansi_encoder/white/rules.mk b/keyboards/keychron/k11_max/ansi_encoder/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k11_max/ansi_encoder/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k11_max/ansi_encoder/white/white.c b/keyboards/keychron/k11_max/ansi_encoder/white/white.c
new file mode 100644
index 0000000000..f7b68956a8
--- /dev/null
+++ b/keyboards/keychron/k11_max/ansi_encoder/white/white.c
@@ -0,0 +1,129 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA14},
+ {0, CB2_CA15},
+ {0, CB2_CA16},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA6},
+ {0, CB1_CA7},
+ {0, CB1_CA8},
+ {0, CB1_CA10},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, __, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, __, 41, __, 42 },
+ { 43, __, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, __, 54, 55, 56 },
+ { 57, 58, 59, __, __, 60, 61, 62, __, 63, __, __, 64, 65, 66, 67 },
+ },
+ {
+ // LED Index to Physical Position
+ {8, 1}, {20, 1}, {33, 0}, {48, 3}, {61, 6}, {74, 8}, {87,11}, {106,11}, {119, 8}, {132, 6}, {145, 3}, {160, 0}, {173, 1}, {193, 1},
+ {8,14}, {24,14}, {39,14}, {52,17}, {65,20}, {78,22}, {103,25},{116,22}, {129,20}, {142,17}, {155,14}, {170,14}, {183,14}, {200,14}, {222,14},
+ {8,27}, {24,27}, {39,28}, {52,30}, {65,33}, {78,36}, {109,37},{122,34}, {135,32}, {148,29}, {162,27}, {176,27}, {197,27}, {224,27},
+ {8,40}, {28,40}, {43,42}, {56,44}, {69,47}, {82,50}, {102,52}, {115,49}, {128,46}, {141,44}, {154,44}, {169,40}, {189,40}, {209,43},
+ {0,53}, {16,53}, {42,55}, {65,60}, {86,64}, {107,64}, {131,59}, {156,54}, {196,56}, {209,56}, {222,56},
+ },
+ {
+ //LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/k11_max/board.h b/keyboards/keychron/k11_max/board.h
new file mode 100644
index 0000000000..eb1aac7713
--- /dev/null
+++ b/keyboards/keychron/k11_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLDOWN(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/k11_max/config.h b/keyboards/keychron/k11_max/config.h
new file mode 100644
index 0000000000..03b55ce67a
--- /dev/null
+++ b/keyboards/keychron/k11_max/config.h
@@ -0,0 +1,80 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+# define P24G_HOST_DEVICES_COUNT 1
+
+# if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 18
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 15, 16, 17 }
+# define BAT_LEVEL_LED_LIST \
+ { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(4)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/k11_max/halconf.h b/keyboards/keychron/k11_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/k11_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/k11_max/info.json b/keyboards/keychron/k11_max/info.json
new file mode 100644
index 0000000000..3e82a7d3d1
--- /dev/null
+++ b/keyboards/keychron/k11_max/info.json
@@ -0,0 +1,202 @@
+{
+ "keyboard_name": "Keychron K11 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey": true,
+ "mousekey": true,
+ "dip_switch": true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro": true,
+ "raw": true,
+ "sendstring": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch": {
+ "pins": ["B14"]
+ },
+ "indicators": {
+ "caps_lock": "A13",
+ "on_state": 1
+ },
+ "dynamic_keymap": {
+ "layer_count": 5
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "layouts": {
+ "LAYOUT_69_ansi": {
+ "layout": [
+ {"matrix":[0, 0], "x":0.75, "y":0.25},
+ {"matrix":[0, 1], "x":1.75, "y":0.25},
+ {"matrix":[0, 2], "x":2.75, "y":0},
+ {"matrix":[0, 3], "x":3.75, "y":0.25},
+ {"matrix":[0, 4], "x":4.75, "y":0.25},
+ {"matrix":[0, 5], "x":5.75, "y":0.25},
+ {"matrix":[0, 6], "x":6.75, "y":0.25},
+ {"matrix":[0, 7], "x":9.5, "y":0.25},
+ {"matrix":[0, 8], "x":10.5, "y":0.25},
+ {"matrix":[0, 9], "x":11.5, "y":0.25},
+ {"matrix":[0,10], "x":12.5, "y":0.25},
+ {"matrix":[0,11], "x":13.5, "y":0},
+ {"matrix":[0,12], "x":14.5, "y":0.25},
+ {"matrix":[0,13], "x":15.5, "y":0.25, "w":2},
+ {"matrix":[0,15], "x":18, "y":0},
+
+ {"matrix":[1, 0], "x":0.5, "y":1.25, "w":1.5},
+ {"matrix":[1, 1], "x":2, "y":1.25},
+ {"matrix":[1, 2], "x":3.25, "y":1.25},
+ {"matrix":[1, 3], "x":4.25, "y":1.25},
+ {"matrix":[1, 4], "x":5.25, "y":1.25},
+ {"matrix":[1, 5], "x":6.25, "y":1.25},
+ {"matrix":[1, 6], "x":9, "y":1.25},
+ {"matrix":[1, 7], "x":10, "y":1.25},
+ {"matrix":[1, 8], "x":11, "y":1.25},
+ {"matrix":[1, 9], "x":12, "y":1.25},
+ {"matrix":[1,10], "x":13.25, "y":1.25},
+ {"matrix":[1,11], "x":14.25, "y":1.25},
+ {"matrix":[1,12], "x":15.25, "y":1.25},
+ {"matrix":[1,13], "x":16.25, "y":1.25, "w":1.5},
+ {"matrix":[1,15], "x":18.25, "y":1.5},
+
+ {"matrix":[2, 0], "x":0.25, "y":2.25, "w":1.75},
+ {"matrix":[2, 1], "x":2, "y":2.25},
+ {"matrix":[2, 2], "x":3.5, "y":2.25},
+ {"matrix":[2, 3], "x":4.5, "y":2.25},
+ {"matrix":[2, 4], "x":5.5, "y":2.25},
+ {"matrix":[2, 5], "x":6.5, "y":2.25},
+ {"matrix":[2, 6], "x":9.5, "y":2.25},
+ {"matrix":[2, 7], "x":10.25, "y":2.25},
+ {"matrix":[2, 8], "x":11.25, "y":2.25},
+ {"matrix":[2, 9], "x":12.25, "y":2.25},
+ {"matrix":[2,10], "x":13.25, "y":2.25},
+ {"matrix":[2,11], "x":14.75, "y":2.25},
+ {"matrix":[2,13], "x":15.75, "y":2.25, "w":2.25},
+ {"matrix":[2,15], "x":18.5, "y":2.5},
+
+ {"matrix":[3, 0], "x":0, "y":3.25, "w":2.25},
+ {"matrix":[3, 2], "x":2.25, "y":3.25},
+ {"matrix":[3, 3], "x":3.75, "y":3.25},
+ {"matrix":[3, 4], "x":4.75, "y":3.25},
+ {"matrix":[3, 5], "x":5.75, "y":3.25},
+ {"matrix":[3, 6], "x":6.75, "y":3.25},
+ {"matrix":[3, 7], "x":8.5, "y":3.25},
+ {"matrix":[3, 8], "x":9.5, "y":3.25},
+ {"matrix":[3, 9], "x":10.5, "y":3.25},
+ {"matrix":[3,10], "x":11.5, "y":3.25},
+ {"matrix":[3,11], "x":12.5, "y":3.25},
+ {"matrix":[3,13], "x":14.25, "y":3.25},
+ {"matrix":[3,14], "x":15.25, "y":3.25, "w":1.75},
+ {"matrix":[3,15], "x":17.25, "y":3.5},
+
+ {"matrix":[4, 0], "x":0, "y":4.25, "w":1.25},
+ {"matrix":[4, 1], "x":1.25, "y":4.25, "w":1.25},
+ {"matrix":[4, 2], "x":3.75, "y":4.25, "w":1.25},
+ {"matrix":[4, 5], "x":5, "y":4.25, "w":2.25},
+ {"matrix":[4, 6], "x":7.25, "y":4.25},
+ {"matrix":[4, 7], "x":8.75, "y":4.25},
+ {"matrix":[4, 9], "x":9.75, "y":4.25, "w":2.75},
+ {"matrix":[4,12], "x":12.5, "y":4.25},
+ {"matrix":[4,13], "x":16.25, "y":4.5},
+ {"matrix":[4,14], "x":17.25, "y":4.5},
+ {"matrix":[4,15], "x":18.25, "y":4.5}
+ ]
+ },
+ "LAYOUT_70_iso": {
+ "layout": [
+ {"matrix":[0, 0], "x":0.75, "y":0.25},
+ {"matrix":[0, 1], "x":1.75, "y":0.25},
+ {"matrix":[0, 2], "x":2.75, "y":0},
+ {"matrix":[0, 3], "x":3.75, "y":0.25},
+ {"matrix":[0, 4], "x":4.75, "y":0.25},
+ {"matrix":[0, 5], "x":5.75, "y":0.25},
+ {"matrix":[0, 6], "x":6.75, "y":0.25},
+ {"matrix":[0, 7], "x":9.5, "y":0.25},
+ {"matrix":[0, 8], "x":10.5, "y":0.25},
+ {"matrix":[0, 9], "x":11.5, "y":0.25},
+ {"matrix":[0,10], "x":12.5, "y":0.25},
+ {"matrix":[0,11], "x":13.5, "y":0},
+ {"matrix":[0,12], "x":14.5, "y":0.25},
+ {"matrix":[0,13], "x":15.5, "y":0.25, "w":2},
+ {"matrix":[0,15], "x":18, "y":0},
+
+ {"matrix":[1, 0], "x":0.5, "y":1.25, "w":1.5},
+ {"matrix":[1, 1], "x":2, "y":1.25},
+ {"matrix":[1, 2], "x":3.25, "y":1.25},
+ {"matrix":[1, 3], "x":4.25, "y":1.25},
+ {"matrix":[1, 4], "x":5.25, "y":1.25},
+ {"matrix":[1, 5], "x":6.25, "y":1.25},
+ {"matrix":[1, 6], "x":9, "y":1.25},
+ {"matrix":[1, 7], "x":10, "y":1.25},
+ {"matrix":[1, 8], "x":11, "y":1.25},
+ {"matrix":[1, 9], "x":12, "y":1.25},
+ {"matrix":[1,10], "x":13.25, "y":1.25},
+ {"matrix":[1,11], "x":14.25, "y":1.25},
+ {"matrix":[1,12], "x":15.25, "y":1.25},
+ {"matrix":[1,15], "x":18.25, "y":1.5},
+
+ {"matrix":[2, 0], "x":0.25, "y":2.25, "w":1.75},
+ {"matrix":[2, 1], "x":2, "y":2.25},
+ {"matrix":[2, 2], "x":3.5, "y":2.25},
+ {"matrix":[2, 3], "x":4.5, "y":2.25},
+ {"matrix":[2, 4], "x":5.5, "y":2.25},
+ {"matrix":[2, 5], "x":6.5, "y":2.25},
+ {"matrix":[2, 6], "x":9.5, "y":2.25},
+ {"matrix":[2, 7], "x":10.25, "y":2.25},
+ {"matrix":[2, 8], "x":11.25, "y":2.25},
+ {"matrix":[2, 9], "x":12.25, "y":2.25},
+ {"matrix":[2,10], "x":13.25, "y":2.25},
+ {"matrix":[2,11], "x":14.75, "y":2.25},
+ {"matrix":[2,13], "x":15.75, "y":2.25},
+ {"matrix":[1,13], "x":16.75, "y":1.25, "w":1.25, "h":2},
+ {"matrix":[2,15], "x":18.5, "y":2.5},
+
+ {"matrix":[3, 0], "x":0, "y":3.25, "w":1.25},
+ {"matrix":[3, 1], "x":2.25, "y":3.25},
+ {"matrix":[3, 2], "x":2.25, "y":3.25},
+ {"matrix":[3, 3], "x":3.75, "y":3.25},
+ {"matrix":[3, 4], "x":4.75, "y":3.25},
+ {"matrix":[3, 5], "x":5.75, "y":3.25},
+ {"matrix":[3, 6], "x":6.75, "y":3.25},
+ {"matrix":[3, 7], "x":8.5, "y":3.25},
+ {"matrix":[3, 8], "x":9.5, "y":3.25},
+ {"matrix":[3, 9], "x":10.5, "y":3.25},
+ {"matrix":[3,10], "x":11.5, "y":3.25},
+ {"matrix":[3,11], "x":12.5, "y":3.25},
+ {"matrix":[3,13], "x":14.25, "y":3.25},
+ {"matrix":[3,14], "x":15.25, "y":3.25, "w":1.75},
+ {"matrix":[3,15], "x":17.25, "y":3.5},
+
+ {"matrix":[4, 0], "x":0, "y":4.25, "w":1.25},
+ {"matrix":[4, 1], "x":1.25, "y":4.25, "w":1.25},
+ {"matrix":[4, 2], "x":3.75, "y":4.25, "w":1.25},
+ {"matrix":[4, 5], "x":5, "y":4.25, "w":2.25},
+ {"matrix":[4, 6], "x":7.25, "y":4.25},
+ {"matrix":[4, 7], "x":8.75, "y":4.25},
+ {"matrix":[4, 9], "x":9.75, "y":4.25, "w":2.75},
+ {"matrix":[4,12], "x":12.5, "y":4.25},
+ {"matrix":[4,13], "x":16.25, "y":4.5},
+ {"matrix":[4,14], "x":17.25, "y":4.5},
+ {"matrix":[4,15], "x":18.25, "y":4.5}
+ ]
+ }
+
+ }
+}
diff --git a/keyboards/keychron/k11_max/iso_encoder/rgb/config.h b/keyboards/keychron/k11_max/iso_encoder/rgb/config.h
new file mode 100644
index 0000000000..0e73537992
--- /dev/null
+++ b/keyboards/keychron/k11_max/iso_encoder/rgb/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 69
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 29
+# define LOW_BAT_IND_INDEX \
+ { 61, 64 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k11_max/iso_encoder/rgb/keyboard.json b/keyboards/keychron/k11_max/iso_encoder/rgb/keyboard.json
new file mode 100644
index 0000000000..8422f7e995
--- /dev/null
+++ b/keyboards/keychron/k11_max/iso_encoder/rgb/keyboard.json
@@ -0,0 +1,45 @@
+{
+ "usb": {
+ "pid": "0x0AB4",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true,
+ "encoder": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "A8",
+ "pin_b": "C9"
+ }
+ ]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k11_max/iso_encoder/rgb/keymaps/default/keymap.c b/keyboards/keychron/k11_max/iso_encoder/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..da1b1c786e
--- /dev/null
+++ b/keyboards/keychron/k11_max/iso_encoder/rgb/keymaps/default/keymap.c
@@ -0,0 +1,82 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_70_iso(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ KC_LSFT, KC_NUBS, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN1), MO(FN2), KC_SPC, KC_RCMMD, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_BASE] = LAYOUT_70_iso(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ KC_LSFT, KC_NUBS, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN1), MO(FN2), KC_SPC, KC_RALT, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN1] = LAYOUT_70_iso(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD,RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, KC_INS,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, NK_TOGG, _______, _______, _______, _______, _______, KC_PGUP,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_PGDN, _______),
+
+ [WIN_FN1] = LAYOUT_70_iso(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, KC_INS,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, NK_TOGG, _______, _______, _______, _______, _______, KC_PGUP,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_PGDN, _______),
+
+ [FN2] = LAYOUT_70_iso(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+ const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN1] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_FN1] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [FN2] = {ENCODER_CCW_CW(_______, _______)},
+ };
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k11_max/iso_encoder/rgb/rgb.c b/keyboards/keychron/k11_max/iso_encoder/rgb/rgb.c
new file mode 100644
index 0000000000..5f6a0cc626
--- /dev/null
+++ b/keyboards/keychron/k11_max/iso_encoder/rgb/rgb.c
@@ -0,0 +1,132 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t PROGMEM g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA2, CB1_CA2, CB2_CA2},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA8, CB4_CA8, CB5_CA8},
+ {1, CB6_CA10, CB4_CA10, CB5_CA10},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, __, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, __, 41, __, 42 },
+ { 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, __, 55, 56, 57 },
+ { 58, 59, 60, __, __, 61, 62, 63, __, 64, __, __, 65, 66, 67, 68 },
+ },
+ {
+ // LED Index to Physical Position
+ {8, 1}, {20, 1}, {33, 0}, {48, 3}, {61, 6}, {74, 8}, {87,11}, {106,11}, {119, 8}, {132, 6}, {145, 3}, {160, 0}, {173, 1}, {193, 1},
+ {8,14}, {24,14}, {39,14}, {52,17}, {65,20}, {78,22}, {103,25},{116,22}, {129,20}, {142,17}, {155,14}, {170,14}, {183,14}, {200,20}, {222,14},
+ {8,27}, {24,27}, {39,28}, {52,30}, {65,33}, {78,36}, {109,37},{122,34}, {135,32}, {148,29}, {162,27}, {176,27}, {190,27}, {224,27},
+ {8,40}, {13,40}, {28,40}, {43,42}, {56,44}, {69,47}, {82,50}, {102,52}, {115,49}, {128,46}, {141,44}, {154,44}, {169,40}, {189,40}, {209,43},
+ {0,53}, {16,53}, {42,55}, {65,60}, {86,64}, {107,64}, {131,59}, {156,54}, {196,56}, {209,56}, {222,56},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/k11_max/iso_encoder/rgb/rules.mk b/keyboards/keychron/k11_max/iso_encoder/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k11_max/iso_encoder/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k11_max/iso_encoder/white/config.h b/keyboards/keychron/k11_max/iso_encoder/white/config.h
new file mode 100644
index 0000000000..813d08b36e
--- /dev/null
+++ b/keyboards/keychron/k11_max/iso_encoder/white/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 69
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 29
+# define LOW_BAT_IND_INDEX \
+ { 61, 64 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k11_max/iso_encoder/white/keyboard.json b/keyboards/keychron/k11_max/iso_encoder/white/keyboard.json
new file mode 100644
index 0000000000..bdd4d9c591
--- /dev/null
+++ b/keyboards/keychron/k11_max/iso_encoder/white/keyboard.json
@@ -0,0 +1,39 @@
+{
+ "usb": {
+ "pid": "0x0ABA",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true,
+ "encoder": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "A8",
+ "pin_b": "C9"
+ }
+ ]
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k11_max/iso_encoder/white/keymaps/default/keymap.c b/keyboards/keychron/k11_max/iso_encoder/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..dc5d65fe2f
--- /dev/null
+++ b/keyboards/keychron/k11_max/iso_encoder/white/keymaps/default/keymap.c
@@ -0,0 +1,83 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_70_iso(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ KC_LSFT, KC_NUBS, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN1), MO(FN2), KC_SPC, KC_RCMMD, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_BASE] = LAYOUT_70_iso(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ KC_LSFT, KC_NUBS, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN1), MO(FN2), KC_SPC, KC_RALT, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN1] = LAYOUT_70_iso(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL,KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, KC_INS,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, BL_DOWN, _______, _______, _______, _______, NK_TOGG, _______, _______, _______, _______, _______, KC_PGUP,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_PGDN, _______),
+
+ [WIN_FN1] = LAYOUT_70_iso(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, KC_INS,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, BL_DOWN, _______, _______, _______, _______, NK_TOGG, _______, _______, _______, _______, _______, KC_PGUP,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_PGDN, _______),
+
+ [FN2] = LAYOUT_70_iso(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN1] = {ENCODER_CCW_CW(BL_DOWN, BL_UP)},
+ [WIN_FN1] = {ENCODER_CCW_CW(BL_DOWN, BL_UP)},
+ [FN2] = {ENCODER_CCW_CW(_______, _______)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
+
diff --git a/keyboards/keychron/k11_max/iso_encoder/white/rules.mk b/keyboards/keychron/k11_max/iso_encoder/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k11_max/iso_encoder/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k11_max/iso_encoder/white/white.c b/keyboards/keychron/k11_max/iso_encoder/white/white.c
new file mode 100644
index 0000000000..c15a9ac0fb
--- /dev/null
+++ b/keyboards/keychron/k11_max/iso_encoder/white/white.c
@@ -0,0 +1,130 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA14},
+ {0, CB2_CA15},
+ {0, CB2_CA16},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA6},
+ {0, CB1_CA7},
+ {0, CB1_CA8},
+ {0, CB1_CA10},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, __, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, __, 41, __, 42 },
+ { 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, __, 55, 56, 57 },
+ { 58, 59, 60, __, __, 61, 62, 63, __, 64, __, __, 65, 66, 67, 68 },
+ },
+ {
+ // LED Index to Physical Position
+ {8, 1}, {20, 1}, {33, 0}, {48, 3}, {61, 6}, {74, 8}, {87,11}, {106,11}, {119, 8}, {132, 6}, {145, 3}, {160, 0}, {173, 1}, {193, 1},
+ {8,14}, {24,14}, {39,14}, {52,17}, {65,20}, {78,22}, {103,25},{116,22}, {129,20}, {142,17}, {155,14}, {170,14}, {183,14}, {200,20}, {222,14},
+ {8,27}, {24,27}, {39,28}, {52,30}, {65,33}, {78,36}, {109,37},{122,34}, {135,32}, {148,29}, {162,27}, {176,27}, {190,27}, {224,27},
+ {8,40}, {13,40}, {28,40}, {43,42}, {56,44}, {69,47}, {82,50}, {102,52}, {115,49}, {128,46}, {141,44}, {154,44}, {169,40}, {189,40}, {209,43},
+ {0,53}, {16,53}, {42,55}, {65,60}, {86,64}, {107,64}, {131,59}, {156,54}, {196,56}, {209,56}, {222,56},
+ },
+ {
+ //LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/k11_max/k11_max.c b/keyboards/keychron/k11_max/k11_max.c
new file mode 100644
index 0000000000..e76b82f0cc
--- /dev/null
+++ b/keyboards/keychron/k11_max/k11_max.c
@@ -0,0 +1,82 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "transport.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 1));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+
+ } else {
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/k11_max/mcuconf.h b/keyboards/keychron/k11_max/mcuconf.h
new file mode 100644
index 0000000000..b0f8da375b
--- /dev/null
+++ b/keyboards/keychron/k11_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/k11_max/readme.md b/keyboards/keychron/k11_max/readme.md
new file mode 100644
index 0000000000..ab41c473e5
--- /dev/null
+++ b/keyboards/keychron/k11_max/readme.md
@@ -0,0 +1,23 @@
+# Keychron K11 Max
+
+
+
+A customizable 75% ergonomic keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron K11 Max
+* Hardware Availability: [Keychron K11 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-k11-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/k11_max/ansi_encoder/rgb:default
+ make keychron/k11_max/ansi_encoder/white:default
+
+Flashing example for this keyboard:
+
+ make keychron/k11_max/ansi_encoder/rgb:default:flash
+ make keychron/k11_max/ansi_encoder/white:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/k11_max/rules.mk b/keyboards/keychron/k11_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/k11_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/k11_max/via_json/k11_max_ansi_rgb_encoder.json b/keyboards/keychron/k11_max/via_json/k11_max_ansi_rgb_encoder.json
new file mode 100644
index 0000000000..1642ae8e38
--- /dev/null
+++ b/keyboards/keychron/k11_max/via_json/k11_max_ansi_rgb_encoder.json
@@ -0,0 +1,350 @@
+{
+ "name": "Keychron K11 Max ANSI RGB Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0AB3",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "x": 2.75
+ },
+ "0,2",
+ {
+ "x": 8.85
+ },
+ "0,11"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 0.75,
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "c": "#cccccc"
+ },
+ "0,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 14.6,
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "0,13",
+ {
+ "x": 0.5
+ },
+ "0,15\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": -1,
+ "x": 13.6,
+ "c": "#cccccc"
+ },
+ "0,12"
+ ],
+ [
+ {
+ "y": -0.15,
+ "x": 0.5,
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 13.3
+ },
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "1,13",
+ {
+ "x": 0.5
+ },
+ "1,15"
+ ],
+ [
+ {
+ "y": -0.15,
+ "x": 0.25,
+ "w": 1.75
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 12.75
+ },
+ "2,10",
+ "2,11",
+ {
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "2,13",
+ {
+ "x": 0.5
+ },
+ "2,15"
+ ],
+ [
+ {
+ "y": -0.15,
+ "w": 2.25
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,2"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 13.4
+ },
+ "3,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,14"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.4,
+ "c": "#cccccc"
+ },
+ "3,15"
+ ],
+ [
+ {
+ "y": -0.4,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "w": 1.25
+ },
+ "4,1"
+ ],
+ [
+ {
+ "y": -0.6,
+ "x": 15.4,
+ "c": "#cccccc"
+ },
+ "4,13",
+ "4,14",
+ "4,15"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -5.7,
+ "x": 3.85,
+ "c": "#cccccc"
+ },
+ "0,3",
+ "0,4",
+ "0,5",
+ "0,6"
+ ],
+ [
+ {
+ "x": 3.35
+ },
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5"
+ ],
+ [
+ {
+ "x": 3.55
+ },
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5"
+ ],
+ [
+ {
+ "x": 3.9
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6"
+ ],
+ [
+ {
+ "x": 3.9,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,2",
+ {
+ "w": 2.25
+ },
+ "4,5",
+ "4,6"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -3.3,
+ "x": 8.35,
+ "c": "#cccccc"
+ },
+ "0,7",
+ "0,8",
+ "0,9",
+ "0,10"
+ ],
+ [
+ {
+ "x": 7.9
+ },
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10"
+ ],
+ [
+ {
+ "x": 8.25
+ },
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9"
+ ],
+ [
+ {
+ "x": 7.8
+ },
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 7.8,
+ "c": "#aaaaaa"
+ },
+ "4,7",
+ {
+ "w": 2.75
+ },
+ "4,9",
+ "4,12"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k11_max/via_json/k11_max_ansi_white_encoder.json b/keyboards/keychron/k11_max/via_json/k11_max_ansi_white_encoder.json
new file mode 100644
index 0000000000..bc381bfa37
--- /dev/null
+++ b/keyboards/keychron/k11_max/via_json/k11_max_ansi_white_encoder.json
@@ -0,0 +1,289 @@
+{
+ "name": "Keychron K11 Max ANSI White Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0AB9",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "x": 2.75
+ },
+ "0,2",
+ {
+ "x": 8.85
+ },
+ "0,11"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 0.75,
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "c": "#cccccc"
+ },
+ "0,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 14.6,
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "0,13",
+ {
+ "x": 0.5
+ },
+ "0,15\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": -1,
+ "x": 13.6,
+ "c": "#cccccc"
+ },
+ "0,12"
+ ],
+ [
+ {
+ "y": -0.15,
+ "x": 0.5,
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 13.3
+ },
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "1,13",
+ {
+ "x": 0.5
+ },
+ "1,15"
+ ],
+ [
+ {
+ "y": -0.15,
+ "x": 0.25,
+ "w": 1.75
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 12.75
+ },
+ "2,10",
+ "2,11",
+ {
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "2,13",
+ {
+ "x": 0.5
+ },
+ "2,15"
+ ],
+ [
+ {
+ "y": -0.15,
+ "w": 2.25
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,2"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 13.4
+ },
+ "3,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,14"
+ ],
+ [
+ {
+ "c": "#cccccc",
+ "y": -0.75,
+ "x": 16.4
+ },
+ "3,15"
+ ],
+ [
+ {
+ "y": -0.4,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "w": 1.25
+ },
+ "4,1"
+ ],
+ [
+ {
+ "y": -0.6,
+ "x": 15.4,
+ "c": "#cccccc"
+ },
+ "4,13",
+ "4,14",
+ "4,15"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -5.7,
+ "x": 3.85,
+ "c": "#cccccc"
+ },
+ "0,3",
+ "0,4",
+ "0,5",
+ "0,6"
+ ],
+ [
+ {
+ "x": 3.35
+ },
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5"
+ ],
+ [
+ {
+ "x": 3.55
+ },
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5"
+ ],
+ [
+ {
+ "x": 3.9
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6"
+ ],
+ [
+ {
+ "x": 3.9,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,2",
+ {
+ "w": 2.25
+ },
+ "4,5",
+ "4,6"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -3.3,
+ "x": 8.35,
+ "c": "#cccccc"
+ },
+ "0,7",
+ "0,8",
+ "0,9",
+ "0,10"
+ ],
+ [
+ {
+ "x": 7.9
+ },
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10"
+ ],
+ [
+ {
+ "x": 8.25
+ },
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9"
+ ],
+ [
+ {
+ "x": 7.8
+ },
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 7.8,
+ "c": "#aaaaaa"
+ },
+ "4,7",
+ {
+ "w": 2.75
+ },
+ "4,9",
+ "4,12"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k11_max/via_json/k11_max_iso_rgb_encoder.json b/keyboards/keychron/k11_max/via_json/k11_max_iso_rgb_encoder.json
new file mode 100644
index 0000000000..04ef61649d
--- /dev/null
+++ b/keyboards/keychron/k11_max/via_json/k11_max_iso_rgb_encoder.json
@@ -0,0 +1,356 @@
+{
+ "name": "Keychron K11 Max ISO RGB Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0AB4",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "x": 2.75
+ },
+ "0,2",
+ {
+ "x": 8.85
+ },
+ "0,11"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 0.75,
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "c": "#cccccc"
+ },
+ "0,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 14.6,
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "0,13",
+ {
+ "x": 0.5
+ },
+ "0,15\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": -1,
+ "x": 13.6,
+ "c": "#cccccc"
+ },
+ "0,12"
+ ],
+ [
+ {
+ "y": -0.15,
+ "x": 0.5,
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 13.5
+ },
+ "1,11",
+ "1,12",
+ {
+ "x": 0.25,
+ "c": "#777777",
+ "w": 1.5,
+ "h": 2,
+ "w2": 1.75,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "1,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1,15"
+ ],
+ [
+ {
+ "y": -0.15,
+ "x": 0.25,
+ "w": 1.75
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 12.75
+ },
+ "2,10",
+ "2,11",
+ {
+ "c": "#aaaaaa"
+ },
+ "2,13",
+ {
+ "x": 1.75
+ },
+ "2,15"
+ ],
+ [
+ {
+ "y": -0.15,
+ "w": 1.25
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 13.4
+ },
+ "3,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,14"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.4,
+ "c": "#cccccc"
+ },
+ "3,15"
+ ],
+ [
+ {
+ "y": -0.4,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "w": 1.25
+ },
+ "4,1"
+ ],
+ [
+ {
+ "y": -0.6,
+ "x": 15.4,
+ "c": "#cccccc"
+ },
+ "4,13",
+ "4,14",
+ "4,15"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -5.7,
+ "x": 3.85,
+ "c": "#cccccc"
+ },
+ "0,3",
+ "0,4",
+ "0,5",
+ "0,6"
+ ],
+ [
+ {
+ "x": 3.35
+ },
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5"
+ ],
+ [
+ {
+ "x": 3.55
+ },
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5"
+ ],
+ [
+ {
+ "x": 3.9
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6"
+ ],
+ [
+ {
+ "x": 3.9,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,2",
+ {
+ "w": 2.25
+ },
+ "4,5",
+ "4,6"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -3.3,
+ "x": 8.35,
+ "c": "#cccccc"
+ },
+ "0,7",
+ "0,8",
+ "0,9",
+ "0,10"
+ ],
+ [
+ {
+ "x": 7.9
+ },
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10"
+ ],
+ [
+ {
+ "x": 8.25
+ },
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9"
+ ],
+ [
+ {
+ "x": 7.8
+ },
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 7.8,
+ "c": "#aaaaaa"
+ },
+ "4,7",
+ {
+ "w": 2.75
+ },
+ "4,9",
+ "4,12"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k11_max/via_json/k11_max_iso_white_encoder.json b/keyboards/keychron/k11_max/via_json/k11_max_iso_white_encoder.json
new file mode 100644
index 0000000000..60747a6da3
--- /dev/null
+++ b/keyboards/keychron/k11_max/via_json/k11_max_iso_white_encoder.json
@@ -0,0 +1,295 @@
+{
+ "name": "Keychron K11 Max ISO White Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0ABA",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "x": 2.75
+ },
+ "0,2",
+ {
+ "x": 8.85
+ },
+ "0,11"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 0.75,
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "c": "#cccccc"
+ },
+ "0,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 14.6,
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "0,13",
+ {
+ "x": 0.5
+ },
+ "0,15\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": -1,
+ "x": 13.6,
+ "c": "#cccccc"
+ },
+ "0,12"
+ ],
+ [
+ {
+ "y": -0.15,
+ "x": 0.5,
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 13.5
+ },
+ "1,11",
+ "1,12",
+ {
+ "x": 0.25,
+ "c": "#777777",
+ "w": 1.5,
+ "h": 2,
+ "w2": 1.75,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "1,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1,15"
+ ],
+ [
+ {
+ "y": -0.15,
+ "x": 0.25,
+ "w": 1.75
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 12.75
+ },
+ "2,10",
+ "2,11",
+ {
+ "c": "#aaaaaa"
+ },
+ "2,13",
+ {
+ "x": 1.75
+ },
+ "2,15"
+ ],
+ [
+ {
+ "y": -0.15,
+ "w": 1.25
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 13.4
+ },
+ "3,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,14"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.4,
+ "c": "#cccccc"
+ },
+ "3,15"
+ ],
+ [
+ {
+ "y": -0.4,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "w": 1.25
+ },
+ "4,1"
+ ],
+ [
+ {
+ "y": -0.6,
+ "x": 15.4,
+ "c": "#cccccc"
+ },
+ "4,13",
+ "4,14",
+ "4,15"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -5.7,
+ "x": 3.85,
+ "c": "#cccccc"
+ },
+ "0,3",
+ "0,4",
+ "0,5",
+ "0,6"
+ ],
+ [
+ {
+ "x": 3.35
+ },
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5"
+ ],
+ [
+ {
+ "x": 3.55
+ },
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5"
+ ],
+ [
+ {
+ "x": 3.9
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6"
+ ],
+ [
+ {
+ "x": 3.9,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,2",
+ {
+ "w": 2.25
+ },
+ "4,5",
+ "4,6"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -3.3,
+ "x": 8.35,
+ "c": "#cccccc"
+ },
+ "0,7",
+ "0,8",
+ "0,9",
+ "0,10"
+ ],
+ [
+ {
+ "x": 7.9
+ },
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10"
+ ],
+ [
+ {
+ "x": 8.25
+ },
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9"
+ ],
+ [
+ {
+ "x": 7.8
+ },
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 7.8,
+ "c": "#aaaaaa"
+ },
+ "4,7",
+ {
+ "w": 2.75
+ },
+ "4,9",
+ "4,12"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k13_max/ansi/rgb/config.h b/keyboards/keychron/k13_max/ansi/rgb/config.h
new file mode 100644
index 0000000000..61cb9ddcab
--- /dev/null
+++ b/keyboards/keychron/k13_max/ansi/rgb/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 90
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define LOW_BAT_IND_INDEX \
+ { 82 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k13_max/ansi/rgb/keyboard.json b/keyboards/keychron/k13_max/ansi/rgb/keyboard.json
new file mode 100644
index 0000000000..ad8cf6b16d
--- /dev/null
+++ b/keyboards/keychron/k13_max/ansi/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0AD0",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k13_max/ansi/rgb/keymaps/default/keymap.c b/keyboards/keychron/k13_max/ansi/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..01e8f36d99
--- /dev/null
+++ b/keyboards/keychron/k13_max/ansi/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_90(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3,
+ 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_DEL, KC_P0, KC_PDOT,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_90(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_NUM, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_90(
+ 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_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3,
+ 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_DEL, KC_P0, KC_PDOT,
+ 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_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_90(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_NUM, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k13_max/ansi/rgb/rgb.c b/keyboards/keychron/k13_max/ansi/rgb/rgb.c
new file mode 100644
index 0000000000..98deeb45ed
--- /dev/null
+++ b/keyboards/keychron/k13_max/ansi/rgb/rgb.c
@@ -0,0 +1,156 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1},
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB6_CA8, CB4_CA8, CB5_CA8},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA15, CB4_CA15, CB5_CA15},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB6_CA9, CB4_CA9, CB5_CA9},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA15, CB7_CA15, CB8_CA15},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB9_CA13, CB7_CA13, CB8_CA13},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, 63, 64, 65 },
+ { 66, __, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, __, 77, __, 78, __ },
+ { 79, 80, 81, __, __, __, 82, __, __, __, 83, 84, 85, 86, 87, 88, 89 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {26, 0}, {39, 0}, {52, 0}, {65, 0}, {85, 0}, { 98, 0}, {111, 0}, {124, 0}, {144, 0}, {157, 0}, {170, 0}, {183, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {13,14}, {26,14}, {39,14}, {52,14}, {65,14}, {79,14}, { 92,14}, {105,14}, {118,14}, {131,14}, {144,14}, {157,14}, {177,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {20,26}, {33,26}, {46,26}, {59,26}, {72,26}, {85,26}, { 98,26}, {111,26}, {124,26}, {138,26}, {151,26}, {164,26}, {180,26}, {198,26}, {211,26}, {224,26},
+ {5,39}, {23,39}, {36,39}, {49,39}, {62,39}, {75,39}, {88,39}, {102,39}, {115,39}, {128,39}, {141,39}, {154,39}, {175,39}, {198,39}, {211,39}, {224,39},
+ {8,51}, {30,51}, {43,51}, {56,51}, {69,51}, {82,51}, { 95,51}, {108,51}, {121,51}, {134,51}, {147,51}, {172,51}, {211,51},
+ {2,64}, {18,64}, {34,64}, {84,64}, {133,64}, {149,64}, {165,64}, {182,64}, {198,64}, {211,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k13_max/ansi/rgb/rules.mk b/keyboards/keychron/k13_max/ansi/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k13_max/ansi/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k13_max/ansi/white/config.h b/keyboards/keychron/k13_max/ansi/white/config.h
new file mode 100644
index 0000000000..23d79b0529
--- /dev/null
+++ b/keyboards/keychron/k13_max/ansi/white/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 90
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Low battery indicating led */
+# define LOW_BAT_IND_INDEX \
+ { 82 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k13_max/ansi/white/keyboard.json b/keyboards/keychron/k13_max/ansi/white/keyboard.json
new file mode 100644
index 0000000000..42e70e0f83
--- /dev/null
+++ b/keyboards/keychron/k13_max/ansi/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0AD3",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k13_max/ansi/white/keymaps/default/keymap.c b/keyboards/keychron/k13_max/ansi/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..cf22ce61c6
--- /dev/null
+++ b/keyboards/keychron/k13_max/ansi/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_90(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3,
+ 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_DEL, KC_P0, KC_PDOT,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_90(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_NUM, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_90(
+ 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_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3,
+ 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_DEL, KC_P0, KC_PDOT,
+ 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_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_90(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_NUM, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k13_max/ansi/white/rules.mk b/keyboards/keychron/k13_max/ansi/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k13_max/ansi/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k13_max/ansi/white/white.c b/keyboards/keychron/k13_max/ansi/white/white.c
new file mode 100644
index 0000000000..1c128e5ddf
--- /dev/null
+++ b/keyboards/keychron/k13_max/ansi/white/white.c
@@ -0,0 +1,154 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA5},
+ {0, CB6_CA6},
+ {0, CB6_CA7},
+ {0, CB6_CA8},
+ {0, CB6_CA9},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+ {0, CB1_CA8},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+ {0, CB1_CA9},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA15},
+ {0, CB4_CA16},
+ {0, CB1_CA6},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+ {0, CB3_CA15},
+ {0, CB3_CA16},
+ {0, CB3_CA13},
+
+ {0, CB2_CA1},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA7},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+ {0, CB2_CA15},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, 63, 64, 65 },
+ { 66, __, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, __, 77, __, 78, __ },
+ { 79, 80, 81, __, __, __, 82, __, __, __, 83, 84, 85, 86, 87, 88, 89 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {26, 0}, {39, 0}, {52, 0}, {65, 0}, {85, 0}, { 98, 0}, {111, 0}, {124, 0}, {144, 0}, {157, 0}, {170, 0}, {183, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {13,14}, {26,14}, {39,14}, {52,14}, {65,14}, {79,14}, { 92,14}, {105,14}, {118,14}, {131,14}, {144,14}, {157,14}, {177,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {20,26}, {33,26}, {46,26}, {59,26}, {72,26}, {85,26}, { 98,26}, {111,26}, {124,26}, {138,26}, {151,26}, {164,26}, {180,26}, {198,26}, {211,26}, {224,26},
+ {5,39}, {23,39}, {36,39}, {49,39}, {62,39}, {75,39}, {88,39}, {102,39}, {115,39}, {128,39}, {141,39}, {154,39}, {175,39}, {198,39}, {211,39}, {224,39},
+ {8,51}, {30,51}, {43,51}, {56,51}, {69,51}, {82,51}, { 95,51}, {108,51}, {121,51}, {134,51}, {147,51}, {172,51}, {211,51},
+ {2,64}, {18,64}, {34,64}, {84,64}, {133,64}, {149,64}, {165,64}, {182,64}, {198,64}, {211,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k13_max/board.h b/keyboards/keychron/k13_max/board.h
new file mode 100644
index 0000000000..eb1aac7713
--- /dev/null
+++ b/keyboards/keychron/k13_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLDOWN(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/k13_max/config.h b/keyboards/keychron/k13_max/config.h
new file mode 100644
index 0000000000..778b2bda5f
--- /dev/null
+++ b/keyboards/keychron/k13_max/config.h
@@ -0,0 +1,86 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# define BT_INDICATION_LED_PIN_LIST \
+ { C9, C9, C9 }
+# define BT_INDICATION_LED_ON_STATE 0
+
+# define P24G_HOST_DEVICES_COUNT 1
+# define P24G_INDICATION_LED_PIN_LIST \
+ { A8 }
+
+# if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+#define BL_TRIG_KEY KC_P5
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/k13_max/halconf.h b/keyboards/keychron/k13_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/k13_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/k13_max/info.json b/keyboards/keychron/k13_max/info.json
new file mode 100644
index 0000000000..a8258a0e52
--- /dev/null
+++ b/keyboards/keychron/k13_max/info.json
@@ -0,0 +1,240 @@
+{
+ "keyboard_name": "Keychron K13 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey": true,
+ "mousekey": true,
+ "dip_switch": true,
+ "nkro": true,
+ "raw": true,
+ "send_string": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch": {
+ "pins": ["B14"]
+ },
+ "indicators": {
+ "caps_lock": "A13",
+ "on_state": 1
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "layouts": {
+ "LAYOUT_ansi_90": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.5, "y": 0},
+ {"matrix": [0, 10], "x": 11, "y": 0},
+ {"matrix": [0, 11], "x": 12, "y": 0},
+ {"matrix": [0, 12], "x": 13, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15, "y": 0},
+ {"matrix": [0, 15], "x": 16, "y": 0},
+ {"matrix": [0, 16], "x": 17, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15, "y": 1.25},
+ {"matrix": [1, 15], "x": 16, "y": 1.25},
+ {"matrix": [1, 16], "x": 17, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 13], "x": 13.5, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 14], "x": 15, "y": 2.25},
+ {"matrix": [2, 15], "x": 16, "y": 2.25},
+ {"matrix": [2, 16], "x": 17, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 12.75, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 14], "x": 15, "y": 3.25},
+ {"matrix": [3, 15], "x": 16, "y": 3.25},
+ {"matrix": [3, 16], "x": 17, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 12.25, "y": 4.25, "w": 2.75},
+ {"matrix": [4, 15], "x": 16, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15, "y": 5.25},
+ {"matrix": [5, 15], "x": 16, "y": 5.25},
+ {"matrix": [5, 16], "x": 17, "y": 5.25}
+ ]
+ },
+ "LAYOUT_iso_91": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.5, "y": 0},
+ {"matrix": [0, 10], "x": 11, "y": 0},
+ {"matrix": [0, 11], "x": 12, "y": 0},
+ {"matrix": [0, 12], "x": 13, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15, "y": 0},
+ {"matrix": [0, 15], "x": 16, "y": 0},
+ {"matrix": [0, 16], "x": 17, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15, "y": 1.25},
+ {"matrix": [1, 15], "x": 16, "y": 1.25},
+ {"matrix": [1, 16], "x": 17, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 14], "x": 15, "y": 2.25},
+ {"matrix": [2, 15], "x": 16, "y": 2.25},
+ {"matrix": [2, 16], "x": 17, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 12.75, "y": 3.25},
+ {"matrix": [2, 13], "x": 13.75, "y": 2.25, "w": 1.25, "h": 2},
+ {"matrix": [3, 14], "x": 15, "y": 3.25},
+ {"matrix": [3, 15], "x": 16, "y": 3.25},
+ {"matrix": [3, 16], "x": 17, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 12.25, "y": 4.25, "w": 2.75},
+ {"matrix": [4, 15], "x": 16, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15, "y": 5.25},
+ {"matrix": [5, 15], "x": 16, "y": 5.25},
+ {"matrix": [5, 16], "x": 17, "y": 5.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/k13_max/iso/rgb/config.h b/keyboards/keychron/k13_max/iso/rgb/config.h
new file mode 100644
index 0000000000..8fb8508de3
--- /dev/null
+++ b/keyboards/keychron/k13_max/iso/rgb/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 91
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define LOW_BAT_IND_INDEX \
+ { 83 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k13_max/iso/rgb/keyboard.json b/keyboards/keychron/k13_max/iso/rgb/keyboard.json
new file mode 100644
index 0000000000..2925983ec4
--- /dev/null
+++ b/keyboards/keychron/k13_max/iso/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0AD1",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k13_max/iso/rgb/keymaps/default/keymap.c b/keyboards/keychron/k13_max/iso/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..b328bb893e
--- /dev/null
+++ b/keyboards/keychron/k13_max/iso/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_91(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3,
+ 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_DEL, KC_P0, KC_PDOT,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_91(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_NUM, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_91(
+ 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_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3,
+ 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_DEL, KC_P0, KC_PDOT,
+ 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_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_91(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_NUM, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k13_max/iso/rgb/rgb.c b/keyboards/keychron/k13_max/iso/rgb/rgb.c
new file mode 100644
index 0000000000..3dccb48ee1
--- /dev/null
+++ b/keyboards/keychron/k13_max/iso/rgb/rgb.c
@@ -0,0 +1,157 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1},
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB6_CA8, CB4_CA8, CB5_CA8},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA15, CB4_CA15, CB5_CA15},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB6_CA9, CB4_CA9, CB5_CA9},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA15, CB7_CA15, CB8_CA15},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB9_CA13, CB7_CA13, CB8_CA13},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA2, CB1_CA2, CB2_CA2},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, 63, 64, 65 },
+ { 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, __, 78, __, 79, __ },
+ { 80, 81, 82, __, __, __, 83, __, __, __, 84, 85, 86, 87, 88, 89, 90 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {26, 0}, {39, 0}, {52, 0}, {65, 0}, {85, 0}, { 98, 0}, {111, 0}, {124, 0}, {144, 0}, {157, 0}, {170, 0}, {183, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {13,14}, {26,14}, {39,14}, {52,14}, {65,14}, {79,14}, { 92,14}, {105,14}, {118,14}, {131,14}, {144,14}, {157,14}, {177,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {20,26}, {33,26}, {46,26}, {59,26}, {72,26}, {85,26}, { 98,26}, {111,26}, {124,26}, {138,26}, {151,26}, {164,26}, {180,32}, {198,26}, {211,26}, {224,26},
+ {5,39}, {23,39}, {36,39}, {49,39}, {62,39}, {75,39}, {88,39}, {102,39}, {115,39}, {128,39}, {141,39}, {154,39}, {167,39}, {198,39}, {211,39}, {224,39},
+ {3,51}, {16,51}, {30,51}, {43,51}, {56,51}, {69,51}, {82,51}, { 95,51}, {108,51}, {121,51}, {134,51}, {147,51}, {172,51}, {211,51},
+ {2,64}, {18,64}, {34,64}, {84,64}, {133,64}, {149,64}, {165,64}, {182,64}, {198,64}, {211,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k13_max/iso/rgb/rules.mk b/keyboards/keychron/k13_max/iso/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k13_max/iso/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k13_max/iso/white/config.h b/keyboards/keychron/k13_max/iso/white/config.h
new file mode 100644
index 0000000000..e56cd98c95
--- /dev/null
+++ b/keyboards/keychron/k13_max/iso/white/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 91
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Low battery indicating led */
+# define LOW_BAT_IND_INDEX \
+ { 83 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k13_max/iso/white/keyboard.json b/keyboards/keychron/k13_max/iso/white/keyboard.json
new file mode 100644
index 0000000000..8b71a53ddd
--- /dev/null
+++ b/keyboards/keychron/k13_max/iso/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0AD4",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k13_max/iso/white/keymaps/default/keymap.c b/keyboards/keychron/k13_max/iso/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..b2fbc87628
--- /dev/null
+++ b/keyboards/keychron/k13_max/iso/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_91(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3,
+ 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_DEL, KC_P0, KC_PDOT,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_91(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_NUM, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_91(
+ 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_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3,
+ 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_DEL, KC_P0, KC_PDOT,
+ 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_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_91(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_NUM, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k13_max/iso/white/rules.mk b/keyboards/keychron/k13_max/iso/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k13_max/iso/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k13_max/iso/white/white.c b/keyboards/keychron/k13_max/iso/white/white.c
new file mode 100644
index 0000000000..1f6ea9a51a
--- /dev/null
+++ b/keyboards/keychron/k13_max/iso/white/white.c
@@ -0,0 +1,155 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA5},
+ {0, CB6_CA6},
+ {0, CB6_CA7},
+ {0, CB6_CA8},
+ {0, CB6_CA9},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+ {0, CB1_CA8},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+ {0, CB1_CA9},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA15},
+ {0, CB4_CA16},
+ {0, CB1_CA6},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+ {0, CB3_CA15},
+ {0, CB3_CA16},
+ {0, CB3_CA13},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA7},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+ {0, CB2_CA15},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, 63, 64, 65 },
+ { 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, __, 78, __, 79, __ },
+ { 80, 81, 82, __, __, __, 83, __, __, __, 84, 85, 86, 87, 88, 89, 90 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {26, 0}, {39, 0}, {52, 0}, {65, 0}, {85, 0}, { 98, 0}, {111, 0}, {124, 0}, {144, 0}, {157, 0}, {170, 0}, {183, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {13,14}, {26,14}, {39,14}, {52,14}, {65,14}, {79,14}, { 92,14}, {105,14}, {118,14}, {131,14}, {144,14}, {157,14}, {177,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {20,26}, {33,26}, {46,26}, {59,26}, {72,26}, {85,26}, { 98,26}, {111,26}, {124,26}, {138,26}, {151,26}, {164,26}, {180,32}, {198,26}, {211,26}, {224,26},
+ {5,39}, {23,39}, {36,39}, {49,39}, {62,39}, {75,39}, {88,39}, {102,39}, {115,39}, {128,39}, {141,39}, {154,39}, {167,39}, {198,39}, {211,39}, {224,39},
+ {3,51}, {16,51}, {30,51}, {43,51}, {56,51}, {69,51}, {82,51}, { 95,51}, {108,51}, {121,51}, {134,51}, {147,51}, {172,51}, {211,51},
+ {2,64}, {18,64}, {34,64}, {84,64}, {133,64}, {149,64}, {165,64}, {182,64}, {198,64}, {211,64}, {224,64},
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k13_max/k13_max.c b/keyboards/keychron/k13_max/k13_max.c
new file mode 100644
index 0000000000..619a088919
--- /dev/null
+++ b/keyboards/keychron/k13_max/k13_max.c
@@ -0,0 +1,101 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "transport.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef LK_WIRELESS_ENABLE
+pin_t bt_led_pins[] = BT_INDICATION_LED_PIN_LIST;
+pin_t p24g_led_pins[] = P24G_INDICATION_LED_PIN_LIST;
+#endif
+
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 2));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+ if (!host_keyboard_led_state().caps_lock) gpio_write_pin(LED_CAPS_LOCK_PIN, !LED_PIN_ON_STATE);
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+ for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(bt_led_pins[i], 1);
+ for (uint8_t i = 0; i < sizeof(p24g_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(p24g_led_pins[i], 1);
+#endif
+
+ } else {
+ gpio_write_pin(LED_CAPS_LOCK_PIN, LED_PIN_ON_STATE);
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+ if (get_transport() != TRANSPORT_P2P4)
+ for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(bt_led_pins[i], 0);
+ if (get_transport() != TRANSPORT_BLUETOOTH)
+ for (uint8_t i = 0; i < sizeof(p24g_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(p24g_led_pins[i], 0);
+
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/k13_max/mcuconf.h b/keyboards/keychron/k13_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/k13_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/k13_max/readme.md b/keyboards/keychron/k13_max/readme.md
new file mode 100644
index 0000000000..0e38c8887f
--- /dev/null
+++ b/keyboards/keychron/k13_max/readme.md
@@ -0,0 +1,22 @@
+# Keychron K13 Max
+
+
+
+A customizable 80% keyboard with a numpad
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron K13 Max
+* Hardware Availability: [Keychron K13 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-k13-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/k13_max/ansi/rgb:default
+ make keychron/k13_max/ansi/white:default
+
+Flashing example for this keyboard:
+
+ make keychron/k13_max/ansi/rgb:default:flash
+ make keychron/k13_max/ansi/white:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/k13_max/rules.mk b/keyboards/keychron/k13_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/k13_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/k13_max/via_json/k13_max_ansi_rgb.json b/keyboards/keychron/k13_max/via_json/k13_max_ansi_rgb.json
new file mode 100644
index 0000000000..36cbdeb1bd
--- /dev/null
+++ b/keyboards/keychron/k13_max/via_json/k13_max_ansi_rgb.json
@@ -0,0 +1,300 @@
+{
+ "name": "Keychron K13 Max ANSI RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0AD0",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ {
+ "x": 0.2
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "3, 14",
+ "3, 15",
+ "3, 16"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "x": 1.2,
+ "c": "#cccccc"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k13_max/via_json/k13_max_ansi_white.json b/keyboards/keychron/k13_max/via_json/k13_max_ansi_white.json
new file mode 100644
index 0000000000..7efdd96b3d
--- /dev/null
+++ b/keyboards/keychron/k13_max/via_json/k13_max_ansi_white.json
@@ -0,0 +1,239 @@
+{
+ "name": "Keychron K13 Max ANSI White",
+ "vendorId": "0x3434",
+ "productId": "0x0AD3",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ {
+ "x": 0.2
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "3, 14",
+ "3, 15",
+ "3, 16"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "x": 1.2,
+ "c": "#cccccc"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k13_max/via_json/k13_max_iso_rgb.json b/keyboards/keychron/k13_max/via_json/k13_max_iso_rgb.json
new file mode 100644
index 0000000000..f528f6a917
--- /dev/null
+++ b/keyboards/keychron/k13_max/via_json/k13_max_iso_rgb.json
@@ -0,0 +1,301 @@
+{
+ "name": "Keychron K13 Max ISO RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0AD1",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control, availabe in macOS", "shortName": "MCtrl"},
+ {"name": "Launch pad", "title": "Launch pad, availabe in macOS", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ "0,4",
+ "0,5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+
+ "0,10",
+ "0,11",
+ "0,12",
+ "0,13",
+ {
+ "x": 0.25
+ },
+ "0,14",
+ "0,15",
+ "0,16"
+ ],
+ [
+ {
+ "y": 0.2,
+ "c": "#cccccc"
+ },
+ "1,0",
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "1,14",
+ "1,15",
+ "1,16"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#777777",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "2,14",
+ "2,15",
+ "2,16"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13",
+ {
+ "x": 1.5,
+ "c": "#cccccc"
+ },
+ "3,14",
+ "3,15",
+ "3,16"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,1",
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 2.75
+ },
+ "4,13",
+ {
+ "x": 1.25,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,10",
+ {
+ "w": 1.25
+ },
+ "5,11",
+ {
+ "w": 1.25
+ },
+ "5,12",
+ {
+ "w": 1.25
+ },
+ "5,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,14",
+ "5,15",
+ "5,16"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k13_max/via_json/k13_max_iso_white.json b/keyboards/keychron/k13_max/via_json/k13_max_iso_white.json
new file mode 100644
index 0000000000..ffe525df73
--- /dev/null
+++ b/keyboards/keychron/k13_max/via_json/k13_max_iso_white.json
@@ -0,0 +1,240 @@
+{
+ "name": "Keychron K13 Max ISO White",
+ "vendorId": "0x3434",
+ "productId": "0x0AD4",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control, availabe in macOS", "shortName": "MCtrl"},
+ {"name": "Launch pad", "title": "Launch pad, availabe in macOS", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ "0,4",
+ "0,5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+
+ "0,10",
+ "0,11",
+ "0,12",
+ "0,13",
+ {
+ "x": 0.25
+ },
+ "0,14",
+ "0,15",
+ "0,16"
+ ],
+ [
+ {
+ "y": 0.2,
+ "c": "#cccccc"
+ },
+ "1,0",
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "1,14",
+ "1,15",
+ "1,16"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#777777",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "2,14",
+ "2,15",
+ "2,16"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13",
+ {
+ "x": 1.5,
+ "c": "#cccccc"
+ },
+ "3,14",
+ "3,15",
+ "3,16"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,1",
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 2.75
+ },
+ "4,13",
+ {
+ "x": 1.25,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,10",
+ {
+ "w": 1.25
+ },
+ "5,11",
+ {
+ "w": 1.25
+ },
+ "5,12",
+ {
+ "w": 1.25
+ },
+ "5,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,14",
+ "5,15",
+ "5,16"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k15_max/ansi_encoder/rgb/config.h b/keyboards/keychron/k15_max/ansi_encoder/rgb/config.h
new file mode 100644
index 0000000000..464073a560
--- /dev/null
+++ b/keyboards/keychron/k15_max/ansi_encoder/rgb/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 89
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 48
+# define LOW_BAT_IND_INDEX \
+ { 81, 83 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+#endif
diff --git a/keyboards/keychron/k15_max/ansi_encoder/rgb/keyboard.json b/keyboards/keychron/k15_max/ansi_encoder/rgb/keyboard.json
new file mode 100644
index 0000000000..25ab20787b
--- /dev/null
+++ b/keyboards/keychron/k15_max/ansi_encoder/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0AF0",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k15_max/ansi_encoder/rgb/keymaps/default/keymap.c b/keyboards/keychron/k15_max/ansi_encoder/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..e9d2e1aaba
--- /dev/null
+++ b/keyboards/keychron/k15_max/ansi_encoder/rgb/keymaps/default/keymap.c
@@ -0,0 +1,76 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_90(
+ KC_MUTE, KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN), KC_SPC, KC_RCMMD, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_90(
+ RGB_TOG, _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_90(
+ KC_MUTE, 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_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN), KC_SPC, KC_RALT, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_90(
+ RGB_TOG, _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+ const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = { ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = { ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ };
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k15_max/ansi_encoder/rgb/rgb.c b/keyboards/keychron/k15_max/ansi_encoder/rgb/rgb.c
new file mode 100644
index 0000000000..84754d2557
--- /dev/null
+++ b/keyboards/keychron/k15_max/ansi_encoder/rgb/rgb.c
@@ -0,0 +1,155 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t PROGMEM g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA14, CB7_CA14, CB8_CA14},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {0, CB3_CA1, CB1_CA1, CB2_CA1},
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA14, CB1_CA14, CB2_CA14},
+ {0, CB3_CA15, CB1_CA15, CB2_CA15},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA15, CB4_CA15, CB5_CA15},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA13, CB1_CA13, CB2_CA13},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA2, CB1_CA2, CB2_CA2},
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA13, CB7_CA13, CB8_CA13},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA10, CB4_CA10, CB5_CA10},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+ {1, CB6_CA5, CB4_CA5, CB5_CA5},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46 },
+ { 47, 48, 49, 50, 51, 52, __, 53, 54, 55, 56, 57, 58, 59, 60, 61 },
+ { 62, 63, __, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76 },
+ { 77, 78, 79, 80, __, 81, __, 82, __, 83, 84, 85, __, 86, 87, 88 },
+ },
+ {
+ // LED Index to Physical Position
+ {19, 0}, {34, 0}, {46, 0}, {59, 1}, {71, 3}, {86, 6}, { 98, 8}, {121, 8}, {133, 6}, {147, 3}, {159, 1}, {173, 0}, {185, 0}, {203, 0}, {220, 0},
+ {5,14}, {24,14}, {36,14}, {48,13}, {61,15}, {73,17}, {85,20}, { 97,22}, {116,22}, {128,20}, {140,17}, {152,15}, {165,13}, {177,14}, {195,14}, {220,14},
+ {4,24}, {24,24}, {40,24}, {53,24}, {65,27}, {77,29}, {89,31}, {113,33}, {125,31}, {137,29}, {149,26}, {161,24}, {174,24}, {186,24}, {201,24}, {222,24},
+ {2,34}, {23,34}, {40,34}, {53,35}, {65,37}, {77,39}, {89,42}, {118,42}, {130,40}, {142,38}, {154,36}, {167,34}, {179,34}, {199,34}, {224,35},
+ {0,45}, {24,45}, {44,45}, {57,46}, {69,48}, {81,51}, { 93,53}, {112,54}, {124,52}, {136,50}, {148,48}, {160,46}, {173,45}, {190,45}, {210,47},
+ {0,55}, {18,55}, {33,55}, {56,57}, {77,61}, { 96,64}, {125,63}, {147,58}, {159,56}, {198,58}, {210,58}, {222,58}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k15_max/ansi_encoder/rgb/rules.mk b/keyboards/keychron/k15_max/ansi_encoder/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k15_max/ansi_encoder/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k15_max/ansi_encoder/white/config.h b/keyboards/keychron/k15_max/ansi_encoder/white/config.h
new file mode 100644
index 0000000000..80399f9935
--- /dev/null
+++ b/keyboards/keychron/k15_max/ansi_encoder/white/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 89
+# define DRIVER_CS_PINS \
+ { B8 }
+
+/* Use first 8 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_8_CHANNEL
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 48
+# define LOW_BAT_IND_INDEX \
+ { 81, 83 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k15_max/ansi_encoder/white/keyboard.json b/keyboards/keychron/k15_max/ansi_encoder/white/keyboard.json
new file mode 100644
index 0000000000..dd6ad88864
--- /dev/null
+++ b/keyboards/keychron/k15_max/ansi_encoder/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0AF3",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k15_max/ansi_encoder/white/keymaps/default/keymap.c b/keyboards/keychron/k15_max/ansi_encoder/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..10356ea112
--- /dev/null
+++ b/keyboards/keychron/k15_max/ansi_encoder/white/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_90(
+ KC_MUTE, KC_ESC, BL_DOWN, BL_UP, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN), KC_SPC, KC_RCMMD, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_90(
+ BL_TOGG, _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_90(
+ KC_MUTE, 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_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN), KC_SPC, KC_RALT, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_90(
+ BL_TOGG, _______, BL_DOWN, BL_UP, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = { ENCODER_CCW_CW(BL_DOWN, BL_UP)},
+ [WIN_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = { ENCODER_CCW_CW(BL_DOWN, BL_UP)}
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
+
diff --git a/keyboards/keychron/k15_max/ansi_encoder/white/rules.mk b/keyboards/keychron/k15_max/ansi_encoder/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k15_max/ansi_encoder/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k15_max/ansi_encoder/white/white.c b/keyboards/keychron/k15_max/ansi_encoder/white/white.c
new file mode 100644
index 0000000000..bc05629b67
--- /dev/null
+++ b/keyboards/keychron/k15_max/ansi_encoder/white/white.c
@@ -0,0 +1,153 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA5},
+ {0, CB6_CA6},
+ {0, CB6_CA7},
+ {0, CB6_CA8},
+ {0, CB6_CA9},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA14},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA15},
+ {0, CB4_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA13},
+ {0, CB3_CA14},
+ {0, CB3_CA15},
+ {0, CB3_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA14},
+ {0, CB2_CA15},
+ {0, CB2_CA16},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA4},
+ {0, CB1_CA5},
+ {0, CB1_CA7},
+ {0, CB1_CA10},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46 },
+ { 47, 48, 49, 50, 51, 52, __, 53, 54, 55, 56, 57, 58, 59, 60, 61 },
+ { 62, 63, __, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76 },
+ { 77, 78, 79, 80, __, 81, __, 82, __, 83, 84, 85, __, 86, 87, 88 },
+ },
+ {
+ // LED Index to Physical Position
+ {19, 0}, {34, 0}, {46, 0}, {59, 1}, {71, 3}, {86, 6}, { 98, 8}, {121, 8}, {133, 6}, {147, 3}, {159, 1}, {173, 0}, {185, 0}, {203, 0}, {220, 0},
+ {5,14}, {24,14}, {36,14}, {48,13}, {61,15}, {73,17}, {85,20}, { 97,22}, {116,22}, {128,20}, {140,17}, {152,15}, {165,13}, {177,14}, {195,14}, {220,14},
+ {4,24}, {24,24}, {40,24}, {53,24}, {65,27}, {77,29}, {89,31}, {113,33}, {125,31}, {137,29}, {149,26}, {161,24}, {174,24}, {186,24}, {201,24}, {222,24},
+ {2,34}, {23,34}, {40,34}, {53,35}, {65,37}, {77,39}, {89,42}, {118,42}, {130,40}, {142,38}, {154,36}, {167,34}, {179,34}, {199,34}, {224,35},
+ {0,45}, {24,45}, {44,45}, {57,46}, {69,48}, {81,51}, { 93,53}, {112,54}, {124,52}, {136,50}, {148,48}, {160,46}, {173,45}, {190,45}, {210,47},
+ {0,55}, {18,55}, {33,55}, {56,57}, {77,61}, { 96,64}, {125,63}, {147,58}, {159,56}, {198,58}, {210,58}, {222,58}
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k15_max/board.h b/keyboards/keychron/k15_max/board.h
new file mode 100644
index 0000000000..eb1aac7713
--- /dev/null
+++ b/keyboards/keychron/k15_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLDOWN(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/k15_max/config.h b/keyboards/keychron/k15_max/config.h
new file mode 100644
index 0000000000..6cb7bc1841
--- /dev/null
+++ b/keyboards/keychron/k15_max/config.h
@@ -0,0 +1,82 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define FN_BL_TRIG_KEY KC_END
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/k15_max/halconf.h b/keyboards/keychron/k15_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/k15_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/k15_max/info.json b/keyboards/keychron/k15_max/info.json
new file mode 100644
index 0000000000..36c9374529
--- /dev/null
+++ b/keyboards/keychron/k15_max/info.json
@@ -0,0 +1,355 @@
+{
+ "keyboard_name": "Keychron K15 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "Chae",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey": true,
+ "mousekey": true,
+ "dip_switch": true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro": true,
+ "raw": true,
+ "send_string": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "bootmagic": {
+ "matrix": [0, 1]
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "A8",
+ "pin_b": "C9"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["B14"]
+ },
+ "indicators": {
+ "caps_lock": "A13",
+ "on_state": 1
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "layouts": {
+ "LAYOUT_ansi_90": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.5, "y": 0},
+ {"matrix": [0, 2], "x": 2.75, "y": 0},
+ {"matrix": [0, 3], "x": 3.75, "y": 0},
+ {"matrix": [0, 4], "x": 4.75, "y": 0},
+ {"matrix": [0, 5], "x": 5.75, "y": 0.25},
+ {"matrix": [0, 6], "x": 7, "y": 0.5},
+ {"matrix": [0, 7], "x": 8, "y": 0.75},
+ {"matrix": [0, 8], "x": 9.75, "y": 0.75},
+ {"matrix": [0, 9], "x": 10.75, "y": 0.5},
+ {"matrix": [0, 10], "x": 12, "y": 0.25},
+ {"matrix": [0, 11], "x": 13, "y": 0},
+ {"matrix": [0, 12], "x": 14, "y": 0},
+ {"matrix": [0, 13], "x": 15, "y": 0},
+ {"matrix": [0, 14], "x": 16.5, "y": 0},
+ {"matrix": [0, 15], "x": 18, "y": 0},
+
+ {"matrix": [1, 0], "x": 0.5, "y": 1.25},
+ {"matrix": [1, 1], "x": 2, "y": 1.25},
+ {"matrix": [1, 2], "x": 3, "y": 1.25},
+ {"matrix": [1, 3], "x": 4, "y": 1.25},
+ {"matrix": [1, 4], "x": 5, "y": 1.5},
+ {"matrix": [1, 5], "x": 6, "y": 1.75},
+ {"matrix": [1, 6], "x": 7, "y": 2},
+ {"matrix": [1, 7], "x": 8, "y": 2},
+ {"matrix": [1, 8], "x": 9.5, "y": 2},
+ {"matrix": [1, 9], "x": 10.5, "y": 2},
+ {"matrix": [1, 10], "x": 11.5, "y": 1.75},
+ {"matrix": [1, 11], "x": 12.5, "y": 1.5},
+ {"matrix": [1, 12], "x": 13.5, "y": 1.25},
+ {"matrix": [1, 13], "x": 14.5, "y": 1.25},
+ {"matrix": [1, 14], "x": 15.5, "y": 1.25, "w": 2},
+ {"matrix": [1, 15], "x": 18, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0.25, "y": 2.25},
+ {"matrix": [2, 1], "x": 1.75, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 2], "x": 3.25, "y": 2.25},
+ {"matrix": [2, 3], "x": 4.25, "y": 2.25},
+ {"matrix": [2, 4], "x": 5.25, "y": 2.5},
+ {"matrix": [2, 5], "x": 6.25, "y": 2.75},
+ {"matrix": [2, 6], "x": 7.25, "y": 3},
+ {"matrix": [2, 7], "x": 9.25, "y": 3.25},
+ {"matrix": [2, 8], "x": 10.25, "y": 3},
+ {"matrix": [2, 9], "x": 11.25, "y": 2.75},
+ {"matrix": [2, 10], "x": 12.25, "y": 2.5},
+ {"matrix": [2, 11], "x": 13, "y": 2.25},
+ {"matrix": [2, 12], "x": 14.25, "y": 2.25},
+ {"matrix": [2, 13], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 14], "x": 16.25, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 15], "x": 18, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0.25, "y": 3.25},
+ {"matrix": [3, 1], "x": 1.5, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 2], "x": 3.25, "y": 3.25},
+ {"matrix": [3, 3], "x": 4.25, "y": 3.5},
+ {"matrix": [3, 4], "x": 5.25, "y": 3.5},
+ {"matrix": [3, 5], "x": 6.25, "y": 3.75},
+ {"matrix": [3, 7], "x": 7.25, "y": 4},
+ {"matrix": [3, 8], "x": 9.75, "y": 4},
+ {"matrix": [3, 9], "x": 10.5, "y": 4},
+ {"matrix": [3, 10], "x": 11.5, "y": 3.75},
+ {"matrix": [3, 11], "x": 12.5, "y": 3.5},
+ {"matrix": [3, 12], "x": 13.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 14.75, "y": 3.25},
+ {"matrix": [3, 14], "x": 15.75, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 15], "x": 18.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 3], "x": 3.5, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.75, "y": 4.5},
+ {"matrix": [4, 5], "x": 5.5, "y": 4.75},
+ {"matrix": [4, 6], "x": 6.5, "y": 4.75},
+ {"matrix": [4, 7], "x": 7.5, "y": 5},
+ {"matrix": [4, 8], "x": 9, "y": 5.25},
+ {"matrix": [4, 9], "x": 10, "y": 5},
+ {"matrix": [4, 10], "x": 11, "y": 4.75},
+ {"matrix": [4, 11], "x": 12, "y": 4.5},
+ {"matrix": [4, 12], "x": 13, "y": 4.5},
+ {"matrix": [4, 13], "x": 14, "y": 4.25},
+ {"matrix": [4, 14], "x": 15, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 15], "x": 17.25, "y": 4.5},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 3], "x": 4.5, "y": 5.5, "w": 1.25},
+ {"matrix": [5, 5], "x": 5.75, "y": 5.75, "w": 2.25},
+ {"matrix": [5, 7], "x": 7.75, "y": 6.25},
+ {"matrix": [5, 9], "x": 9.25, "y": 6, "w": 2.75},
+ {"matrix": [5, 10], "x": 12, "y": 5.75},
+ {"matrix": [5, 11], "x": 13, "y": 5.5},
+ {"matrix": [5, 13], "x": 16.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 17.25, "y": 5.5},
+ {"matrix": [5, 15], "x": 18.25, "y": 5.5}
+ ]
+ },
+ "LAYOUT_iso_91": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.5, "y": 0},
+ {"matrix": [0, 2], "x": 2.75, "y": 0},
+ {"matrix": [0, 3], "x": 3.75, "y": 0},
+ {"matrix": [0, 4], "x": 4.75, "y": 0},
+ {"matrix": [0, 5], "x": 5.75, "y": 0.25},
+ {"matrix": [0, 6], "x": 7, "y": 0.5},
+ {"matrix": [0, 7], "x": 8, "y": 0.75},
+ {"matrix": [0, 8], "x": 9.75, "y": 0.75},
+ {"matrix": [0, 9], "x": 10.75, "y": 0.5},
+ {"matrix": [0, 10], "x": 12, "y": 0.25},
+ {"matrix": [0, 11], "x": 13, "y": 0},
+ {"matrix": [0, 12], "x": 14, "y": 0},
+ {"matrix": [0, 13], "x": 15, "y": 0},
+ {"matrix": [0, 14], "x": 16.5, "y": 0},
+ {"matrix": [0, 15], "x": 18, "y": 0},
+
+ {"matrix": [1, 0], "x": 0.5, "y": 1.25},
+ {"matrix": [1, 1], "x": 2, "y": 1.25},
+ {"matrix": [1, 2], "x": 3, "y": 1.25},
+ {"matrix": [1, 3], "x": 4, "y": 1.25},
+ {"matrix": [1, 4], "x": 5, "y": 1.5},
+ {"matrix": [1, 5], "x": 6, "y": 1.75},
+ {"matrix": [1, 6], "x": 7, "y": 2},
+ {"matrix": [1, 7], "x": 8, "y": 2},
+ {"matrix": [1, 8], "x": 9.5, "y": 2},
+ {"matrix": [1, 9], "x": 10.5, "y": 2},
+ {"matrix": [1, 10], "x": 11.5, "y": 1.75},
+ {"matrix": [1, 11], "x": 12.5, "y": 1.5},
+ {"matrix": [1, 12], "x": 13.5, "y": 1.25},
+ {"matrix": [1, 13], "x": 14.5, "y": 1.25},
+ {"matrix": [1, 14], "x": 15.5, "y": 1.25, "w": 2},
+ {"matrix": [1, 15], "x": 18, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0.25, "y": 2.25},
+ {"matrix": [2, 1], "x": 1.75, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 2], "x": 3.25, "y": 2.25},
+ {"matrix": [2, 3], "x": 4.25, "y": 2.25},
+ {"matrix": [2, 4], "x": 5.25, "y": 2.5},
+ {"matrix": [2, 5], "x": 6.25, "y": 2.75},
+ {"matrix": [2, 6], "x": 7.25, "y": 3},
+ {"matrix": [2, 7], "x": 9.25, "y": 3.25},
+ {"matrix": [2, 8], "x": 10.25, "y": 3},
+ {"matrix": [2, 9], "x": 11.25, "y": 2.75},
+ {"matrix": [2, 10], "x": 12.25, "y": 2.5},
+ {"matrix": [2, 11], "x": 13, "y": 2.25},
+ {"matrix": [2, 12], "x": 14.25, "y": 2.25},
+ {"matrix": [2, 13], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 18, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0.25, "y": 3.25},
+ {"matrix": [3, 1], "x": 1.5, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 2], "x": 3.25, "y": 3.25},
+ {"matrix": [3, 3], "x": 4.25, "y": 3.5},
+ {"matrix": [3, 4], "x": 5.25, "y": 3.5},
+ {"matrix": [3, 5], "x": 6.25, "y": 3.75},
+ {"matrix": [3, 7], "x": 7.25, "y": 4},
+ {"matrix": [3, 8], "x": 9.75, "y": 4},
+ {"matrix": [3, 9], "x": 10.5, "y": 4},
+ {"matrix": [3, 10], "x": 11.5, "y": 3.75},
+ {"matrix": [3, 11], "x": 12.5, "y": 3.5},
+ {"matrix": [3, 12], "x": 13.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 14.75, "y": 3.25},
+ {"matrix": [3, 14], "x": 15.75, "y": 3.25},
+ {"matrix": [2, 14], "x": 16.25, "y": 2.25, "w": 1.25, "h": 2},
+ {"matrix": [3, 15], "x": 18.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 2], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.5, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.75, "y": 4.5},
+ {"matrix": [4, 5], "x": 5.5, "y": 4.75},
+ {"matrix": [4, 6], "x": 6.5, "y": 4.75},
+ {"matrix": [4, 7], "x": 7.5, "y": 5},
+ {"matrix": [4, 8], "x": 9, "y": 5.25},
+ {"matrix": [4, 9], "x": 10, "y": 5},
+ {"matrix": [4, 10], "x": 11, "y": 4.75},
+ {"matrix": [4, 11], "x": 12, "y": 4.5},
+ {"matrix": [4, 12], "x": 13, "y": 4.5},
+ {"matrix": [4, 13], "x": 14, "y": 4.25},
+ {"matrix": [4, 14], "x": 15, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 15], "x": 17.25, "y": 4.5},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 3], "x": 4.5, "y": 5.5, "w": 1.25},
+ {"matrix": [5, 5], "x": 5.75, "y": 5.75, "w": 2.25},
+ {"matrix": [5, 7], "x": 7.75, "y": 6.25},
+ {"matrix": [5, 9], "x": 9.25, "y": 6, "w": 2.75},
+ {"matrix": [5, 10], "x": 12, "y": 5.75},
+ {"matrix": [5, 11], "x": 13, "y": 5.5},
+ {"matrix": [5, 13], "x": 16.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 17.25, "y": 5.5},
+ {"matrix": [5, 15], "x": 18.25, "y": 5.5}
+ ]
+ },
+ "LAYOUT_jis_93": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.5, "y": 0},
+ {"matrix": [0, 2], "x": 2.75, "y": 0},
+ {"matrix": [0, 3], "x": 3.75, "y": 0},
+ {"matrix": [0, 4], "x": 4.75, "y": 0},
+ {"matrix": [0, 5], "x": 5.75, "y": 0.25},
+ {"matrix": [0, 6], "x": 7, "y": 0.5},
+ {"matrix": [0, 7], "x": 8, "y": 0.75},
+ {"matrix": [0, 8], "x": 9.75, "y": 0.75},
+ {"matrix": [0, 9], "x": 10.75, "y": 0.5},
+ {"matrix": [0, 10], "x": 12, "y": 0.25},
+ {"matrix": [0, 11], "x": 13, "y": 0},
+ {"matrix": [0, 12], "x": 14, "y": 0},
+ {"matrix": [0, 13], "x": 15, "y": 0},
+ {"matrix": [0, 14], "x": 16.5, "y": 0},
+ {"matrix": [0, 15], "x": 18, "y": 0},
+
+ {"matrix": [1, 0], "x": 0.5, "y": 1.25},
+ {"matrix": [1, 1], "x": 2, "y": 1.25},
+ {"matrix": [1, 2], "x": 3, "y": 1.25},
+ {"matrix": [1, 3], "x": 4, "y": 1.25},
+ {"matrix": [1, 4], "x": 5, "y": 1.5},
+ {"matrix": [1, 5], "x": 6, "y": 1.75},
+ {"matrix": [1, 6], "x": 7, "y": 2},
+ {"matrix": [1, 7], "x": 8, "y": 2},
+ {"matrix": [1, 8], "x": 9.5, "y": 2},
+ {"matrix": [1, 9], "x": 10.5, "y": 2},
+ {"matrix": [1, 10], "x": 11.5, "y": 1.75},
+ {"matrix": [1, 11], "x": 12.5, "y": 1.5},
+ {"matrix": [1, 12], "x": 13.5, "y": 1.25},
+ {"matrix": [1, 13], "x": 14.5, "y": 1.25},
+ {"matrix": [1, 14], "x": 15.5, "y": 1.25},
+ {"matrix": [1, 15], "x": 16.5, "y": 1.25},
+ {"matrix": [5, 7], "x": 16.5, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0.25, "y": 2.25},
+ {"matrix": [2, 1], "x": 1.75, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 2], "x": 3.25, "y": 2.25},
+ {"matrix": [2, 3], "x": 4.25, "y": 2.25},
+ {"matrix": [2, 4], "x": 5.25, "y": 2.5},
+ {"matrix": [2, 5], "x": 6.25, "y": 2.75},
+ {"matrix": [2, 6], "x": 7.25, "y": 3},
+ {"matrix": [2, 7], "x": 9.25, "y": 3.25},
+ {"matrix": [2, 8], "x": 10.25, "y": 3},
+ {"matrix": [2, 9], "x": 11.25, "y": 2.75},
+ {"matrix": [2, 10], "x": 12.25, "y": 2.5},
+ {"matrix": [2, 11], "x": 13, "y": 2.25},
+ {"matrix": [2, 12], "x": 14.25, "y": 2.25},
+ {"matrix": [2, 13], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 18, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0.25, "y": 3.25},
+ {"matrix": [3, 1], "x": 1.5, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 2], "x": 3.25, "y": 3.25},
+ {"matrix": [3, 3], "x": 4.25, "y": 3.5},
+ {"matrix": [3, 4], "x": 5.25, "y": 3.5},
+ {"matrix": [3, 5], "x": 6.25, "y": 3.75},
+ {"matrix": [3, 7], "x": 7.25, "y": 4},
+ {"matrix": [3, 8], "x": 9.75, "y": 4},
+ {"matrix": [3, 9], "x": 10.5, "y": 4},
+ {"matrix": [3, 10], "x": 11.5, "y": 3.75},
+ {"matrix": [3, 11], "x": 12.5, "y": 3.5},
+ {"matrix": [3, 12], "x": 13.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 14.75, "y": 3.25},
+ {"matrix": [3, 14], "x": 15.75, "y": 3.25},
+ {"matrix": [2, 14], "x": 16.25, "y": 2.25, "w": 1.25, "h": 2},
+ {"matrix": [3, 15], "x": 18.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.5, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.75, "y": 4.5},
+ {"matrix": [4, 5], "x": 5.5, "y": 4.75},
+ {"matrix": [4, 6], "x": 6.5, "y": 4.75},
+ {"matrix": [4, 7], "x": 7.5, "y": 5},
+ {"matrix": [4, 8], "x": 9, "y": 5.25},
+ {"matrix": [4, 9], "x": 10, "y": 5},
+ {"matrix": [4, 10], "x": 11, "y": 4.75},
+ {"matrix": [4, 11], "x": 12, "y": 4.5},
+ {"matrix": [4, 12], "x": 13, "y": 4.5},
+ {"matrix": [4, 13], "x": 14, "y": 4.25},
+ {"matrix": [4, 14], "x": 15, "y": 4.25},
+ {"matrix": [4, 15], "x": 16, "y": 4.5},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25},
+ {"matrix": [5, 3], "x": 3.5, "y": 5.5},
+ {"matrix": [5, 4], "x": 4.5, "y": 5.5},
+ {"matrix": [5, 5], "x": 5.5, "y": 5.75, "w": 2.25},
+ {"matrix": [5, 8], "x": 18, "y": 1.25},
+ {"matrix": [5, 9], "x": 9.25, "y": 6, "w": 2.75},
+ {"matrix": [5, 10], "x": 12, "y": 5.75},
+ {"matrix": [5, 11], "x": 13, "y": 5.5},
+ {"matrix": [5, 12], "x": 17, "y": 4.5},
+ {"matrix": [5, 13], "x": 16.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 17.25, "y": 5.5},
+ {"matrix": [5, 15], "x": 18.25, "y": 5.5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/k15_max/iso_encoder/rgb/config.h b/keyboards/keychron/k15_max/iso_encoder/rgb/config.h
new file mode 100644
index 0000000000..fd00c18606
--- /dev/null
+++ b/keyboards/keychron/k15_max/iso_encoder/rgb/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 90
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 48
+# define LOW_BAT_IND_INDEX \
+ { 82, 84 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+#endif
diff --git a/keyboards/keychron/k15_max/iso_encoder/rgb/keyboard.json b/keyboards/keychron/k15_max/iso_encoder/rgb/keyboard.json
new file mode 100644
index 0000000000..25e2acc16d
--- /dev/null
+++ b/keyboards/keychron/k15_max/iso_encoder/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0AF1",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k15_max/iso_encoder/rgb/keymaps/default/keymap.c b/keyboards/keychron/k15_max/iso_encoder/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..db290953c3
--- /dev/null
+++ b/keyboards/keychron/k15_max/iso_encoder/rgb/keymaps/default/keymap.c
@@ -0,0 +1,76 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_91(
+ KC_MUTE, KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_NUBS, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN), KC_SPC, KC_RCMMD, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_91(
+ RGB_TOG, _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_91(
+ KC_MUTE, 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_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_NUBS, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN), KC_SPC, KC_RALT, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_91(
+ RGB_TOG, _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+ const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = { ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = { ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ };
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k15_max/iso_encoder/rgb/rgb.c b/keyboards/keychron/k15_max/iso_encoder/rgb/rgb.c
new file mode 100644
index 0000000000..ac20d5e01e
--- /dev/null
+++ b/keyboards/keychron/k15_max/iso_encoder/rgb/rgb.c
@@ -0,0 +1,156 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t PROGMEM g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA14, CB7_CA14, CB8_CA14},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {0, CB3_CA1, CB1_CA1, CB2_CA1},
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA14, CB1_CA14, CB2_CA14},
+ {0, CB3_CA15, CB1_CA15, CB2_CA15},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA15, CB4_CA15, CB5_CA15},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA13, CB1_CA13, CB2_CA13},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA2, CB1_CA2, CB2_CA2},
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB9_CA15, CB7_CA15, CB8_CA15},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA13, CB7_CA13, CB8_CA13},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA10, CB4_CA10, CB5_CA10},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+ {1, CB6_CA5, CB4_CA5, CB5_CA5},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46 },
+ { 47, 48, 49, 50, 51, 52, __, 53, 54, 55, 56, 57, 58, 59, 60, 61 },
+ { 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77 },
+ { 78, 79, 80, 81, __, 82, __, 83, __, 84, 85, 86, __, 87, 88, 89 },
+ },
+ {
+ // LED Index to Physical Position
+ {19, 0}, {34, 0}, {46, 0}, {59, 1}, {71, 3}, {86, 6}, { 98, 8}, {121, 8}, {133, 6}, {147, 3}, {159, 1}, {173, 0}, {185, 0}, {203, 0}, {220, 0},
+ {5,14}, {24,14}, {36,14}, {48,13}, {61,15}, {73,17}, {85,20}, { 97,22}, {116,22}, {128,20}, {140,17}, {152,15}, {165,13}, {177,14}, {195,14}, {220,14},
+ {4,24}, {24,24}, {40,24}, {53,24}, {65,27}, {77,29}, {89,31}, {113,33}, {125,31}, {137,29}, {149,26}, {161,24}, {174,24}, {186,24}, {201,29}, {222,24},
+ {2,34}, {23,34}, {40,34}, {53,35}, {65,37}, {77,39}, {89,42}, {118,42}, {130,40}, {142,38}, {154,36}, {167,34}, {179,34}, {192,34}, {224,35},
+ {0,45}, {18,45}, {33,45}, {44,45}, {57,46}, {69,48}, {81,51}, { 93,53}, {112,54}, {124,52}, {136,50}, {148,48}, {160,46}, {173,45}, {190,45}, {210,47},
+ {0,55}, {18,55}, {33,55}, {56,57}, {77,61}, { 96,64}, {125,63}, {147,58}, {159,56}, {198,58}, {210,58}, {222,58}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k15_max/iso_encoder/rgb/rules.mk b/keyboards/keychron/k15_max/iso_encoder/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k15_max/iso_encoder/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k15_max/iso_encoder/white/config.h b/keyboards/keychron/k15_max/iso_encoder/white/config.h
new file mode 100644
index 0000000000..97fb805c46
--- /dev/null
+++ b/keyboards/keychron/k15_max/iso_encoder/white/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 90
+# define DRIVER_CS_PINS \
+ { B8 }
+
+/* Use first 8 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_8_CHANNEL
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C, 0x3C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 48
+# define LOW_BAT_IND_INDEX \
+ { 82, 84 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k15_max/iso_encoder/white/keyboard.json b/keyboards/keychron/k15_max/iso_encoder/white/keyboard.json
new file mode 100644
index 0000000000..d1546b2c16
--- /dev/null
+++ b/keyboards/keychron/k15_max/iso_encoder/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0AF4",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k15_max/iso_encoder/white/keymaps/default/keymap.c b/keyboards/keychron/k15_max/iso_encoder/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..df36cb4d06
--- /dev/null
+++ b/keyboards/keychron/k15_max/iso_encoder/white/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_91(
+ KC_MUTE, KC_ESC, BL_DOWN, BL_UP, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_NUBS, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN), KC_SPC, KC_RCMMD, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_91(
+ BL_TOGG, _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_91(
+ KC_MUTE, 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_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_NUBS, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN), KC_SPC, KC_RALT, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_91(
+ BL_TOGG, _______, BL_DOWN, BL_UP, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = { ENCODER_CCW_CW(BL_DOWN, BL_UP)},
+ [WIN_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = { ENCODER_CCW_CW(BL_DOWN, BL_UP)}
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k15_max/iso_encoder/white/rules.mk b/keyboards/keychron/k15_max/iso_encoder/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k15_max/iso_encoder/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k15_max/iso_encoder/white/white.c b/keyboards/keychron/k15_max/iso_encoder/white/white.c
new file mode 100644
index 0000000000..b36ec1f199
--- /dev/null
+++ b/keyboards/keychron/k15_max/iso_encoder/white/white.c
@@ -0,0 +1,154 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA5},
+ {0, CB6_CA6},
+ {0, CB6_CA7},
+ {0, CB6_CA8},
+ {0, CB6_CA9},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA14},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA15},
+ {0, CB4_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA13},
+ {0, CB3_CA14},
+ {0, CB3_CA15},
+ {0, CB3_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA14},
+ {0, CB2_CA15},
+ {0, CB2_CA16},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA4},
+ {0, CB1_CA5},
+ {0, CB1_CA7},
+ {0, CB1_CA10},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46 },
+ { 47, 48, 49, 50, 51, 52, __, 53, 54, 55, 56, 57, 58, 59, 60, 61 },
+ { 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77 },
+ { 78, 79, 80, 81, __, 82, __, 83, __, 84, 85, 86, __, 87, 88, 89 },
+ },
+ {
+ // LED Index to Physical Position
+ {19, 0}, {34, 0}, {46, 0}, {59, 1}, {71, 3}, {86, 6}, { 98, 8}, {121, 8}, {133, 6}, {147, 3}, {159, 1}, {173, 0}, {185, 0}, {203, 0}, {220, 0},
+ {5,14}, {24,14}, {36,14}, {48,13}, {61,15}, {73,17}, {85,20}, { 97,22}, {116,22}, {128,20}, {140,17}, {152,15}, {165,13}, {177,14}, {195,14}, {220,14},
+ {4,24}, {24,24}, {40,24}, {53,24}, {65,27}, {77,29}, {89,31}, {113,33}, {125,31}, {137,29}, {149,26}, {161,24}, {174,24}, {186,24}, {201,29}, {222,24},
+ {2,34}, {23,34}, {40,34}, {53,35}, {65,37}, {77,39}, {89,42}, {118,42}, {130,40}, {142,38}, {154,36}, {167,34}, {179,34}, {192,34}, {224,35},
+ {0,45}, {18,45}, {33,45}, {44,45}, {57,46}, {69,48}, {81,51}, { 93,53}, {112,54}, {124,52}, {136,50}, {148,48}, {160,46}, {173,45}, {190,45}, {210,47},
+ {0,55}, {18,55}, {33,55}, {56,57}, {77,61}, { 96,64}, {125,63}, {147,58}, {159,56}, {198,58}, {210,58}, {222,58}
+ },
+ {
+ // LED LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k15_max/k15_max.c b/keyboards/keychron/k15_max/k15_max.c
new file mode 100644
index 0000000000..e30529ed1c
--- /dev/null
+++ b/keyboards/keychron/k15_max/k15_max.c
@@ -0,0 +1,70 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#include "keychron_common.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "transport.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 2));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (factory_reset_indicating()) {
+ gpio_write_pin(LED_CAPS_LOCK_PIN, !LED_PIN_ON_STATE);
+ } else {
+ if (host_keyboard_led_state().caps_lock) gpio_write_pin(LED_CAPS_LOCK_PIN, LED_PIN_ON_STATE);
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/k15_max/mcuconf.h b/keyboards/keychron/k15_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/k15_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/k15_max/readme.md b/keyboards/keychron/k15_max/readme.md
new file mode 100644
index 0000000000..6c45eac5ef
--- /dev/null
+++ b/keyboards/keychron/k15_max/readme.md
@@ -0,0 +1,24 @@
+# Keychron K15 Max
+
+
+
+A customizable 87 keys TKL keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron K15 Max
+* Hardware Availability: [Keychron K15 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-k15-max-alice-layout-qmk-wireless-custom-mechanical-keyboard?srsltid=AfmBOopYgEhFIVG8J1zdO92O-GHx2nnAQfw_LTJHs5GntK29gFbKy5b5)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/k15_max/ansi/rgb:default
+ make keychron/k15_max/ansi/white:default
+
+
+Flashing example for this keyboard:
+
+ make keychron/k15_max/ansi/rgb:default:flash
+ make keychron/k15_max/ansi/white:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/k15_max/rules.mk b/keyboards/keychron/k15_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/k15_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/k15_max/via_json/k15_max_ansi_knob_rgb.json b/keyboards/keychron/k15_max/via_json/k15_max_ansi_knob_rgb.json
new file mode 100644
index 0000000000..9d50cbf0ea
--- /dev/null
+++ b/keyboards/keychron/k15_max/via_json/k15_max_ansi_knob_rgb.json
@@ -0,0 +1,397 @@
+{
+ "name": "Keychron K15 Max ANSI Knob RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0AF0",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#aaaaaa",
+ "x": 0.5
+ },
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.5,
+ "c": "#777777"
+ },
+ "0,1\nESC",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ {
+ "x": 9.35
+ },
+ "0,12",
+ "0,13",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,15"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 0.75
+ },
+ "1,0",
+ {
+ "x": 0.5
+ },
+ "1,1",
+ {
+ "c": "#cccccc"
+ },
+ "1,2",
+ "1,3",
+ {
+ "x": 8.65
+ },
+ "1,12",
+ "1,13",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,14",
+ {
+ "x": 0.6
+ },
+ "1,15"
+ ],
+ [
+ {
+ "x": 0.5
+ },
+ "2,0",
+ {
+ "x": 0.5,
+ "w": 1.5
+ },
+ "2,1",
+ {
+ "c": "#cccccc"
+ },
+ "2,2",
+ {
+ "x": 9.9
+ },
+ "2,12",
+ "2,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "2,14",
+ {
+ "x": 0.5
+ },
+ "2,15"
+ ],
+ [
+ {
+ "x": 0.25
+ },
+ "3,0",
+ {
+ "x": 0.5,
+ "w": 1.75
+ },
+ "3,1",
+ {
+ "c": "#cccccc"
+ },
+ "3,2",
+ {
+ "x": 9.6
+ },
+ "3,12",
+ "3,13",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,14",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ "4,0",
+ {
+ "x": 0.5,
+ "w": 2.25
+ },
+ "4,1",
+ {
+ "c": "#cccccc"
+ },
+ "4,3",
+ {
+ "x": 9.95
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,14"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 17.7,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "y": -0.25
+ },
+ "5,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.7,
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -7.05,
+ "x": 5.4
+ },
+ "0,4",
+ "0,5",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "0,6",
+ "0,7"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 5.55,
+ "c": "#cccccc"
+ },
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7"
+ ],
+ [
+ {
+ "x": 4.9
+ },
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6"
+ ],
+ [
+ {
+ "x": 5
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,7"
+ ],
+ [
+ {
+ "x": 5.35
+ },
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7"
+ ],
+ [
+ {
+ "x": 5.35,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,3",
+ {
+ "w": 2.25
+ },
+ "5,5",
+ "5,7"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -4.25,
+ "x": 10.05
+ },
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc",
+ "x": 0.25
+ },
+ "0,10",
+ "0,11"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 9.4,
+ "c": "#cccccc"
+ },
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11"
+ ],
+ [
+ {
+ "x": 8.9
+ },
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11"
+ ],
+ [
+ {
+ "x": 9.4
+ },
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 8.85
+ },
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "x": 8.85,
+ "w": 2.55
+ },
+ "5,9",
+ "5,10",
+ "5,11"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k15_max/via_json/k15_max_ansi_knob_white.json b/keyboards/keychron/k15_max/via_json/k15_max_ansi_knob_white.json
new file mode 100644
index 0000000000..84e3f49c46
--- /dev/null
+++ b/keyboards/keychron/k15_max/via_json/k15_max_ansi_knob_white.json
@@ -0,0 +1,336 @@
+{
+ "name": "Keychron K15 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0AF3",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#aaaaaa",
+ "x": 0.5
+ },
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.5,
+ "c": "#777777"
+ },
+ "0,1\nESC",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ {
+ "x": 9.35
+ },
+ "0,12",
+ "0,13",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,15"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 0.75
+ },
+ "1,0",
+ {
+ "x": 0.5
+ },
+ "1,1",
+ {
+ "c": "#cccccc"
+ },
+ "1,2",
+ "1,3",
+ {
+ "x": 8.65
+ },
+ "1,12",
+ "1,13",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,14",
+ {
+ "x": 0.6
+ },
+ "1,15"
+ ],
+ [
+ {
+ "x": 0.5
+ },
+ "2,0",
+ {
+ "x": 0.5,
+ "w": 1.5
+ },
+ "2,1",
+ {
+ "c": "#cccccc"
+ },
+ "2,2",
+ {
+ "x": 9.9
+ },
+ "2,12",
+ "2,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "2,14",
+ {
+ "x": 0.5
+ },
+ "2,15"
+ ],
+ [
+ {
+ "x": 0.25
+ },
+ "3,0",
+ {
+ "x": 0.5,
+ "w": 1.75
+ },
+ "3,1",
+ {
+ "c": "#cccccc"
+ },
+ "3,2",
+ {
+ "x": 9.6
+ },
+ "3,12",
+ "3,13",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,14",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ "4,0",
+ {
+ "x": 0.5,
+ "w": 2.25
+ },
+ "4,1",
+ {
+ "c": "#cccccc"
+ },
+ "4,3",
+ {
+ "x": 9.95
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,14"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 17.7,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "y": -0.25
+ },
+ "5,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.7,
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -7.05,
+ "x": 5.4
+ },
+ "0,4",
+ "0,5",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "0,6",
+ "0,7"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 5.55,
+ "c": "#cccccc"
+ },
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7"
+ ],
+ [
+ {
+ "x": 4.9
+ },
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6"
+ ],
+ [
+ {
+ "x": 5
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,7"
+ ],
+ [
+ {
+ "x": 5.35
+ },
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7"
+ ],
+ [
+ {
+ "x": 5.35,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,3",
+ {
+ "w": 2.25
+ },
+ "5,5",
+ "5,7"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -4.25,
+ "x": 10.05
+ },
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc",
+ "x": 0.25
+ },
+ "0,10",
+ "0,11"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 9.4,
+ "c": "#cccccc"
+ },
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11"
+ ],
+ [
+ {
+ "x": 8.9
+ },
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11"
+ ],
+ [
+ {
+ "x": 9.4
+ },
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 8.85
+ },
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "x": 8.85,
+ "w": 2.55
+ },
+ "5,9",
+ "5,10",
+ "5,11"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k15_max/via_json/k15_max_iso_knob_rgb.json b/keyboards/keychron/k15_max/via_json/k15_max_iso_knob_rgb.json
new file mode 100644
index 0000000000..a09e9fc28e
--- /dev/null
+++ b/keyboards/keychron/k15_max/via_json/k15_max_iso_knob_rgb.json
@@ -0,0 +1,400 @@
+{
+ "name": "Keychron K15 Max ISO Knob RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0AF1",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#aaaaaa",
+ "x": 0.5
+ },
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.5,
+ "c": "#777777"
+ },
+ "0,1\nESC",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ {
+ "x": 9.35
+ },
+ "0,12",
+ "0,13",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,15"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 0.75
+ },
+ "1,0",
+ {
+ "x": 0.5
+ },
+ "1,1",
+ {
+ "c": "#cccccc"
+ },
+ "1,2",
+ "1,3",
+ {
+ "x": 8.65
+ },
+ "1,12",
+ "1,13",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,14",
+ {
+ "x": 0.6
+ },
+ "1,15"
+ ],
+ [
+ {
+ "x": 0.5
+ },
+ "2,0",
+ {
+ "x": 0.5,
+ "w": 1.5
+ },
+ "2,1",
+ {
+ "c": "#cccccc"
+ },
+ "2,2",
+ {
+ "x": 10.35
+ },
+ "2,12",
+ "2,13",
+ {
+ "x": 0.25,
+ "c": "#777777",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,14",
+ {
+ "x": 0.4,
+ "c": "#aaaaaa"
+ },
+ "2,15"
+ ],
+ [
+ {
+ "x": 0.25
+ },
+ "3,0",
+ {
+ "x": 0.5,
+ "w": 1.75
+ },
+ "3,1",
+ {
+ "c": "#cccccc"
+ },
+ "3,2",
+ {
+ "x": 9.6
+ },
+ "3,12",
+ "3,13",
+ "3,14",
+ {
+ "x": 1.85,
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ "4,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "4,1",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ {
+ "x": 9.95
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,14"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 17.7,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "y": -0.25
+ },
+ "5,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.7,
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -7.05,
+ "x": 5.4
+ },
+ "0,4",
+ "0,5",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "0,6",
+ "0,7"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 5.55,
+ "c": "#cccccc"
+ },
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7"
+ ],
+ [
+ {
+ "x": 5.0
+ },
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6"
+ ],
+ [
+ {
+ "x": 5.15
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,7"
+ ],
+ [
+ {
+ "x": 5.45
+ },
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7"
+ ],
+ [
+ {
+ "x": 5.45,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,3",
+ {
+ "w": 2.25
+ },
+ "5,5",
+ "5,7"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -4.25,
+ "x": 10.05
+ },
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc",
+ "x": 0.25
+ },
+ "0,10",
+ "0,11"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 9.5,
+ "c": "#cccccc"
+ },
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11"
+ ],
+ [
+ {
+ "x": 9.15
+ },
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11"
+ ],
+ [
+ {
+ "x": 9.5
+ },
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 8.95
+ },
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "x": 8.95,
+ "w": 2.55
+ },
+ "5,9",
+ "5,10",
+ "5,11"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k15_max/via_json/k15_max_iso_knob_white.json b/keyboards/keychron/k15_max/via_json/k15_max_iso_knob_white.json
new file mode 100644
index 0000000000..cadd32eb8d
--- /dev/null
+++ b/keyboards/keychron/k15_max/via_json/k15_max_iso_knob_white.json
@@ -0,0 +1,338 @@
+{
+ "name": "Keychron K15 Max ISO White Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0AF4",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#aaaaaa",
+ "x": 0.5
+ },
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.5,
+ "c": "#777777"
+ },
+ "0,1\nESC",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ {
+ "x": 9.35
+ },
+ "0,12",
+ "0,13",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,15"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 0.75
+ },
+ "1,0",
+ {
+ "x": 0.5
+ },
+ "1,1",
+ {
+ "c": "#cccccc"
+ },
+ "1,2",
+ "1,3",
+ {
+ "x": 8.65
+ },
+ "1,12",
+ "1,13",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,14",
+ {
+ "x": 0.6
+ },
+ "1,15"
+ ],
+ [
+ {
+ "x": 0.5
+ },
+ "2,0",
+ {
+ "x": 0.5,
+ "w": 1.5
+ },
+ "2,1",
+ {
+ "c": "#cccccc"
+ },
+ "2,2",
+ {
+ "x": 10.35
+ },
+ "2,12",
+ "2,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,14",
+ {
+ "x": 0.4
+ },
+ "2,15"
+ ],
+ [
+ {
+ "x": 0.25
+ },
+ "3,0",
+ {
+ "x": 0.5,
+ "w": 1.75
+ },
+ "3,1",
+ {
+ "c": "#cccccc"
+ },
+ "3,2",
+ {
+ "x": 9.6
+ },
+ "3,12",
+ "3,13",
+ "3,14",
+ {
+ "x": 1.85,
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ "4,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "4,1",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ {
+ "x": 9.95
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,14"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 17.7,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "y": -0.25
+ },
+ "5,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.7,
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -7.05,
+ "x": 5.4
+ },
+ "0,4",
+ "0,5",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "0,6",
+ "0,7"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 5.55,
+ "c": "#cccccc"
+ },
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7"
+ ],
+ [
+ {
+ "x": 5.0
+ },
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6"
+ ],
+ [
+ {
+ "x": 5.15
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,7"
+ ],
+ [
+ {
+ "x": 5.45
+ },
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7"
+ ],
+ [
+ {
+ "x": 5.45,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,3",
+ {
+ "w": 2.25
+ },
+ "5,5",
+ "5,7"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -4.25,
+ "x": 10.05
+ },
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc",
+ "x": 0.25
+ },
+ "0,10",
+ "0,11"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 9.5,
+ "c": "#cccccc"
+ },
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11"
+ ],
+ [
+ {
+ "x": 9.15
+ },
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11"
+ ],
+ [
+ {
+ "x": 9.5
+ },
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 8.95
+ },
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "x": 8.95,
+ "w": 2.55
+ },
+ "5,9",
+ "5,10",
+ "5,11"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k15_max/via_json/k15_max_jis_knob_rgb.json b/keyboards/keychron/k15_max/via_json/k15_max_jis_knob_rgb.json
new file mode 100644
index 0000000000..376d7e0aca
--- /dev/null
+++ b/keyboards/keychron/k15_max/via_json/k15_max_jis_knob_rgb.json
@@ -0,0 +1,395 @@
+{
+ "name": "Keychron K15 Max JIS Knob RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0AF2",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#aaaaaa",
+ "x": 0.5
+ },
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.5,
+ "c": "#777777"
+ },
+ "0,1\nESC",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ {
+ "x": 9.35
+ },
+ "0,12",
+ "0,13",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,15"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 0.75
+ },
+ "1,0",
+ {
+ "x": 0.5
+ },
+ "1,1",
+ {
+ "c": "#cccccc"
+ },
+ "1,2",
+ "1,3",
+ {
+ "x": 8.65
+ },
+ "1,12",
+ "1,13",
+ {
+ "c": "#aaaaaa"
+ },
+ "1,14",
+ "1,15",
+ {
+ "x": 0.6
+ },
+ "5,8"
+ ],
+ [
+ {
+ "x": 0.5
+ },
+ "2,0",
+ {
+ "x": 0.5,
+ "w": 1.5
+ },
+ "2,1",
+ {
+ "c": "#cccccc"
+ },
+ "2,2",
+ {
+ "x": 10.35
+ },
+ "2,12",
+ "2,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,14",
+ {
+ "x": 0.4
+ },
+ "2,15"
+ ],
+ [
+ {
+ "x": 0.25
+ },
+ "3,0",
+ {
+ "x": 0.5,
+ "w": 1.75
+ },
+ "3,1",
+ {
+ "c": "#cccccc"
+ },
+ "3,2",
+ {
+ "x": 9.6
+ },
+ "3,12",
+ "3,13",
+ "3,14",
+ {
+ "x": 1.85,
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ "4,0",
+ {
+ "x": 0.5,
+ "w": 2.25
+ },
+ "4,1",
+ {
+ "c": "#cccccc"
+ },
+ "4,3",
+ {
+ "x": 9.95
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa"
+ },
+ "4,14",
+ "4,15"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 17.7,
+ "c": "#cccccc"
+ },
+ "5,12"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "y": -0.25
+ },
+ "5,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "5,1",
+ "5,2",
+ "5,3"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.7,
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -7.05,
+ "x": 5.4
+ },
+ "0,4",
+ "0,5",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "0,6",
+ "0,7"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 5.55,
+ "c": "#cccccc"
+ },
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7"
+ ],
+ [
+ {
+ "x": 5.0
+ },
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6"
+ ],
+ [
+ {
+ "x": 5.15
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,7"
+ ],
+ [
+ {
+ "x": 5.45
+ },
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7"
+ ],
+ [
+ {
+ "x": 5.45,
+ "c": "#aaaaaa"
+ },
+ "5,4",
+ {
+ "w": 2.25
+ },
+ "5,5",
+ "5,7"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -4.25,
+ "x": 10.05
+ },
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc",
+ "x": 0.25
+ },
+ "0,10",
+ "0,11"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 9.5,
+ "c": "#cccccc"
+ },
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11"
+ ],
+ [
+ {
+ "x": 9.15
+ },
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11"
+ ],
+ [
+ {
+ "x": 9.5
+ },
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 8.95
+ },
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "x": 8.95,
+ "w": 2.55
+ },
+ "5,9",
+ "5,10",
+ "5,11"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k15_max/via_json/k15_max_jis_knob_white.json b/keyboards/keychron/k15_max/via_json/k15_max_jis_knob_white.json
new file mode 100644
index 0000000000..5b0869eb43
--- /dev/null
+++ b/keyboards/keychron/k15_max/via_json/k15_max_jis_knob_white.json
@@ -0,0 +1,334 @@
+{
+ "name": "Keychron K15 Max JIS White Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0AF5",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#aaaaaa",
+ "x": 0.5
+ },
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.5,
+ "c": "#777777"
+ },
+ "0,1\nESC",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ {
+ "x": 9.35
+ },
+ "0,12",
+ "0,13",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,15"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 0.75
+ },
+ "1,0",
+ {
+ "x": 0.5
+ },
+ "1,1",
+ {
+ "c": "#cccccc"
+ },
+ "1,2",
+ "1,3",
+ {
+ "x": 8.65
+ },
+ "1,12",
+ "1,13",
+ {
+ "c": "#aaaaaa"
+ },
+ "1,14",
+ "1,15",
+ {
+ "x": 0.6
+ },
+ "5,8"
+ ],
+ [
+ {
+ "x": 0.5
+ },
+ "2,0",
+ {
+ "x": 0.5,
+ "w": 1.5
+ },
+ "2,1",
+ {
+ "c": "#cccccc"
+ },
+ "2,2",
+ {
+ "x": 10.35
+ },
+ "2,12",
+ "2,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,14",
+ {
+ "x": 0.4
+ },
+ "2,15"
+ ],
+ [
+ {
+ "x": 0.25
+ },
+ "3,0",
+ {
+ "x": 0.5,
+ "w": 1.75
+ },
+ "3,1",
+ {
+ "c": "#cccccc"
+ },
+ "3,2",
+ {
+ "x": 9.6
+ },
+ "3,12",
+ "3,13",
+ "3,14",
+ {
+ "x": 1.85,
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ "4,0",
+ {
+ "x": 0.5,
+ "w": 2.25
+ },
+ "4,1",
+ {
+ "c": "#cccccc"
+ },
+ "4,3",
+ {
+ "x": 9.95
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa"
+ },
+ "4,14",
+ "4,15"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 17.7,
+ "c": "#cccccc"
+ },
+ "5,12"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "y": -0.25
+ },
+ "5,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "5,1",
+ "5,2",
+ "5,3"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.7,
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -7.05,
+ "x": 5.4
+ },
+ "0,4",
+ "0,5",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "0,6",
+ "0,7"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 5.55,
+ "c": "#cccccc"
+ },
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7"
+ ],
+ [
+ {
+ "x": 5.0
+ },
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6"
+ ],
+ [
+ {
+ "x": 5.15
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,7"
+ ],
+ [
+ {
+ "x": 5.45
+ },
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7"
+ ],
+ [
+ {
+ "x": 5.45,
+ "c": "#aaaaaa"
+ },
+ "5,4",
+ {
+ "w": 2.25
+ },
+ "5,5",
+ "5,7"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -4.25,
+ "x": 10.05
+ },
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc",
+ "x": 0.25
+ },
+ "0,10",
+ "0,11"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 9.5,
+ "c": "#cccccc"
+ },
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11"
+ ],
+ [
+ {
+ "x": 9.15
+ },
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11"
+ ],
+ [
+ {
+ "x": 9.5
+ },
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 8.95
+ },
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "x": 8.95,
+ "w": 2.55
+ },
+ "5,9",
+ "5,10",
+ "5,11"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k17_max/ansi_encoder/rgb/config.h b/keyboards/keychron/k17_max/ansi_encoder/rgb/config.h
new file mode 100644
index 0000000000..4c8b52f7e1
--- /dev/null
+++ b/keyboards/keychron/k17_max/ansi_encoder/rgb/config.h
@@ -0,0 +1,51 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 103
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define CAPS_LOCK_INDEX 57
+# define NUM_LOCK_INDEX 34
+# define LOW_BAT_IND_INDEX \
+ { 94 }
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 20, 21, 22 }
+# define P24G_INDICATION_LED_MATRIX_INDEX 23
+# define BAT_LEVEL_LED_LIST \
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k17_max/ansi_encoder/rgb/keyboard.json b/keyboards/keychron/k17_max/ansi_encoder/rgb/keyboard.json
new file mode 100644
index 0000000000..233f029566
--- /dev/null
+++ b/keyboards/keychron/k17_max/ansi_encoder/rgb/keyboard.json
@@ -0,0 +1,155 @@
+{
+ "usb": {
+ "pid": "0x0A00",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "C5", "B10"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "layouts": {
+ "LAYOUT_104_ansi": {
+ "layout": [
+ {"matrix":[0,0], "x":0, "y":0},
+ {"matrix":[0,1], "x":1, "y":0},
+ {"matrix":[0,2], "x":2, "y":0},
+ {"matrix":[0,3], "x":3, "y":0},
+ {"matrix":[0,4], "x":4, "y":0},
+ {"matrix":[0,5], "x":5, "y":0},
+ {"matrix":[0,6], "x":6, "y":0},
+ {"matrix":[0,7], "x":7, "y":0},
+ {"matrix":[0,8], "x":8, "y":0},
+ {"matrix":[0,9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14, "y":0},
+ {"matrix":[0,15], "x":15.25, "y":0},
+ {"matrix":[0,16], "x":16.5, "y":0},
+ {"matrix":[0,17], "x":17.5, "y":0},
+ {"matrix":[0,18], "x":18.5, "y":0},
+ {"matrix":[0,19], "x":19.5, "y":0},
+
+ {"matrix":[1,0], "x":0, "y":1.25},
+ {"matrix":[1,1], "x":1, "y":1.25},
+ {"matrix":[1,2], "x":2, "y":1.25},
+ {"matrix":[1,3], "x":3, "y":1.25},
+ {"matrix":[1,4], "x":4, "y":1.25},
+ {"matrix":[1,5], "x":5, "y":1.25},
+ {"matrix":[1,6], "x":6, "y":1.25},
+ {"matrix":[1,7], "x":7, "y":1.25},
+ {"matrix":[1,8], "x":8, "y":1.25},
+ {"matrix":[1,9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[1,14], "x":13, "y":1.25, "w":2},
+ {"matrix":[1,15], "x":15.25, "y":1.25},
+ {"matrix":[1,16], "x":16.5, "y":1.25},
+ {"matrix":[1,17], "x":17.5, "y":1.25},
+ {"matrix":[1,18], "x":18.5, "y":1.25},
+ {"matrix":[1,19], "x":19.5, "y":1.25},
+
+ {"matrix":[2,0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2,1], "x":1.5, "y":2.25},
+ {"matrix":[2,2], "x":2.5, "y":2.25},
+ {"matrix":[2,3], "x":3.5, "y":2.25},
+ {"matrix":[2,4], "x":4.5, "y":2.25},
+ {"matrix":[2,5], "x":5.5, "y":2.25},
+ {"matrix":[2,6], "x":6.5, "y":2.25},
+ {"matrix":[2,7], "x":7.5, "y":2.25},
+ {"matrix":[2,8], "x":8.5, "y":2.25},
+ {"matrix":[2,9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,14], "x":13.5, "y":2.25, "w":1.5},
+ {"matrix":[2,15], "x":15.25, "y":2.25},
+ {"matrix":[2,16], "x":16.5, "y":2.25},
+ {"matrix":[2,17], "x":17.5, "y":2.25},
+ {"matrix":[2,18], "x":18.5, "y":2.25},
+ {"matrix":[2,19], "x":19.5, "y":2.25, "h":2},
+
+ {"matrix":[3,0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3,1], "x":1.75, "y":3.25},
+ {"matrix":[3,2], "x":2.75, "y":3.25},
+ {"matrix":[3,3], "x":3.75, "y":3.25},
+ {"matrix":[3,4], "x":4.75, "y":3.25},
+ {"matrix":[3,5], "x":5.75, "y":3.25},
+ {"matrix":[3,6], "x":6.75, "y":3.25},
+ {"matrix":[3,7], "x":7.75, "y":3.25},
+ {"matrix":[3,8], "x":8.75, "y":3.25},
+ {"matrix":[3,9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,13], "x":12.75, "y":3.25, "w":2.25},
+ {"matrix":[3,15], "x":15.25, "y":3.25},
+ {"matrix":[3,16], "x":16.5, "y":3.25},
+ {"matrix":[3,17], "x":17.5, "y":3.25},
+ {"matrix":[3,18], "x":18.5, "y":3.25},
+
+ {"matrix":[4,0], "x":0, "y":4.25, "w":2.25},
+ {"matrix":[4,2], "x":2.25, "y":4.25},
+ {"matrix":[4,3], "x":3.25, "y":4.25},
+ {"matrix":[4,4], "x":4.25, "y":4.25},
+ {"matrix":[4,5], "x":5.25, "y":4.25},
+ {"matrix":[4,6], "x":6.25, "y":4.25},
+ {"matrix":[4,7], "x":7.25, "y":4.25},
+ {"matrix":[4,8], "x":8.25, "y":4.25},
+ {"matrix":[4,9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25, "y":4.25},
+ {"matrix":[4,11], "x":11.25, "y":4.25},
+ {"matrix":[4,12], "x":12.25, "y":4.25, "w":1.75},
+ {"matrix":[4,14], "x":14.25, "y":4.25},
+ {"matrix":[4,16], "x":16.5, "y":4.25},
+ {"matrix":[4,17], "x":17.5, "y":4.25},
+ {"matrix":[4,18], "x":18.5, "y":4.25},
+ {"matrix":[4,19], "x":19.5, "y":4.25, "h":2},
+
+ {"matrix":[5,0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5,1], "x":1.25, "y":5.25, "w":1.25},
+ {"matrix":[5,2], "x":2.5, "y":5.25, "w":1.25},
+ {"matrix":[5,6], "x":3.75, "y":5.25, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5.25},
+ {"matrix":[5,11], "x":11, "y":5.25},
+ {"matrix":[5,12], "x":12, "y":5.25},
+ {"matrix":[5,13], "x":13.25, "y":5.25},
+ {"matrix":[5,14], "x":14.25, "y":5.25},
+ {"matrix":[5,15], "x":15.25, "y":5.25},
+ {"matrix":[5,16], "x":16.5, "y":5.25, "w":2},
+ {"matrix":[5,18], "x":18.5, "y":5.25}
+ ]
+ }
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k17_max/ansi_encoder/rgb/keymaps/default/keymap.c b/keyboards/keychron/k17_max/ansi_encoder/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..79c6b560fb
--- /dev/null
+++ b/keyboards/keychron/k17_max/ansi_encoder/rgb/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_104_ansi(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, RGB_MOD, KC_DEL, KC_F13, KC_F14, KC_F15, KC_MUTE,
+ 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_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_HOME, KC_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+
+ [MAC_FN] = LAYOUT_104_ansi(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, RGB_TOG, _______, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+
+ [WIN_BASE] = LAYOUT_104_ansi(
+ 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, RGB_MOD, KC_DEL, _______, _______, _______, KC_MUTE,
+ 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_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_HOME, KC_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+
+ [WIN_FN] = LAYOUT_104_ansi(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG, _______, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k17_max/ansi_encoder/rgb/rgb.c b/keyboards/keychron/k17_max/ansi_encoder/rgb/rgb.c
new file mode 100644
index 0000000000..372f60017d
--- /dev/null
+++ b/keyboards/keychron/k17_max/ansi_encoder/rgb/rgb.c
@@ -0,0 +1,169 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB4_CA8, CB6_CA8, CB5_CA8},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+
+ {0, CB3_CA1, CB1_CA1, CB2_CA1},
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA15, CB1_CA15, CB2_CA15},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB10_CA10, CB12_CA10, CB11_CA10},
+ {1, CB10_CA11, CB12_CA11, CB11_CA11},
+ {1, CB10_CA12, CB12_CA12, CB11_CA12},
+ {1, CB10_CA13, CB12_CA13, CB11_CA13},
+
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB10_CA14, CB12_CA14, CB11_CA14},
+ {1, CB10_CA16, CB12_CA16, CB11_CA16}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to RGB Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, __ },
+ { 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, __, 32, 33, 34, 35, 36, 37 },
+ { 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, __, 51, 52, 53, 54, 55, 56 },
+ { 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, __, 69, __, 70, 71, 72, 73, __ },
+ { 74, __, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, __, 86, __, 87, 88, 89, 90 },
+ { 91, 92, 93, __, __, __, 94, __, __, __, 95, 96, 97, 98, 99,100,101,__, 102, __ },
+ },
+ {
+ // RGB Index to Physical Position
+ {0, 0}, {12, 0}, {24, 0}, {36, 0}, {48, 0}, {60, 0}, {72, 0}, {84, 0}, {96, 0}, {108, 0}, {120, 0}, {132, 0}, {144, 0}, {156, 0}, {168, 0}, {180, 0},{192, 0},{203, 0},{213, 0},
+ {0,13}, {12,13}, {24,13}, {36,13}, {48,13}, {60,13}, {72,13}, {84,13}, {96,13}, {108,13}, {120,13}, {132,13}, {144,13}, {162,13}, {180,13},{192,13},{203,13},{213,13},{224,13},
+ {2,26}, {18,26}, {30,26}, {42,26}, {54,26}, {66,26}, {78,26}, {90,26}, {102,26},{114,26}, {126,26}, {138,26}, {150,26}, {164,26}, {180,26},{192,26},{203,26},{213,26},{224,32},
+ {4,39}, {22,39}, {34,39}, {46,39}, {58,39}, {70,39}, {82,39}, {94,39}, {106,39},{118,39}, {130,39}, {142,39}, {163,39}, {180,39},{192,39},{203,39},{213,39},
+ {8,51}, {28,51}, {40,51}, {52,51}, {64,51}, {76,51}, {88,51}, {100,51},{112,51}, {124,51}, {136,51}, {148,51}, {168,51}, {192,51},{203,51},{213,51},{224,57},
+ {1,64}, {16,64}, {30,64}, {78,64}, {120,64}, {132,64}, {144,64}, {156,64}, {168,64}, {180,64},{197,64}, {213,64},
+ },
+ {
+ // RGB Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k17_max/ansi_encoder/rgb/rules.mk b/keyboards/keychron/k17_max/ansi_encoder/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k17_max/ansi_encoder/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k17_max/ansi_encoder/white/config.h b/keyboards/keychron/k17_max/ansi_encoder/white/config.h
new file mode 100644
index 0000000000..d588e37163
--- /dev/null
+++ b/keyboards/keychron/k17_max/ansi_encoder/white/config.h
@@ -0,0 +1,52 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED Matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 103
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Scan phase of led driver set as SNLED27351_SCAN_PHASE_8_CHANNEL */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_8_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 57
+# define P24G_INDICATION_LED_MATRIX_INDEX 23
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 20, 21, 22 }
+# define BAT_LEVEL_LED_LIST \
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29 }
+# define LOW_BAT_IND_INDEX \
+ { 94 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k17_max/ansi_encoder/white/keyboard.json b/keyboards/keychron/k17_max/ansi_encoder/white/keyboard.json
new file mode 100644
index 0000000000..9fffeb4ff2
--- /dev/null
+++ b/keyboards/keychron/k17_max/ansi_encoder/white/keyboard.json
@@ -0,0 +1,154 @@
+{
+ "usb": {
+ "pid": "0x0A03",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "indicators": {
+ "caps_lock": "A13",
+ "num_lock": "B10",
+ "on_state": 1
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "C5", "B10"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "layouts": {
+ "LAYOUT_104_ansi": {
+ "layout": [
+ {"matrix":[0,0], "x":0, "y":0},
+ {"matrix":[0,1], "x":1, "y":0},
+ {"matrix":[0,2], "x":2, "y":0},
+ {"matrix":[0,3], "x":3, "y":0},
+ {"matrix":[0,4], "x":4, "y":0},
+ {"matrix":[0,5], "x":5, "y":0},
+ {"matrix":[0,6], "x":6, "y":0},
+ {"matrix":[0,7], "x":7, "y":0},
+ {"matrix":[0,8], "x":8, "y":0},
+ {"matrix":[0,9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14, "y":0},
+ {"matrix":[0,15], "x":15.25, "y":0},
+ {"matrix":[0,16], "x":16.5, "y":0},
+ {"matrix":[0,17], "x":17.5, "y":0},
+ {"matrix":[0,18], "x":18.5, "y":0},
+ {"matrix":[0,19], "x":19.5, "y":0},
+
+ {"matrix":[1,0], "x":0, "y":1.25},
+ {"matrix":[1,1], "x":1, "y":1.25},
+ {"matrix":[1,2], "x":2, "y":1.25},
+ {"matrix":[1,3], "x":3, "y":1.25},
+ {"matrix":[1,4], "x":4, "y":1.25},
+ {"matrix":[1,5], "x":5, "y":1.25},
+ {"matrix":[1,6], "x":6, "y":1.25},
+ {"matrix":[1,7], "x":7, "y":1.25},
+ {"matrix":[1,8], "x":8, "y":1.25},
+ {"matrix":[1,9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[1,14], "x":13, "y":1.25, "w":2},
+ {"matrix":[1,15], "x":15.25, "y":1.25},
+ {"matrix":[1,16], "x":16.5, "y":1.25},
+ {"matrix":[1,17], "x":17.5, "y":1.25},
+ {"matrix":[1,18], "x":18.5, "y":1.25},
+ {"matrix":[1,19], "x":19.5, "y":1.25},
+
+ {"matrix":[2,0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2,1], "x":1.5, "y":2.25},
+ {"matrix":[2,2], "x":2.5, "y":2.25},
+ {"matrix":[2,3], "x":3.5, "y":2.25},
+ {"matrix":[2,4], "x":4.5, "y":2.25},
+ {"matrix":[2,5], "x":5.5, "y":2.25},
+ {"matrix":[2,6], "x":6.5, "y":2.25},
+ {"matrix":[2,7], "x":7.5, "y":2.25},
+ {"matrix":[2,8], "x":8.5, "y":2.25},
+ {"matrix":[2,9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,14], "x":13.5, "y":2.25, "w":1.5},
+ {"matrix":[2,15], "x":15.25, "y":2.25},
+ {"matrix":[2,16], "x":16.5, "y":2.25},
+ {"matrix":[2,17], "x":17.5, "y":2.25},
+ {"matrix":[2,18], "x":18.5, "y":2.25},
+ {"matrix":[2,19], "x":19.5, "y":2.25, "h":2},
+
+ {"matrix":[3,0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3,1], "x":1.75, "y":3.25},
+ {"matrix":[3,2], "x":2.75, "y":3.25},
+ {"matrix":[3,3], "x":3.75, "y":3.25},
+ {"matrix":[3,4], "x":4.75, "y":3.25},
+ {"matrix":[3,5], "x":5.75, "y":3.25},
+ {"matrix":[3,6], "x":6.75, "y":3.25},
+ {"matrix":[3,7], "x":7.75, "y":3.25},
+ {"matrix":[3,8], "x":8.75, "y":3.25},
+ {"matrix":[3,9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,13], "x":12.75, "y":3.25, "w":2.25},
+ {"matrix":[3,15], "x":15.25, "y":3.25},
+ {"matrix":[3,16], "x":16.5, "y":3.25},
+ {"matrix":[3,17], "x":17.5, "y":3.25},
+ {"matrix":[3,18], "x":18.5, "y":3.25},
+
+ {"matrix":[4,0], "x":0, "y":4.25, "w":2.25},
+ {"matrix":[4,2], "x":2.25, "y":4.25},
+ {"matrix":[4,3], "x":3.25, "y":4.25},
+ {"matrix":[4,4], "x":4.25, "y":4.25},
+ {"matrix":[4,5], "x":5.25, "y":4.25},
+ {"matrix":[4,6], "x":6.25, "y":4.25},
+ {"matrix":[4,7], "x":7.25, "y":4.25},
+ {"matrix":[4,8], "x":8.25, "y":4.25},
+ {"matrix":[4,9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25, "y":4.25},
+ {"matrix":[4,11], "x":11.25, "y":4.25},
+ {"matrix":[4,12], "x":12.25, "y":4.25, "w":1.75},
+ {"matrix":[4,14], "x":14.25, "y":4.25},
+ {"matrix":[4,16], "x":16.5, "y":4.25},
+ {"matrix":[4,17], "x":17.5, "y":4.25},
+ {"matrix":[4,18], "x":18.5, "y":4.25},
+ {"matrix":[4,19], "x":19.5, "y":4.25, "h":2},
+
+ {"matrix":[5,0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5,1], "x":1.25, "y":5.25, "w":1.25},
+ {"matrix":[5,2], "x":2.5, "y":5.25, "w":1.25},
+ {"matrix":[5,6], "x":3.75, "y":5.25, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5.25},
+ {"matrix":[5,11], "x":11, "y":5.25},
+ {"matrix":[5,12], "x":12, "y":5.25},
+ {"matrix":[5,13], "x":13.25, "y":5.25},
+ {"matrix":[5,14], "x":14.25, "y":5.25},
+ {"matrix":[5,15], "x":15.25, "y":5.25},
+ {"matrix":[5,16], "x":16.5, "y":5.25, "w":2},
+ {"matrix":[5,18], "x":18.5, "y":5.25}
+ ]
+ }
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k17_max/ansi_encoder/white/keymaps/default/keymap.c b/keyboards/keychron/k17_max/ansi_encoder/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..8cb1ade15a
--- /dev/null
+++ b/keyboards/keychron/k17_max/ansi_encoder/white/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_104_ansi(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, BL_STEP, KC_DEL, KC_F13, KC_F14, KC_F15, KC_MUTE,
+ 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_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_HOME, KC_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+
+ [MAC_FN] = LAYOUT_104_ansi(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, BL_TOGG, _______, _______, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+
+ [WIN_BASE] = LAYOUT_104_ansi(
+ 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, BL_STEP, KC_DEL, _______, _______, _______, KC_MUTE,
+ 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_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_HOME, KC_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+
+ [WIN_FN] = LAYOUT_104_ansi(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, BL_TOGG, _______, _______, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(BL_DOWN, BL_UP)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(BL_DOWN, BL_UP)},
+};
+#endif
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k17_max/ansi_encoder/white/rules.mk b/keyboards/keychron/k17_max/ansi_encoder/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k17_max/ansi_encoder/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k17_max/ansi_encoder/white/white.c b/keyboards/keychron/k17_max/ansi_encoder/white/white.c
new file mode 100644
index 0000000000..e1c110d65e
--- /dev/null
+++ b/keyboards/keychron/k17_max/ansi_encoder/white/white.c
@@ -0,0 +1,168 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA5},
+ {0, CB6_CA6},
+ {0, CB6_CA7},
+ {0, CB6_CA8},
+ {0, CB6_CA9},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA14},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+ {0, CB1_CA8},
+ {0, CB1_CA9},
+ {0, CB1_CA10},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+ {0, CB8_CA7},
+ {0, CB8_CA8},
+ {0, CB8_CA9},
+ {0, CB8_CA10},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA15},
+ {0, CB4_CA16},
+ {0, CB8_CA12},
+ {0, CB8_CA13},
+ {0, CB8_CA14},
+ {0, CB8_CA15},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+ {0, CB7_CA7},
+ {0, CB7_CA8},
+ {0, CB7_CA9},
+
+ {0, CB2_CA1},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA15},
+ {0, CB7_CA10},
+ {0, CB7_CA11},
+ {0, CB7_CA12},
+ {0, CB7_CA13},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA7},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+ {0, CB7_CA14},
+ {0, CB7_CA16},
+
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, __ },
+ { 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, __, 32, 33, 34, 35, 36, 37 },
+ { 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, __, 51, 52, 53, 54, 55, 56 },
+ { 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, __, 69, __, 70, 71, 72, 73, __ },
+ { 74, __, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, __, 86, __, 87, 88, 89, 90 },
+ { 91, 92, 93, __, __, __, 94, __, __, __, 95, 96, 97, 98, 99,100,101,__, 102, __ },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {12, 0}, {24, 0}, {36, 0}, {48, 0}, {60, 0}, {72, 0}, {84, 0}, {96, 0}, {108, 0}, {120, 0}, {132, 0}, {144, 0}, {156, 0}, {168, 0}, {180, 0},{192, 0},{203, 0},{213, 0},
+ {0,13}, {12,13}, {24,13}, {36,13}, {48,13}, {60,13}, {72,13}, {84,13}, {96,13}, {108,13}, {120,13}, {132,13}, {144,13}, {162,13}, {180,13},{192,13},{203,13},{213,13},{224,13},
+ {2,26}, {18,26}, {30,26}, {42,26}, {54,26}, {66,26}, {78,26}, {90,26}, {102,26},{114,26}, {126,26}, {138,26}, {150,26}, {164,26}, {180,26},{192,26},{203,26},{213,26},{224,32},
+ {4,39}, {22,39}, {34,39}, {46,39}, {58,39}, {70,39}, {82,39}, {94,39}, {106,39},{118,39}, {130,39}, {142,39}, {163,39}, {180,39},{192,39},{203,39},{213,39},
+ {8,51}, {28,51}, {40,51}, {52,51}, {64,51}, {76,51}, {88,51}, {100,51},{112,51}, {124,51}, {136,51}, {148,51}, {168,51}, {192,51},{203,51},{213,51},{224,57},
+ {1,64}, {16,64}, {30,64}, {78,64}, {120,64}, {132,64}, {144,64}, {156,64}, {168,64}, {180,64},{197,64}, {213,64},
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k17_max/board.h b/keyboards/keychron/k17_max/board.h
new file mode 100644
index 0000000000..d869d8a76e
--- /dev/null
+++ b/keyboards/keychron/k17_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/k17_max/config.h b/keyboards/keychron/k17_max/config.h
new file mode 100644
index 0000000000..70f1a1b179
--- /dev/null
+++ b/keyboards/keychron/k17_max/config.h
@@ -0,0 +1,73 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define FN_BL_TRIG_KEY KC_END
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/k17_max/halconf.h b/keyboards/keychron/k17_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/k17_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/k17_max/info.json b/keyboards/keychron/k17_max/info.json
new file mode 100644
index 0000000000..e7a5c52f9d
--- /dev/null
+++ b/keyboards/keychron/k17_max/info.json
@@ -0,0 +1,44 @@
+{
+ "keyboard_name": "Keychron K17 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "Keychron",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey": true,
+ "mousekey": true,
+ "dip_switch": true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro": true,
+ "raw": true,
+ "send_string": true
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch": {
+ "pins": ["B14"]
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "A8",
+ "pin_b": "C9"
+ }
+ ]
+ },
+ "dynamic_keymap": {
+ "layer_count": 4
+ }
+}
diff --git a/keyboards/keychron/k17_max/iso_encoder/rgb/config.h b/keyboards/keychron/k17_max/iso_encoder/rgb/config.h
new file mode 100644
index 0000000000..b179b1cb1b
--- /dev/null
+++ b/keyboards/keychron/k17_max/iso_encoder/rgb/config.h
@@ -0,0 +1,51 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 104
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define CAPS_LOCK_INDEX 57
+# define NUM_LOCK_INDEX 34
+# define LOW_BAT_IND_INDEX \
+ { 95 }
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 20, 21, 22 }
+# define P24G_INDICATION_LED_MATRIX_INDEX 23
+# define BAT_LEVEL_LED_LIST \
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k17_max/iso_encoder/rgb/keyboard.json b/keyboards/keychron/k17_max/iso_encoder/rgb/keyboard.json
new file mode 100644
index 0000000000..3a1c5fb3db
--- /dev/null
+++ b/keyboards/keychron/k17_max/iso_encoder/rgb/keyboard.json
@@ -0,0 +1,156 @@
+{
+ "usb": {
+ "pid": "0x0A01",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "C5", "B10"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "layouts":{
+ "LAYOUT_105_iso": {
+ "layout": [
+ {"matrix":[0,0], "x":0, "y":0},
+ {"matrix":[0,1], "x":1, "y":0},
+ {"matrix":[0,2], "x":2, "y":0},
+ {"matrix":[0,3], "x":3, "y":0},
+ {"matrix":[0,4], "x":4, "y":0},
+ {"matrix":[0,5], "x":5, "y":0},
+ {"matrix":[0,6], "x":6, "y":0},
+ {"matrix":[0,7], "x":7, "y":0},
+ {"matrix":[0,8], "x":8, "y":0},
+ {"matrix":[0,9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14, "y":0},
+ {"matrix":[0,15], "x":15.25, "y":0},
+ {"matrix":[0,16], "x":16.5, "y":0},
+ {"matrix":[0,17], "x":17.5, "y":0},
+ {"matrix":[0,18], "x":18.5, "y":0},
+ {"matrix":[0,19], "x":19.5, "y":0},
+
+ {"matrix":[1,0], "x":0, "y":1.25},
+ {"matrix":[1,1], "x":1, "y":1.25},
+ {"matrix":[1,2], "x":2, "y":1.25},
+ {"matrix":[1,3], "x":3, "y":1.25},
+ {"matrix":[1,4], "x":4, "y":1.25},
+ {"matrix":[1,5], "x":5, "y":1.25},
+ {"matrix":[1,6], "x":6, "y":1.25},
+ {"matrix":[1,7], "x":7, "y":1.25},
+ {"matrix":[1,8], "x":8, "y":1.25},
+ {"matrix":[1,9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[1,14], "x":13, "y":1.25, "w":2},
+ {"matrix":[1,15], "x":15.25, "y":1.25},
+ {"matrix":[1,16], "x":16.5, "y":1.25},
+ {"matrix":[1,17], "x":17.5, "y":1.25},
+ {"matrix":[1,18], "x":18.5, "y":1.25},
+ {"matrix":[1,19], "x":19.5, "y":1.25},
+
+ {"matrix":[2,0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2,1], "x":1.5, "y":2.25},
+ {"matrix":[2,2], "x":2.5, "y":2.25},
+ {"matrix":[2,3], "x":3.5, "y":2.25},
+ {"matrix":[2,4], "x":4.5, "y":2.25},
+ {"matrix":[2,5], "x":5.5, "y":2.25},
+ {"matrix":[2,6], "x":6.5, "y":2.25},
+ {"matrix":[2,7], "x":7.5, "y":2.25},
+ {"matrix":[2,8], "x":8.5, "y":2.25},
+ {"matrix":[2,9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,15], "x":15.25, "y":2.25},
+ {"matrix":[2,16], "x":16.5, "y":2.25},
+ {"matrix":[2,17], "x":17.5, "y":2.25},
+ {"matrix":[2,18], "x":18.5, "y":2.25},
+ {"matrix":[2,19], "x":19.5, "y":2.25, "h":2},
+
+ {"matrix":[3,0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3,1], "x":1.75, "y":3.25},
+ {"matrix":[3,2], "x":2.75, "y":3.25},
+ {"matrix":[3,3], "x":3.75, "y":3.25},
+ {"matrix":[3,4], "x":4.75, "y":3.25},
+ {"matrix":[3,5], "x":5.75, "y":3.25},
+ {"matrix":[3,6], "x":6.75, "y":3.25},
+ {"matrix":[3,7], "x":7.75, "y":3.25},
+ {"matrix":[3,8], "x":8.75, "y":3.25},
+ {"matrix":[3,9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,13], "x":12.75, "y":3.25},
+ {"matrix":[2,14], "x":13.75, "y":2.25, "w":1.25, "h": 2},
+ {"matrix":[3,15], "x":15.25, "y":3.25},
+ {"matrix":[3,16], "x":16.5, "y":3.25},
+ {"matrix":[3,17], "x":17.5, "y":3.25},
+ {"matrix":[3,18], "x":18.5, "y":3.25},
+
+ {"matrix":[4,0], "x":0, "y":4.25, "w":1.25},
+ {"matrix":[4,1], "x":1.25, "y":4.25},
+ {"matrix":[4,2], "x":2.25, "y":4.25},
+ {"matrix":[4,3], "x":3.25, "y":4.25},
+ {"matrix":[4,4], "x":4.25, "y":4.25},
+ {"matrix":[4,5], "x":5.25, "y":4.25},
+ {"matrix":[4,6], "x":6.25, "y":4.25},
+ {"matrix":[4,7], "x":7.25, "y":4.25},
+ {"matrix":[4,8], "x":8.25, "y":4.25},
+ {"matrix":[4,9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25, "y":4.25},
+ {"matrix":[4,11], "x":11.25, "y":4.25},
+ {"matrix":[4,12], "x":12.25, "y":4.25, "w":1.75},
+ {"matrix":[4,14], "x":14.25, "y":4.25},
+ {"matrix":[4,16], "x":16.5, "y":4.25},
+ {"matrix":[4,17], "x":17.5, "y":4.25},
+ {"matrix":[4,18], "x":18.5, "y":4.25},
+ {"matrix":[4,19], "x":19.5, "y":4.25, "h":2},
+
+ {"matrix":[5,0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5,1], "x":1.25, "y":5.25, "w":1.25},
+ {"matrix":[5,2], "x":2.5, "y":5.25, "w":1.25},
+ {"matrix":[5,6], "x":3.75, "y":5.25, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5.25},
+ {"matrix":[5,11], "x":11, "y":5.25},
+ {"matrix":[5,12], "x":12, "y":5.25},
+ {"matrix":[5,13], "x":13.25, "y":5.25},
+ {"matrix":[5,14], "x":14.25, "y":5.25},
+ {"matrix":[5,15], "x":15.25, "y":5.25},
+ {"matrix":[5,16], "x":16.5, "y":5.25, "w":2},
+ {"matrix":[5,18], "x":18.5, "y":5.25}
+ ]
+ }
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k17_max/iso_encoder/rgb/keymaps/default/keymap.c b/keyboards/keychron/k17_max/iso_encoder/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..14ec487fe8
--- /dev/null
+++ b/keyboards/keychron/k17_max/iso_encoder/rgb/keymaps/default/keymap.c
@@ -0,0 +1,74 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_105_iso(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, RGB_MOD, KC_DEL, KC_F13, KC_F14, KC_F15, KC_MUTE,
+ 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_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_HOME, KC_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+ [MAC_FN] = LAYOUT_105_iso(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, RGB_TOG, _______, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+ [WIN_BASE] = LAYOUT_105_iso(
+ 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, RGB_MOD, KC_DEL, _______, _______, _______, KC_MUTE,
+ 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_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_HOME, KC_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+ [WIN_FN] = LAYOUT_105_iso(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG, _______, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k17_max/iso_encoder/rgb/rgb.c b/keyboards/keychron/k17_max/iso_encoder/rgb/rgb.c
new file mode 100644
index 0000000000..fd1d638abe
--- /dev/null
+++ b/keyboards/keychron/k17_max/iso_encoder/rgb/rgb.c
@@ -0,0 +1,170 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB4_CA8, CB6_CA8, CB5_CA8},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+
+ {0, CB3_CA1, CB1_CA1, CB2_CA1},
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA15, CB1_CA15, CB2_CA15},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB10_CA10, CB12_CA10, CB11_CA10},
+ {1, CB10_CA11, CB12_CA11, CB11_CA11},
+ {1, CB10_CA12, CB12_CA12, CB11_CA12},
+ {1, CB10_CA13, CB12_CA13, CB11_CA13},
+
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB10_CA14, CB12_CA14, CB11_CA14},
+ {1, CB10_CA16, CB12_CA16, CB11_CA16}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to RGB Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, __ },
+ { 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, __, 32, 33, 34, 35, 36, 37 },
+ { 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, __, 51, 52, 53, 54, 55, 56 },
+ { 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, __, 69, __, 70, 71, 72, 73, __ },
+ { 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, __, 87, __, 88, 89, 90, 91 },
+ { 92, 93, 94, __, __, __, 95, __, __, __, 96, 97, 98, 99,100,101,102, __,103, __ },
+ },
+ {
+ // RGB Index to Physical Position
+ {0, 0}, {12, 0}, {24, 0}, {36, 0}, {48, 0}, {60, 0}, {72, 0}, {84, 0}, {96, 0}, {108, 0}, {120, 0}, {132, 0}, {144, 0}, {156, 0}, {168, 0}, {180, 0},{192, 0},{203, 0},{213, 0},
+ {0,13}, {12,13}, {24,13}, {36,13}, {48,13}, {60,13}, {72,13}, {84,13}, {96,13}, {108,13}, {120,13}, {132,13}, {144,13}, {162,13}, {180,13},{192,13},{203,13},{213,13},{224,13},
+ {2,26}, {18,26}, {30,26}, {42,26}, {54,26}, {66,26}, {78,26}, {90,26}, {102,26},{114,26}, {126,26}, {138,26}, {150,26}, {164,32}, {180,26},{192,26},{203,26},{213,26},{224,32},
+ {4,39}, {22,39}, {34,39}, {46,39}, {58,39}, {70,39}, {82,39}, {94,39}, {106,39},{118,39}, {130,39}, {142,39}, {154,39}, {180,39},{192,39},{203,39},{213,39},
+ {1,51}, {14,51}, {28,51}, {40,51}, {52,51}, {64,51}, {76,51}, {88,51}, {100,51},{112,51}, {124,51}, {136,51}, {148,51}, {168,51}, {192,51},{203,51},{213,51},{224,57},
+ {1,64}, {16,64}, {30,64}, {78,64}, {120,64}, {132,64}, {144,64}, {156,64}, {168,64}, {180,64},{197,64}, {213,64},
+ },
+ {
+ // RGB Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k17_max/iso_encoder/rgb/rules.mk b/keyboards/keychron/k17_max/iso_encoder/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k17_max/iso_encoder/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k17_max/iso_encoder/white/config.h b/keyboards/keychron/k17_max/iso_encoder/white/config.h
new file mode 100644
index 0000000000..246d471b5e
--- /dev/null
+++ b/keyboards/keychron/k17_max/iso_encoder/white/config.h
@@ -0,0 +1,53 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED Matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 104
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 54
+# define DIM_NUM_LOCK
+# define NUM_LOCK_INDEX 33
+# define LOW_BAT_IND_INDEX \
+ { 93 }
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 19, 20, 21 }
+# define P24G_INDICATION_LED_MATRIX_INDEX 22
+# define BAT_LEVEL_LED_LIST \
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k17_max/iso_encoder/white/keyboard.json b/keyboards/keychron/k17_max/iso_encoder/white/keyboard.json
new file mode 100644
index 0000000000..edf2b77f24
--- /dev/null
+++ b/keyboards/keychron/k17_max/iso_encoder/white/keyboard.json
@@ -0,0 +1,155 @@
+{
+ "usb": {
+ "pid": "0x0A04",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "indicators": {
+ "caps_lock": "A13",
+ "num_lock": "B10",
+ "on_state": 1
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "layouts":{
+ "LAYOUT_105_iso": {
+ "layout": [
+ {"matrix":[0,0], "x":0, "y":0},
+ {"matrix":[0,1], "x":1, "y":0},
+ {"matrix":[0,2], "x":2, "y":0},
+ {"matrix":[0,3], "x":3, "y":0},
+ {"matrix":[0,4], "x":4, "y":0},
+ {"matrix":[0,5], "x":5, "y":0},
+ {"matrix":[0,6], "x":6, "y":0},
+ {"matrix":[0,7], "x":7, "y":0},
+ {"matrix":[0,8], "x":8, "y":0},
+ {"matrix":[0,9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":14, "y":0},
+ {"matrix":[0,14], "x":15.25, "y":0},
+ {"matrix":[0,15], "x":16.5, "y":0},
+ {"matrix":[0,16], "x":17.5, "y":0},
+ {"matrix":[0,17], "x":18.5, "y":0},
+ {"matrix":[5,4], "x":19.5, "y":0},
+
+ {"matrix":[1,0], "x":0, "y":1.25},
+ {"matrix":[1,1], "x":1, "y":1.25},
+ {"matrix":[1,2], "x":2, "y":1.25},
+ {"matrix":[1,3], "x":3, "y":1.25},
+ {"matrix":[1,4], "x":4, "y":1.25},
+ {"matrix":[1,5], "x":5, "y":1.25},
+ {"matrix":[1,6], "x":6, "y":1.25},
+ {"matrix":[1,7], "x":7, "y":1.25},
+ {"matrix":[1,8], "x":8, "y":1.25},
+ {"matrix":[1,9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[1,13], "x":13, "y":1.25, "w":2},
+ {"matrix":[1,14], "x":15.25, "y":1.25},
+ {"matrix":[1,15], "x":16.5, "y":1.25},
+ {"matrix":[1,16], "x":17.5, "y":1.25},
+ {"matrix":[1,17], "x":18.5, "y":1.25},
+ {"matrix":[5,5], "x":19.5, "y":1.25},
+
+ {"matrix":[2,0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2,1], "x":1.5, "y":2.25},
+ {"matrix":[2,2], "x":2.5, "y":2.25},
+ {"matrix":[2,3], "x":3.5, "y":2.25},
+ {"matrix":[2,4], "x":4.5, "y":2.25},
+ {"matrix":[2,5], "x":5.5, "y":2.25},
+ {"matrix":[2,6], "x":6.5, "y":2.25},
+ {"matrix":[2,7], "x":7.5, "y":2.25},
+ {"matrix":[2,8], "x":8.5, "y":2.25},
+ {"matrix":[2,9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,14], "x":15.25, "y":2.25},
+ {"matrix":[2,15], "x":16.5, "y":2.25},
+ {"matrix":[2,16], "x":17.5, "y":2.25},
+ {"matrix":[2,17], "x":18.5, "y":2.25},
+ {"matrix":[5,7], "x":19.5, "y":2.25, "h":2},
+
+ {"matrix":[3,0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3,1], "x":1.75, "y":3.25},
+ {"matrix":[3,2], "x":2.75, "y":3.25},
+ {"matrix":[3,3], "x":3.75, "y":3.25},
+ {"matrix":[3,4], "x":4.75, "y":3.25},
+ {"matrix":[3,5], "x":5.75, "y":3.25},
+ {"matrix":[3,6], "x":6.75, "y":3.25},
+ {"matrix":[3,7], "x":7.75, "y":3.25},
+ {"matrix":[3,8], "x":8.75, "y":3.25},
+ {"matrix":[3,9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,13], "x":12.75, "y":3.25},
+ {"matrix":[2,13], "x":13.75, "y":2.25, "w":1.25, "h":2},
+ {"matrix":[3,14], "x":15.25, "y":3.25},
+ {"matrix":[3,15], "x":16.5, "y":3.25},
+ {"matrix":[3,16], "x":17.5, "y":3.25},
+ {"matrix":[3,17], "x":18.5, "y":3.25},
+
+ {"matrix":[4,0], "x":0, "y":4.25, "w":1.25},
+ {"matrix":[4,1], "x":1.25, "y":4.25},
+ {"matrix":[4,2], "x":2.25, "y":4.25},
+ {"matrix":[4,3], "x":3.25, "y":4.25},
+ {"matrix":[4,4], "x":4.25, "y":4.25},
+ {"matrix":[4,5], "x":5.25, "y":4.25},
+ {"matrix":[4,6], "x":6.25, "y":4.25},
+ {"matrix":[4,7], "x":7.25, "y":4.25},
+ {"matrix":[4,8], "x":8.25, "y":4.25},
+ {"matrix":[4,9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25, "y":4.25},
+ {"matrix":[4,11], "x":11.25, "y":4.25},
+ {"matrix":[4,12], "x":12.25, "y":4.25, "w":1.75},
+ {"matrix":[4,13], "x":14.25, "y":4.25},
+ {"matrix":[4,14], "x":13, "y":0},
+ {"matrix":[4,15], "x":16.5, "y":4.25},
+ {"matrix":[4,16], "x":17.5, "y":4.25},
+ {"matrix":[4,17], "x":18.5, "y":4.25},
+ {"matrix":[5,8], "x":19.5, "y":4.25, "h":2},
+
+ {"matrix":[5,0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5,1], "x":1.25, "y":5.25, "w":1.25},
+ {"matrix":[5,2], "x":2.5, "y":5.25, "w":1.25},
+ {"matrix":[5,6], "x":3.75, "y":5.25, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5.25},
+ {"matrix":[5,11], "x":11, "y":5.25},
+ {"matrix":[5,12], "x":12, "y":5.25},
+ {"matrix":[5,16], "x":16.5, "y":5.25, "w":2},
+ {"matrix":[5,13], "x":13.25, "y":5.25},
+ {"matrix":[5,14], "x":14.25, "y":5.25},
+ {"matrix":[5,15], "x":15.25, "y":5.25},
+ {"matrix":[5,17], "x":18.5, "y":5.25}
+ ]
+ }
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k17_max/iso_encoder/white/keymaps/default/keymap.c b/keyboards/keychron/k17_max/iso_encoder/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..661dd9b12d
--- /dev/null
+++ b/keyboards/keychron/k17_max/iso_encoder/white/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_105_iso(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, BL_STEP, KC_DEL, KC_F13, KC_F14, KC_F15, KC_MUTE,
+ 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_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_HOME, KC_P4, KC_P5, KC_P6,
+ 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_SNAP, KC_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+
+ [MAC_FN] = LAYOUT_105_iso(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, BL_TOGG, _______, _______, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+
+ [WIN_BASE] = LAYOUT_105_iso(
+ 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, BL_STEP, KC_DEL, _______, _______, _______, KC_MUTE,
+ 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_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_HOME, KC_P4, KC_P5, KC_P6,
+ 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_PSCR, KC_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+
+ [WIN_FN] = LAYOUT_105_iso(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, BL_TOGG, _______, _______, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(BL_DOWN, BL_UP)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(BL_DOWN, BL_UP)},
+};
+#endif
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k17_max/iso_encoder/white/rules.mk b/keyboards/keychron/k17_max/iso_encoder/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k17_max/iso_encoder/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k17_max/iso_encoder/white/white.c b/keyboards/keychron/k17_max/iso_encoder/white/white.c
new file mode 100644
index 0000000000..3de9fd91ac
--- /dev/null
+++ b/keyboards/keychron/k17_max/iso_encoder/white/white.c
@@ -0,0 +1,169 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA5},
+ {0, CB6_CA6},
+ {0, CB6_CA7},
+ {0, CB6_CA8},
+ {0, CB6_CA9},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+ {0, CB1_CA8},
+ {0, CB1_CA9},
+ {0, CB1_CA10},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+ {0, CB8_CA7},
+ {0, CB8_CA8},
+ {0, CB8_CA9},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA15},
+ {0, CB4_CA16},
+ {0, CB8_CA12},
+ {0, CB8_CA13},
+ {0, CB8_CA14},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+ {0, CB7_CA7},
+ {0, CB7_CA8},
+ {0, CB7_CA9},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA15},
+ {0, CB6_CA14},
+ {0, CB7_CA10},
+ {0, CB7_CA11},
+ {0, CB7_CA12},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB8_CA10},
+ {0, CB1_CA7},
+ {0, CB8_CA15},
+ {0, CB7_CA13},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+ {0, CB7_CA14},
+ {0, CB1_CA14},
+ {0, CB7_CA16},
+
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17 },
+ { 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35 },
+ { 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53 },
+ { 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, __, 66, 67, 68, 69, 70 },
+ { 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88 },
+ { 89, 90, 91, __, __, 92, 93, 94, 95, __, 96, 97, 98, 99,100,101,102,103 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {12, 0}, {24, 0}, {36, 0}, {48, 0}, {60, 0}, {72, 0}, {84, 0}, {96, 0}, {108, 0}, {120, 0}, {132, 0}, {144, 0}, {168, 0}, {180, 0}, {192, 0},{203, 0},{213,0},
+ {0,13}, {12,13}, {24,13}, {36,13}, {48,13}, {60,13}, {72,13}, {84,13}, {96,13}, {108,13}, {120,13}, {132,13}, {144,13}, {162,13}, {180,13}, {192,13},{203,13},{213,13},
+ {2,26}, {18,26}, {30,26}, {42,26}, {54,26}, {66,26}, {78,26}, {90,26}, {102,26},{114,26}, {126,26}, {138,26}, {150,26}, {164,32}, {180,26}, {192,26},{203,26},{213,26},
+ {4,39}, {22,39}, {34,39}, {46,39}, {58,39}, {70,39}, {82,39}, {94,39}, {106,39},{118,39}, {130,39}, {142,39}, {154,39}, {180,39}, {192,39},{203,39},{213,39},
+ {1,51}, {14,51}, {28,51}, {40,51}, {52,51}, {64,51}, {76,51}, {88,51}, {100,51},{112,51}, {124,51}, {136,51}, {148,51}, {168,51}, {156, 0}, {192,51},{203,51},{213,51},
+ {1,64}, {16,64}, {30,64}, {224,13},{78,64}, {224,32},{224,57}, {120,64}, {132,64}, {144,64}, {168,64}, {180,64}, {197,64},{156,64},{213,64},
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k17_max/jis_encoder/rgb/config.h b/keyboards/keychron/k17_max/jis_encoder/rgb/config.h
new file mode 100644
index 0000000000..1aa980c528
--- /dev/null
+++ b/keyboards/keychron/k17_max/jis_encoder/rgb/config.h
@@ -0,0 +1,51 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 107
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define CAPS_LOCK_INDEX 58
+# define NUM_LOCK_INDEX 35
+# define LOW_BAT_IND_INDEX \
+ { 97 }
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 20, 21, 22 }
+# define P24G_INDICATION_LED_MATRIX_INDEX 23
+# define BAT_LEVEL_LED_LIST \
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k17_max/jis_encoder/rgb/keyboard.json b/keyboards/keychron/k17_max/jis_encoder/rgb/keyboard.json
new file mode 100644
index 0000000000..769db545ed
--- /dev/null
+++ b/keyboards/keychron/k17_max/jis_encoder/rgb/keyboard.json
@@ -0,0 +1,159 @@
+{
+ "usb": {
+ "pid": "0x0A02",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "A13", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "C5", "B10"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "layouts":{
+ "LAYOUT_108_jis": {
+ "layout": [
+ {"matrix":[0,0], "x":0, "y":0},
+ {"matrix":[0,1], "x":1, "y":0},
+ {"matrix":[0,2], "x":2, "y":0},
+ {"matrix":[0,3], "x":3, "y":0},
+ {"matrix":[0,4], "x":4, "y":0},
+ {"matrix":[0,5], "x":5, "y":0},
+ {"matrix":[0,6], "x":6, "y":0},
+ {"matrix":[0,7], "x":7, "y":0},
+ {"matrix":[0,8], "x":8, "y":0},
+ {"matrix":[0,9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14, "y":0},
+ {"matrix":[0,15], "x":15.25, "y":0},
+ {"matrix":[0,16], "x":16.5, "y":0},
+ {"matrix":[0,17], "x":17.5, "y":0},
+ {"matrix":[0,18], "x":18.5, "y":0},
+ {"matrix":[0,19], "x":19.5, "y":0},
+
+ {"matrix":[1,0], "x":0, "y":1.25},
+ {"matrix":[1,1], "x":1, "y":1.25},
+ {"matrix":[1,2], "x":2, "y":1.25},
+ {"matrix":[1,3], "x":3, "y":1.25},
+ {"matrix":[1,4], "x":4, "y":1.25},
+ {"matrix":[1,5], "x":5, "y":1.25},
+ {"matrix":[1,6], "x":6, "y":1.25},
+ {"matrix":[1,7], "x":7, "y":1.25},
+ {"matrix":[1,8], "x":8, "y":1.25},
+ {"matrix":[1,9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[1,13], "x":13, "y":1.25},
+ {"matrix":[1,14], "x":14, "y":1.25},
+ {"matrix":[1,15], "x":15.25, "y":1.25},
+ {"matrix":[1,16], "x":16.5, "y":1.25},
+ {"matrix":[1,17], "x":17.5, "y":1.25},
+ {"matrix":[1,18], "x":18.5, "y":1.25},
+ {"matrix":[1,19], "x":19.5, "y":1.25},
+
+ {"matrix":[2,0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2,1], "x":1.5, "y":2.25},
+ {"matrix":[2,2], "x":2.5, "y":2.25},
+ {"matrix":[2,3], "x":3.5, "y":2.25},
+ {"matrix":[2,4], "x":4.5, "y":2.25},
+ {"matrix":[2,5], "x":5.5, "y":2.25},
+ {"matrix":[2,6], "x":6.5, "y":2.25},
+ {"matrix":[2,7], "x":7.5, "y":2.25},
+ {"matrix":[2,8], "x":8.5, "y":2.25},
+ {"matrix":[2,9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,15], "x":15.25, "y":2.25},
+ {"matrix":[2,16], "x":16.5, "y":2.25},
+ {"matrix":[2,17], "x":17.5, "y":2.25},
+ {"matrix":[2,18], "x":18.5, "y":2.25},
+ {"matrix":[2,19], "x":19.5, "y":2.25, "h":2},
+
+ {"matrix":[3,0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3,1], "x":1.75, "y":3.25},
+ {"matrix":[3,2], "x":2.75, "y":3.25},
+ {"matrix":[3,3], "x":3.75, "y":3.25},
+ {"matrix":[3,4], "x":4.75, "y":3.25},
+ {"matrix":[3,5], "x":5.75, "y":3.25},
+ {"matrix":[3,6], "x":6.75, "y":3.25},
+ {"matrix":[3,7], "x":7.75, "y":3.25},
+ {"matrix":[3,8], "x":8.75, "y":3.25},
+ {"matrix":[3,9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,13], "x":12.75, "y":3.25},
+ {"matrix":[2,14], "x":13.75, "y":2.25, "w":1.25, "h":2},
+ {"matrix":[3,15], "x":15.25, "y":3.25},
+ {"matrix":[3,16], "x":16.5, "y":3.25},
+ {"matrix":[3,17], "x":17.5, "y":3.25},
+ {"matrix":[3,18], "x":18.5, "y":3.25},
+
+ {"matrix":[4,0], "x":0, "y":4.25, "w":2.25},
+ {"matrix":[4,2], "x":2.25, "y":4.25},
+ {"matrix":[4,3], "x":3.25, "y":4.25},
+ {"matrix":[4,4], "x":4.25, "y":4.25},
+ {"matrix":[4,5], "x":5.25, "y":4.25},
+ {"matrix":[4,6], "x":6.25, "y":4.25},
+ {"matrix":[4,7], "x":7.25, "y":4.25},
+ {"matrix":[4,8], "x":8.25, "y":4.25},
+ {"matrix":[4,9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25, "y":4.25},
+ {"matrix":[4,11], "x":11.25, "y":4.25},
+ {"matrix":[4,12], "x":12.25, "y":4.25},
+ {"matrix":[4,14], "x":13.25, "y":4.25, "w":1.75},
+ {"matrix":[4,15], "x":15.25, "y":4.25},
+ {"matrix":[4,16], "x":16.5, "y":4.25},
+ {"matrix":[4,17], "x":17.5, "y":4.25},
+ {"matrix":[4,18], "x":18.5, "y":4.25},
+ {"matrix":[4,19], "x":19.5, "y":4.25, "h":2},
+
+ {"matrix":[5,0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5,1], "x":1.25, "y":5.25},
+ {"matrix":[5,2], "x":2.25, "y":5.25, "w":1.25},
+ {"matrix":[5,3], "x":3.5, "y":5.25},
+ {"matrix":[5,6], "x":4.5, "y":5.25, "w":5},
+ {"matrix":[5,9], "x":9.5, "y":5.25},
+ {"matrix":[5,10], "x":10.5, "y":5.25},
+ {"matrix":[5,11], "x":11.5, "y":5.25,"w":1.25},
+ {"matrix":[5,12], "x":12.75, "y":5.25,"w":1.25},
+ {"matrix":[5,13], "x":14.25, "y":5.25},
+ {"matrix":[5,14], "x":15.25, "y":5.25},
+ {"matrix":[5,15], "x":16.25, "y":5.25},
+ {"matrix":[5,16], "x":17.5, "y":5.25},
+ {"matrix":[5,18], "x":18.5, "y":5.25}
+ ]
+ }
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k17_max/jis_encoder/rgb/keymaps/default/keymap.c b/keyboards/keychron/k17_max/jis_encoder/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..92aebd2836
--- /dev/null
+++ b/keyboards/keychron/k17_max/jis_encoder/rgb/keymaps/default/keymap.c
@@ -0,0 +1,74 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_108_jis(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, RGB_MOD, KC_DEL, KC_F13, KC_F14, KC_F15, KC_MUTE,
+ 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_INT3, KC_BSPC, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_BSLS, KC_ENT, KC_HOME, KC_P4, KC_P5, KC_P6,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP, KC_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+ [MAC_FN] = LAYOUT_108_jis(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, RGB_TOG, _______, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+ [WIN_BASE] = LAYOUT_108_jis(
+ 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, RGB_MOD, KC_DEL, _______, _______, _______, KC_MUTE,
+ 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_INT3, KC_BSPC, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_BSLS, KC_ENT, KC_HOME, KC_P4, KC_P5, KC_P6,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP, KC_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+ [WIN_FN] = LAYOUT_108_jis(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG, _______, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k17_max/jis_encoder/rgb/rgb.c b/keyboards/keychron/k17_max/jis_encoder/rgb/rgb.c
new file mode 100644
index 0000000000..51f9ceeffb
--- /dev/null
+++ b/keyboards/keychron/k17_max/jis_encoder/rgb/rgb.c
@@ -0,0 +1,174 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB4_CA8, CB6_CA8, CB5_CA8},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+
+ {0, CB3_CA1, CB1_CA1, CB2_CA1},
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA15, CB1_CA15, CB2_CA15},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB10_CA10, CB12_CA10, CB11_CA10},
+ {1, CB10_CA11, CB12_CA11, CB11_CA11},
+ {1, CB10_CA12, CB12_CA12, CB11_CA12},
+ {1, CB10_CA13, CB12_CA13, CB11_CA13},
+
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB10_CA14, CB12_CA14, CB11_CA14},
+ {1, CB10_CA16, CB12_CA16, CB11_CA16}
+};
+
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to RGB Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, __ },
+ { 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38 },
+ { 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, __, 52, 53, 54, 55, 56, 57 },
+ { 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, __, 70, __, 71, 72, 73, 74, __ },
+ { 75, __, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, __, 87, 88, 89, 90, 91, 92 },
+ { 93, 94, 95, 96, __, __, 97, __, __, 98, 99,100,101,102,103,104,105, __,106, __ },
+ },
+ {
+ // RGB Index to Physical Position
+ {0, 0}, {12, 0}, {24, 0}, {36, 0}, {48, 0}, {60, 0}, {72, 0}, {84, 0}, {96, 0}, {108, 0}, {120, 0}, {132, 0}, {144, 0}, {156, 0}, {168, 0}, {180, 0},{192, 0},{203, 0},{213, 0},
+ {0,13}, {12,13}, {24,13}, {36,13}, {48,13}, {60,13}, {72,13}, {84,13}, {96,13}, {108,13}, {120,13}, {132,13}, {144,13}, {156,13}, {168,13}, {180,13},{192,13},{203,13},{213,13},{224,13},
+ {2,26}, {18,26}, {30,26}, {42,26}, {54,26}, {66,26}, {78,26}, {90,26}, {102,26},{114,26}, {126,26}, {138,26}, {150,26}, {168,32}, {180,26},{192,26},{203,26},{213,26},{224,32},
+ {4,39}, {22,39}, {34,39}, {46,39}, {58,39}, {70,39}, {82,39}, {94,39}, {106,39},{118,39}, {130,39}, {142,39}, {154,39}, {180,39},{192,39},{203,39},{213,39},
+ {7,51}, {28,51}, {40,51}, {52,51}, {64,51}, {76,51}, {88,51}, {100,51},{112,51}, {124,51}, {136,51}, {148,51}, {168,51}, {180,51},{192,51},{203,51},{213,51},{224,57},
+ {1,64}, {15,64}, {30,64}, {42,64}, {78,64}, {114,64}, {126,64}, {140,64}, {154,64}, {168,64}, {180,64},{192,64},{202,64},{213,64},
+ },
+ {
+ // RGB Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k17_max/jis_encoder/rgb/rules.mk b/keyboards/keychron/k17_max/jis_encoder/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k17_max/jis_encoder/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k17_max/jis_encoder/white/config.h b/keyboards/keychron/k17_max/jis_encoder/white/config.h
new file mode 100644
index 0000000000..a923f88c5f
--- /dev/null
+++ b/keyboards/keychron/k17_max/jis_encoder/white/config.h
@@ -0,0 +1,53 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED Matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 107
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 56
+# define DIM_NUM_LOCK
+# define NUM_LOCK_INDEX 35
+# define LOW_BAT_IND_INDEX \
+ { 95 }
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 20, 21, 22 }
+# define P24G_INDICATION_LED_MATRIX_INDEX 23
+# define BAT_LEVEL_LED_LIST \
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k17_max/jis_encoder/white/keyboard.json b/keyboards/keychron/k17_max/jis_encoder/white/keyboard.json
new file mode 100644
index 0000000000..eb339d33e3
--- /dev/null
+++ b/keyboards/keychron/k17_max/jis_encoder/white/keyboard.json
@@ -0,0 +1,158 @@
+{
+ "usb": {
+ "pid": "0x0A05",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "indicators": {
+ "caps_lock": "C8",
+ "num_lock": "B10",
+ "on_state": 1
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "A13", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "C5"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "layouts":{
+ "LAYOUT_108_jis": {
+ "layout": [
+ {"matrix":[0,0], "x":0, "y":0},
+ {"matrix":[0,1], "x":1, "y":0},
+ {"matrix":[0,2], "x":2, "y":0},
+ {"matrix":[0,3], "x":3, "y":0},
+ {"matrix":[0,4], "x":4, "y":0},
+ {"matrix":[0,5], "x":5, "y":0},
+ {"matrix":[0,6], "x":6, "y":0},
+ {"matrix":[0,7], "x":7, "y":0},
+ {"matrix":[0,8], "x":8, "y":0},
+ {"matrix":[0,9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14,"y":0},
+ {"matrix":[0,15], "x":15.25, "y":0},
+ {"matrix":[0,16], "x":16.5, "y":0},
+ {"matrix":[0,17], "x":17.5, "y":0},
+ {"matrix":[0,18], "x":18.5, "y":0},
+
+ {"matrix":[1,0], "x":0, "y":1.25},
+ {"matrix":[1,1], "x":1, "y":1.25},
+ {"matrix":[1,2], "x":2, "y":1.25},
+ {"matrix":[1,3], "x":3, "y":1.25},
+ {"matrix":[1,4], "x":4, "y":1.25},
+ {"matrix":[1,5], "x":5, "y":1.25},
+ {"matrix":[1,6], "x":6, "y":1.25},
+ {"matrix":[1,7], "x":7, "y":1.25},
+ {"matrix":[1,8], "x":8, "y":1.25},
+ {"matrix":[1,9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[1,13], "x":13, "y":1.25},
+ {"matrix":[1,14], "x":14, "y":1.25},
+ {"matrix":[1,15], "x":15.25, "y":1.25},
+ {"matrix":[1,16], "x":16.5, "y":1.25},
+ {"matrix":[1,17], "x":17.5, "y":1.25},
+ {"matrix":[1,18], "x":18.5, "y":1.25},
+
+ {"matrix":[2,0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2,1], "x":1.5, "y":2.25},
+ {"matrix":[2,2], "x":2.5, "y":2.25},
+ {"matrix":[2,3], "x":3.5, "y":2.25},
+ {"matrix":[2,4], "x":4.5, "y":2.25},
+ {"matrix":[2,5], "x":5.5, "y":2.25},
+ {"matrix":[2,6], "x":6.5, "y":2.25},
+ {"matrix":[2,7], "x":7.5, "y":2.25},
+ {"matrix":[2,8], "x":8.5, "y":2.25},
+ {"matrix":[2,9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,15], "x":15.25,"y":2.25},
+ {"matrix":[2,16], "x":16.5, "y":2.25},
+ {"matrix":[2,17], "x":17.5, "y":2.25},
+ {"matrix":[2,18], "x":18.5, "y":2.25},
+
+ {"matrix":[3,0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3,1], "x":1.75, "y":3.25},
+ {"matrix":[3,2], "x":2.75, "y":3.25},
+ {"matrix":[3,3], "x":3.75, "y":3.25},
+ {"matrix":[3,4], "x":4.75, "y":3.25},
+ {"matrix":[3,5], "x":5.75, "y":3.25},
+ {"matrix":[3,6], "x":6.75, "y":3.25},
+ {"matrix":[3,7], "x":7.75, "y":3.25},
+ {"matrix":[3,8], "x":8.75, "y":3.25},
+ {"matrix":[3,9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,13], "x":12.75, "y":3.25},
+ {"matrix":[2,14], "x":13.75, "y":2.25, "w":1.25, "h":2},
+ {"matrix":[3,15], "x":15.25, "y":3.25},
+ {"matrix":[3,16], "x":16.5, "y":3.25},
+ {"matrix":[3,17], "x":17.5, "y":3.25},
+ {"matrix":[3,18], "x":18.5, "y":3.25},
+
+ {"matrix":[4,0], "x":0, "y":4.25, "w":2.25},
+ {"matrix":[4,2], "x":2.25, "y":4.25},
+ {"matrix":[4,3], "x":3.25, "y":4.25},
+ {"matrix":[4,4], "x":4.25, "y":4.25},
+ {"matrix":[4,5], "x":5.25, "y":4.25},
+ {"matrix":[4,6], "x":6.25, "y":4.25},
+ {"matrix":[4,7], "x":7.25, "y":4.25},
+ {"matrix":[4,8], "x":8.25, "y":4.25},
+ {"matrix":[4,9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25,"y":4.25},
+ {"matrix":[4,11], "x":11.25,"y":4.25},
+ {"matrix":[4,12], "x":12.25,"y":4.25},
+ {"matrix":[4,14], "x":13.25,"y":4.25, "w":1.75},
+ {"matrix":[4,15], "x":15.25, "y":4.25},
+ {"matrix":[4,16], "x":16.5, "y":4.25},
+ {"matrix":[4,17], "x":17.5, "y":4.25},
+ {"matrix":[4,18], "x":18.5, "y":4.25},
+
+ {"matrix":[5,0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5,1], "x":1.25,"y":5.25},
+ {"matrix":[5,2], "x":2.25, "y":5.25, "w":1.25},
+ {"matrix":[5,3], "x":3.5, "y":5.25},
+ {"matrix":[5,4], "x":19.5, "y":0},
+ {"matrix":[5,5], "x":19.5, "y":1.25},
+ {"matrix":[5,6], "x":4.5, "y":5.25, "w":5},
+ {"matrix":[5,7], "x":19.5, "y":2.25, "h":2},
+ {"matrix":[5,8], "x":19.5, "y":4.25, "h":2},
+ {"matrix":[5,9], "x":9.5, "y":5.25},
+ {"matrix":[5,10], "x":10.5, "y":5.25},
+ {"matrix":[5,11], "x":11.5, "y":5.25, "w":1.25},
+ {"matrix":[5,12], "x":12.75, "y":5.25,"w":1.25},
+ {"matrix":[5,13], "x":14.25, "y":5.25},
+ {"matrix":[5,14], "x":15.25, "y":5.25},
+ {"matrix":[5,15], "x":16.25, "y":5.25},
+ {"matrix":[5,16], "x":17.5, "y":5.25},
+ {"matrix":[5,18], "x":18.5, "y":5.25}
+ ]
+ }
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k17_max/jis_encoder/white/keymaps/default/keymap.c b/keyboards/keychron/k17_max/jis_encoder/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..d111f75355
--- /dev/null
+++ b/keyboards/keychron/k17_max/jis_encoder/white/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_108_jis(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, BL_STEP, KC_DEL, KC_F13, KC_F14, KC_F15,
+ 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_INT3, KC_BSPC, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST,
+ 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_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_BSLS, KC_ENT, KC_HOME, KC_P4, KC_P5, KC_P6,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP, KC_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_MUTE, KC_PMNS, KC_SPC, KC_PPLS, KC_PENT, KC_LNG1, KC_RCMMD, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT),
+
+ [MAC_FN] = LAYOUT_108_jis(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, BL_TOGG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, BL_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+
+ [WIN_BASE] = LAYOUT_108_jis(
+ 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, BL_STEP, KC_DEL, _______, _______, _______,
+ 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_INT3, KC_BSPC, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST,
+ 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_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_BSLS, KC_ENT, KC_HOME, KC_P4, KC_P5, KC_P6,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP, KC_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_INT5, KC_MUTE, KC_PMNS, KC_SPC, KC_PPLS, KC_PENT, KC_INT4, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+
+ [WIN_FN] = LAYOUT_108_jis(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, BL_TOGG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, BL_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(BL_DOWN, BL_UP)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(BL_DOWN, BL_UP)},
+};
+#endif
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k17_max/jis_encoder/white/rules.mk b/keyboards/keychron/k17_max/jis_encoder/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k17_max/jis_encoder/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k17_max/jis_encoder/white/white.c b/keyboards/keychron/k17_max/jis_encoder/white/white.c
new file mode 100644
index 0000000000..d2b5c11cdc
--- /dev/null
+++ b/keyboards/keychron/k17_max/jis_encoder/white/white.c
@@ -0,0 +1,172 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA5},
+ {0, CB6_CA6},
+ {0, CB6_CA7},
+ {0, CB6_CA8},
+ {0, CB6_CA9},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA14},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+ {0, CB1_CA6},
+ {0, CB1_CA8},
+ {0, CB1_CA9},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+ {0, CB8_CA7},
+ {0, CB8_CA8},
+ {0, CB8_CA9},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA15},
+ {0, CB4_CA16},
+ {0, CB8_CA12},
+ {0, CB8_CA13},
+ {0, CB8_CA14},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+ {0, CB7_CA7},
+ {0, CB7_CA8},
+ {0, CB7_CA9},
+
+ {0, CB2_CA1},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA15},
+ {0, CB2_CA16},
+ {0, CB7_CA10},
+ {0, CB7_CA11},
+ {0, CB7_CA12},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA4},
+ {0, CB8_CA10},
+ {0, CB1_CA7},
+ {0, CB8_CA15},
+ {0, CB7_CA13},
+ {0, CB1_CA10},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+ {0, CB7_CA14},
+ {0, CB7_CA16},
+};
+
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18 },
+ { 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37 },
+ { 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, __, 51, 52, 53, 54, 55 },
+ { 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, __, 68, __, 69, 70, 71, 72 },
+ { 73, __, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, __, 85, 86, 87, 88, 89 },
+ { 90, 91, 92, 93, __, 94, 95, 96, 97, 98, 99,100,101,102,103,104,105, __,106 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {12, 0}, {24, 0}, {36, 0}, {48, 0}, {60, 0}, {72, 0}, {84, 0}, {96, 0}, {108, 0}, {120, 0}, {132, 0}, {144, 0}, {156, 0}, {168, 0}, {180, 0}, {192, 0},{203, 0},{213,0},
+ {0,13}, {12,13}, {24,13}, {36,13}, {48,13}, {60,13}, {72,13}, {84,13}, {96,13}, {108,13}, {120,13}, {132,13}, {144,13}, {156, 13},{168,13}, {180,13}, {192,13},{203,13},{213,13},
+ {2,26}, {18,26}, {30,26}, {42,26}, {54,26}, {66,26}, {78,26}, {90,26}, {102,26},{114,26}, {126,26}, {138,26}, {150,26}, {168,32}, {180,26}, {192,26},{203,26},{213,26},
+ {4,39}, {22,39}, {34,39}, {46,39}, {58,39}, {70,39}, {82,39}, {94,39}, {106,39},{118,39}, {130,39}, {142,39}, {154,39}, {180,39}, {192,39},{203,39},{213,39},
+ {8,51}, {28,51}, {40,51}, {52,51}, {64,51}, {76,51}, {88,51}, {100,51},{112,51}, {124,51}, {136,51}, {148,51}, {168,51}, {180,51}, {192,51},{203,51},{213,51},
+ {1,64}, {15,64}, {30,64}, {42,64}, {224,13},{78,64}, {224,32},{224,57},{114,64}, {126,64}, {140,64}, {154,64}, {168,64}, {180,64}, {192,64},{203,64},{213,64},
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k17_max/k17_max.c b/keyboards/keychron/k17_max/k17_max.c
new file mode 100644
index 0000000000..a395b56cbc
--- /dev/null
+++ b/keyboards/keychron/k17_max/k17_max.c
@@ -0,0 +1,57 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#include "keychron_common.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+#endif
+
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 2));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/k17_max/mcuconf.h b/keyboards/keychron/k17_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/k17_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/k17_max/readme.md b/keyboards/keychron/k17_max/readme.md
new file mode 100644
index 0000000000..8459dcc84f
--- /dev/null
+++ b/keyboards/keychron/k17_max/readme.md
@@ -0,0 +1,35 @@
+# Keychron K17 Max
+
+
+
+A customizable 96% low profile keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron K17 Max
+* Hardware Availability: [Keychron K17 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-k17-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/k17_max/ansi/rgb:default
+ make keychron/k17_max/ansi/white:default
+
+ make keychron/k17_max/iso/rgb:default
+ make keychron/k17_max/iso/white:default
+
+ make keychron/k17_max/jis/rgb:default
+ make keychron/k17_max/jis/white:default
+
+Flashing example for this keyboard:
+
+ make keychron/k17_max/ansi/rgb:default:flash
+ make keychron/k17_max/ansi/white:default:flash
+
+ make keychron/k17_max/iso/rgb:default:flash
+ make keychron/k17_max/iso/white:default:flash
+
+ make keychron/k17_max/jis/rgb:default:flash
+ make keychron/k17_max/jis/white:default:flash
+
+**Reset Key**: Disconnect the USB cable, toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar, then connect the USB cable.
+
+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).
diff --git a/keyboards/keychron/k17_max/rules.mk b/keyboards/keychron/k17_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/k17_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/k17_max/via_json/k17_max_ansi_knob_rgb.json b/keyboards/keychron/k17_max/via_json/k17_max_ansi_knob_rgb.json
new file mode 100644
index 0000000000..04758609c2
--- /dev/null
+++ b/keyboards/keychron/k17_max/via_json/k17_max_ansi_knob_rgb.json
@@ -0,0 +1,335 @@
+{
+ "name": "Keychron K17 Max ANSI Knob RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A00",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 20},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,13",
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,16",
+ "0,17",
+ "0,18",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,19\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,14",
+ {
+ "x": 0.25
+ },
+ "1,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "1,16",
+ "1,17",
+ "1,18",
+ "1,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,14",
+ {
+ "x": 0.25
+ },
+ "2,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "2,16",
+ "2,17",
+ "2,18",
+ {
+ "h": 2
+ },
+ "2,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "3,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "3,16",
+ "3,17",
+ "3,18"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "4,14",
+ {
+ "x": 1.25
+ },
+ "4,16",
+ "4,17",
+ "4,18",
+ {
+ "h": 2
+ },
+ "4,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,10",
+ "5,11",
+ "5,12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc",
+ "w": 2
+ },
+ "5,16",
+ "5,18"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k17_max/via_json/k17_max_ansi_knob_white.json b/keyboards/keychron/k17_max/via_json/k17_max_ansi_knob_white.json
new file mode 100644
index 0000000000..53a2998a78
--- /dev/null
+++ b/keyboards/keychron/k17_max/via_json/k17_max_ansi_knob_white.json
@@ -0,0 +1,274 @@
+{
+ "name": "Keychron K17 Max ANSI Knob White",
+ "vendorId": "0x3434",
+ "productId": "0x0A03",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 20},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,13",
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,16",
+ "0,17",
+ "0,18",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,19\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,14",
+ {
+ "x": 0.25
+ },
+ "1,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "1,16",
+ "1,17",
+ "1,18",
+ "1,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,14",
+ {
+ "x": 0.25
+ },
+ "2,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "2,16",
+ "2,17",
+ "2,18",
+ {
+ "h": 2
+ },
+ "2,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "3,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "3,16",
+ "3,17",
+ "3,18"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "4,14",
+ {
+ "x": 1.25
+ },
+ "4,16",
+ "4,17",
+ "4,18",
+ {
+ "h": 2
+ },
+ "4,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,10",
+ "5,11",
+ "5,12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc",
+ "w": 2
+ },
+ "5,16",
+ "5,18"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k17_max/via_json/k17_max_iso_knob_rgb.json b/keyboards/keychron/k17_max/via_json/k17_max_iso_knob_rgb.json
new file mode 100644
index 0000000000..4800d071b7
--- /dev/null
+++ b/keyboards/keychron/k17_max/via_json/k17_max_iso_knob_rgb.json
@@ -0,0 +1,337 @@
+{
+ "name": "Keychron K17 Max ISO Knob RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A01",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 20},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,13",
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,16",
+ "0,17",
+ "0,18",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,19\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,14",
+ {
+ "x": 0.25
+ },
+ "1,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "1,16",
+ "1,17",
+ "1,18",
+ "1,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,14",
+ {
+ "x": 0.25
+ },
+ "2,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "2,16",
+ "2,17",
+ "2,18",
+ {
+ "h": 2
+ },
+ "2,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13",
+ {
+ "x": 1.5,
+ "c": "#aaaaaa"
+ },
+ "3,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "3,16",
+ "3,17",
+ "3,18"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,1",
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "4,14",
+ {
+ "x": 1.25
+ },
+ "4,16",
+ "4,17",
+ "4,18",
+ {
+ "h": 2
+ },
+ "4,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,10",
+ "5,11",
+ "5,12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc",
+ "w": 2
+ },
+ "5,16",
+ "5,18"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k17_max/via_json/k17_max_iso_knob_white.json b/keyboards/keychron/k17_max/via_json/k17_max_iso_knob_white.json
new file mode 100644
index 0000000000..541fc55e37
--- /dev/null
+++ b/keyboards/keychron/k17_max/via_json/k17_max_iso_knob_white.json
@@ -0,0 +1,276 @@
+{
+ "name": "Keychron K17 Max ISO Knob White",
+ "vendorId": "0x3434",
+ "productId": "0x0A04",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 18},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa"
+ },
+ "4,14",
+ "0,13",
+ {
+ "x": 0.25
+ },
+ "0,14",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,15",
+ "0,16",
+ "0,17",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,4\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,13",
+ {
+ "x": 0.25
+ },
+ "1,14",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "1,15",
+ "1,16",
+ "1,17",
+ "5,5"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,13",
+ {
+ "x": 0.25
+ },
+ "2,14",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "2,15",
+ "2,16",
+ "2,17",
+ {
+ "h": 2
+ },
+ "5,7"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13",
+ {
+ "x": 1.5,
+ "c": "#aaaaaa"
+ },
+ "3,14",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "3,15",
+ "3,16",
+ "3,17"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,1",
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "4,13",
+ {
+ "x": 1.25
+ },
+ "4,15",
+ "4,16",
+ "4,17",
+ {
+ "h": 2
+ },
+ "5,8"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,10",
+ "5,11",
+ "5,12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,16",
+ "5,13",
+ "5,14",
+ {
+ "x": 0.25,
+ "c": "#cccccc",
+ "w": 2
+ },
+ "5,15",
+ "5,17"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k17_max/via_json/k17_max_jis_knob_rgb.json b/keyboards/keychron/k17_max/via_json/k17_max_jis_knob_rgb.json
new file mode 100644
index 0000000000..ae5640655b
--- /dev/null
+++ b/keyboards/keychron/k17_max/via_json/k17_max_jis_knob_rgb.json
@@ -0,0 +1,339 @@
+{
+ "name": "Keychron K17 Max JIS Knob RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A02",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 20},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,13",
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,16",
+ "0,17",
+ "0,18",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,19\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ "1,13",
+ "1,14",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "1,16",
+ "1,17",
+ "1,18",
+ "1,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,14",
+ {
+ "x": 0.25
+ },
+ "2,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "2,16",
+ "2,17",
+ "2,18",
+ {
+ "h": 2
+ },
+ "2,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13",
+ {
+ "x": 1.5,
+ "c": "#aaaaaa"
+ },
+ "3,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "3,16",
+ "3,17",
+ "3,18"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,14",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "4,15",
+ {
+ "x": 0.25
+ },
+ "4,16",
+ "4,17",
+ "4,18",
+ {
+ "h": 2
+ },
+ "4,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ "5,3",
+ {
+ "c": "#cccccc",
+ "w": 5
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,9",
+ "5,10",
+ {
+ "w": 1.25
+ },
+ "5,11",
+ {
+ "w": 1.25
+ },
+ "5,12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,16",
+ "5,18"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k17_max/via_json/k17_max_jis_knob_white.json b/keyboards/keychron/k17_max/via_json/k17_max_jis_knob_white.json
new file mode 100644
index 0000000000..25f90bab92
--- /dev/null
+++ b/keyboards/keychron/k17_max/via_json/k17_max_jis_knob_white.json
@@ -0,0 +1,277 @@
+{
+ "name": "Keychron K17 Max JIS Knob White",
+ "vendorId": "0x3434",
+ "productId": "0x0A05",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 19},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,13",
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,16",
+ "0,17",
+ "0,18",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,4\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ "1,13",
+ "1,14",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "1,16",
+ "1,17",
+ "1,18",
+ "5,5"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,14",
+ {
+ "x": 0.25
+ },
+ "2,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "2,16",
+ "2,17",
+ "2,18",
+ {
+ "h": 2
+ },
+ "5,7"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13",
+ {
+ "x": 1.5,
+ "c": "#aaaaaa"
+ },
+ "3,15",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "3,16",
+ "3,17",
+ "3,18"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,14",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "4,15",
+ {
+ "x": 0.25
+ },
+ "4,16",
+ "4,17",
+ "4,18",
+ {
+ "h": 2
+ },
+ "5,8"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ "5,3",
+ {
+ "c": "#cccccc",
+ "w": 5
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,9",
+ "5,10",
+ {
+ "w": 1.25
+ },
+ "5,11",
+ {
+ "w": 1.25
+ },
+ "5,12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15",
+ {
+ "x": 0.25
+ },
+ "5,16",
+ "5,18"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k1_max/ansi/rgb/config.h b/keyboards/keychron/k1_max/ansi/rgb/config.h
new file mode 100644
index 0000000000..696321552f
--- /dev/null
+++ b/keyboards/keychron/k1_max/ansi/rgb/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 87
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define LOW_BAT_IND_INDEX \
+ { 79 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k1_max/ansi/rgb/keyboard.json b/keyboards/keychron/k1_max/ansi/rgb/keyboard.json
new file mode 100644
index 0000000000..4e0f7f27f5
--- /dev/null
+++ b/keyboards/keychron/k1_max/ansi/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A10",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k1_max/ansi/rgb/keymaps/default/keymap.c b/keyboards/keychron/k1_max/ansi/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..0bdd74193f
--- /dev/null
+++ b/keyboards/keychron/k1_max/ansi/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_87(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_87(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_87(
+ 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_CTANA, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_87(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k1_max/ansi/rgb/rgb.c b/keyboards/keychron/k1_max/ansi/rgb/rgb.c
new file mode 100644
index 0000000000..a61900a2c8
--- /dev/null
+++ b/keyboards/keychron/k1_max/ansi/rgb/rgb.c
@@ -0,0 +1,153 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1},
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB6_CA8, CB4_CA8, CB5_CA8},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA15, CB4_CA15, CB5_CA15},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB6_CA9, CB4_CA9, CB5_CA9},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, __, __, __ },
+ { 63, __, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, 74, __, 75, __ },
+ { 76, 77, 78, __, __, __, 79, __, __, __, 80, 81, 82, 83, 84, 85, 86 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {26, 0}, {39, 0}, {52, 0}, {65, 0}, {85, 0}, { 98, 0}, {111, 0}, {124, 0}, {144, 0}, {157, 0}, {170, 0}, {183, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {13,14}, {26,14}, {39,14}, {52,14}, {65,14}, {79,14}, { 92,14}, {105,14}, {118,14}, {131,14}, {144,14}, {157,14}, {177,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {20,26}, {33,26}, {46,26}, {59,26}, {72,26}, {85,26}, { 98,26}, {111,26}, {124,26}, {138,26}, {151,26}, {164,26}, {180,26}, {198,26}, {211,26}, {224,26},
+ {5,39}, {23,39}, {36,39}, {49,39}, {62,39}, {75,39}, {88,39}, {102,39}, {115,39}, {128,39}, {141,39}, {154,39}, {175,39},
+ {8,51}, {30,51}, {43,51}, {56,51}, {69,51}, {82,51}, { 95,51}, {108,51}, {121,51}, {134,51}, {147,51}, {172,51}, {211,51},
+ {2,64}, {18,64}, {34,64}, {84,64}, {133,64}, {149,64}, {165,64}, {182,64}, {198,64}, {211,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k1_max/ansi/rgb/rules.mk b/keyboards/keychron/k1_max/ansi/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k1_max/ansi/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k1_max/ansi/white/config.h b/keyboards/keychron/k1_max/ansi/white/config.h
new file mode 100644
index 0000000000..3b0100b643
--- /dev/null
+++ b/keyboards/keychron/k1_max/ansi/white/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 87
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Low battery indicating led */
+# define LOW_BAT_IND_INDEX \
+ { 79 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k1_max/ansi/white/keyboard.json b/keyboards/keychron/k1_max/ansi/white/keyboard.json
new file mode 100644
index 0000000000..03f5a7d488
--- /dev/null
+++ b/keyboards/keychron/k1_max/ansi/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A13",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k1_max/ansi/white/keymaps/default/keymap.c b/keyboards/keychron/k1_max/ansi/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..3d4d7d5eb8
--- /dev/null
+++ b/keyboards/keychron/k1_max/ansi/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_87(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, BL_STEP,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_87(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_87(
+ 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_CTANA, BL_STEP,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_87(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k1_max/ansi/white/rules.mk b/keyboards/keychron/k1_max/ansi/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k1_max/ansi/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k1_max/ansi/white/white.c b/keyboards/keychron/k1_max/ansi/white/white.c
new file mode 100644
index 0000000000..3e7a8528f7
--- /dev/null
+++ b/keyboards/keychron/k1_max/ansi/white/white.c
@@ -0,0 +1,151 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA5},
+ {0, CB6_CA6},
+ {0, CB6_CA7},
+ {0, CB6_CA8},
+ {0, CB6_CA9},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+ {0, CB1_CA8},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+ {0, CB1_CA9},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA15},
+ {0, CB4_CA16},
+ {0, CB1_CA6},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+
+ {0, CB2_CA1},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA7},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+ {0, CB2_CA15},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, __, __, __ },
+ { 63, __, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, 74, __, 75, __ },
+ { 76, 77, 78, __, __, __, 79, __, __, __, 80, 81, 82, 83, 84, 85, 86 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {26, 0}, {39, 0}, {52, 0}, {65, 0}, {85, 0}, { 98, 0}, {111, 0}, {124, 0}, {144, 0}, {157, 0}, {170, 0}, {183, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {13,14}, {26,14}, {39,14}, {52,14}, {65,14}, {79,14}, { 92,14}, {105,14}, {118,14}, {131,14}, {144,14}, {157,14}, {177,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {20,26}, {33,26}, {46,26}, {59,26}, {72,26}, {85,26}, { 98,26}, {111,26}, {124,26}, {138,26}, {151,26}, {164,26}, {180,26}, {198,26}, {211,26}, {224,26},
+ {5,39}, {23,39}, {36,39}, {49,39}, {62,39}, {75,39}, {88,39}, {102,39}, {115,39}, {128,39}, {141,39}, {154,39}, {175,39},
+ {8,51}, {30,51}, {43,51}, {56,51}, {69,51}, {82,51}, { 95,51}, {108,51}, {121,51}, {134,51}, {147,51}, {172,51}, {211,51},
+ {2,64}, {18,64}, {34,64}, {84,64}, {133,64}, {149,64}, {165,64}, {182,64}, {198,64}, {211,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k1_max/board.h b/keyboards/keychron/k1_max/board.h
new file mode 100644
index 0000000000..eb1aac7713
--- /dev/null
+++ b/keyboards/keychron/k1_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLDOWN(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/k1_max/config.h b/keyboards/keychron/k1_max/config.h
new file mode 100644
index 0000000000..59d6640003
--- /dev/null
+++ b/keyboards/keychron/k1_max/config.h
@@ -0,0 +1,85 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+# define BT_INDICATION_LED_PIN_LIST \
+ { C9, C9, C9 }
+# define BT_INDICATION_LED_ON_STATE 0
+
+# define P24G_HOST_DEVICES_COUNT 1
+# define P24G_INDICATION_LED_PIN_LIST \
+ { A8 }
+
+# if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/k1_max/halconf.h b/keyboards/keychron/k1_max/halconf.h
new file mode 100644
index 0000000000..4b823aa657
--- /dev/null
+++ b/keyboards/keychron/k1_max/halconf.h
@@ -0,0 +1,28 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/k1_max/info.json b/keyboards/keychron/k1_max/info.json
new file mode 100644
index 0000000000..efa555af84
--- /dev/null
+++ b/keyboards/keychron/k1_max/info.json
@@ -0,0 +1,334 @@
+{
+ "keyboard_name": "Keychron K1 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey": true,
+ "mousekey": true,
+ "dip_switch": true,
+ "nkro": true,
+ "raw": true,
+ "send_string": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch": {
+ "pins": ["B14"]
+ },
+ "indicators": {
+ "caps_lock": "A13",
+ "on_state": 1
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "layouts": {
+ "LAYOUT_ansi_87": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.5, "y": 0},
+ {"matrix": [0, 10], "x": 11, "y": 0},
+ {"matrix": [0, 11], "x": 12, "y": 0},
+ {"matrix": [0, 12], "x": 13, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15, "y": 0},
+ {"matrix": [0, 15], "x": 16, "y": 0},
+ {"matrix": [0, 16], "x": 17, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15, "y": 1.25},
+ {"matrix": [1, 15], "x": 16, "y": 1.25},
+ {"matrix": [1, 16], "x": 17, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 13], "x": 13.5, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 14], "x": 15, "y": 2.25},
+ {"matrix": [2, 15], "x": 16, "y": 2.25},
+ {"matrix": [2, 16], "x": 17, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 12.75, "y": 3.25, "w": 2.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 12.25, "y": 4.25, "w": 2.75},
+ {"matrix": [4, 15], "x": 16, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y":5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y":5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y":5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y":5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y":5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y":5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y":5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y":5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15, "y":5.25},
+ {"matrix": [5, 15], "x": 16, "y":5.25},
+ {"matrix": [5, 16], "x": 17, "y":5.25}
+ ]
+ },
+ "LAYOUT_iso_88": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.5, "y": 0},
+ {"matrix": [0, 10], "x": 11, "y": 0},
+ {"matrix": [0, 11], "x": 12, "y": 0},
+ {"matrix": [0, 12], "x": 13, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15, "y": 0},
+ {"matrix": [0, 15], "x": 16, "y": 0},
+ {"matrix": [0, 16], "x": 17, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15, "y": 1.25},
+ {"matrix": [1, 15], "x": 16, "y": 1.25},
+ {"matrix": [1, 16], "x": 17, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 14], "x": 15, "y": 2.25},
+ {"matrix": [2, 15], "x": 16, "y": 2.25},
+ {"matrix": [2, 16], "x": 17, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 12.75, "y": 3.25},
+ {"matrix": [2, 13], "x": 13.75, "y": 2.25, "w": 1.25, "h": 2},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 12.25, "y": 4.25, "w": 2.75},
+ {"matrix": [4, 15], "x": 16, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y":5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y":5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y":5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y":5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y":5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y":5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y":5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y":5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15, "y":5.25},
+ {"matrix": [5, 15], "x": 16, "y":5.25},
+ {"matrix": [5, 16], "x": 17, "y":5.25}
+ ]
+ },
+ "LAYOUT_jis_91": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.5, "y": 0},
+ {"matrix": [0, 10], "x": 11, "y": 0},
+ {"matrix": [0, 11], "x": 12, "y": 0},
+ {"matrix": [0, 12], "x": 13, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15, "y": 0},
+ {"matrix": [0, 15], "x": 16, "y": 0},
+ {"matrix": [0, 16], "x": 17, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25},
+ {"matrix": [1, 14], "x": 14, "y": 1.25},
+ {"matrix": [1, 15], "x": 15, "y": 1.25},
+ {"matrix": [1, 16], "x": 16, "y": 1.25},
+ {"matrix": [3, 12], "x": 17, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 14], "x": 15, "y": 2.25},
+ {"matrix": [2, 15], "x": 16, "y": 2.25},
+ {"matrix": [2, 16], "x": 17, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 12.75, "y": 3.25},
+ {"matrix": [2, 13], "x": 13.75, "y": 2.25, "w": 1.25, "h": 2},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 13.25, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 15], "x": 16, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y":5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y":5.25},
+ {"matrix": [5, 2], "x": 2.25, "y":5.25, "w": 1.25},
+ {"matrix": [5, 3], "x": 3.5, "y":5.25},
+ {"matrix": [5, 6], "x": 4.5, "y":5.25, "w": 5},
+ {"matrix": [5, 9], "x": 9.5, "y":5.25},
+ {"matrix": [5, 10], "x": 10.5, "y":5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.75, "y":5.25},
+ {"matrix": [5, 12], "x": 12.75, "y":5.25},
+ {"matrix": [5, 13], "x": 13.75, "y":5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15, "y":5.25},
+ {"matrix": [5, 15], "x": 16, "y":5.25},
+ {"matrix": [5, 16], "x": 17, "y":5.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/k1_max/iso/rgb/config.h b/keyboards/keychron/k1_max/iso/rgb/config.h
new file mode 100644
index 0000000000..7c74e40f13
--- /dev/null
+++ b/keyboards/keychron/k1_max/iso/rgb/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 88
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define LOW_BAT_IND_INDEX \
+ { 80 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k1_max/iso/rgb/keyboard.json b/keyboards/keychron/k1_max/iso/rgb/keyboard.json
new file mode 100644
index 0000000000..23bc83371e
--- /dev/null
+++ b/keyboards/keychron/k1_max/iso/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A11",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k1_max/iso/rgb/keymaps/default/keymap.c b/keyboards/keychron/k1_max/iso/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..93c0a9da18
--- /dev/null
+++ b/keyboards/keychron/k1_max/iso/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_88(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_88(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_88(
+ 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_CTANA, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_88(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k1_max/iso/rgb/rgb.c b/keyboards/keychron/k1_max/iso/rgb/rgb.c
new file mode 100644
index 0000000000..65e2deaa87
--- /dev/null
+++ b/keyboards/keychron/k1_max/iso/rgb/rgb.c
@@ -0,0 +1,154 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1},
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB6_CA8, CB4_CA8, CB5_CA8},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA15, CB4_CA15, CB5_CA15},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB6_CA9, CB4_CA9, CB5_CA9},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA2, CB1_CA2, CB2_CA2},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, __, __, __ },
+ { 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, __, 75, __, 76, __ },
+ { 77, 78, 79,__, __, __, 80, __, __, __, 81, 82, 83, 84, 85, 86, 87 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {26, 0}, {39, 0}, {52, 0}, {65, 0}, {85, 0}, { 98, 0}, {111, 0}, {124, 0}, {144, 0}, {157, 0}, {170, 0}, {183, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {13,14}, {26,14}, {39,14}, {52,14}, {65,14}, {79,14}, { 92,14}, {105,14}, {118,14}, {131,14}, {144,14}, {157,14}, {177,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {20,26}, {33,26}, {46,26}, {59,26}, {72,26}, {85,26}, { 98,26}, {111,26}, {124,26}, {138,26}, {151,26}, {164,26}, {178,33}, {198,26}, {211,26}, {224,26},
+ {5,39}, {23,39}, {36,39}, {49,39}, {62,39}, {75,39}, {88,39}, {102,39}, {115,39}, {128,39}, {141,39}, {154,39}, {169,39},
+ {2,51}, {16,51}, {30,51}, {43,51}, {56,51}, {69,51}, {82,51}, { 95,51}, {108,51}, {121,51}, {134,51}, {147,51}, {172,51}, {211,51},
+ {2,64}, {18,64}, {34,64}, {84,64}, {133,64}, {149,64}, {165,64}, {182,64}, {198,64}, {211,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k1_max/iso/rgb/rules.mk b/keyboards/keychron/k1_max/iso/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k1_max/iso/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k1_max/iso/white/config.h b/keyboards/keychron/k1_max/iso/white/config.h
new file mode 100644
index 0000000000..77285cd5f8
--- /dev/null
+++ b/keyboards/keychron/k1_max/iso/white/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 88
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Low battery indicating led */
+# define LOW_BAT_IND_INDEX \
+ { 80 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k1_max/iso/white/keyboard.json b/keyboards/keychron/k1_max/iso/white/keyboard.json
new file mode 100644
index 0000000000..a62babbf41
--- /dev/null
+++ b/keyboards/keychron/k1_max/iso/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A14",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k1_max/iso/white/keymaps/default/keymap.c b/keyboards/keychron/k1_max/iso/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..4041dac10f
--- /dev/null
+++ b/keyboards/keychron/k1_max/iso/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_88(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, BL_STEP,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_88(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_88(
+ 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_CTANA, BL_STEP,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_88(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k1_max/iso/white/rules.mk b/keyboards/keychron/k1_max/iso/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k1_max/iso/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k1_max/iso/white/white.c b/keyboards/keychron/k1_max/iso/white/white.c
new file mode 100644
index 0000000000..fa40c9ec0f
--- /dev/null
+++ b/keyboards/keychron/k1_max/iso/white/white.c
@@ -0,0 +1,152 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA5},
+ {0, CB6_CA6},
+ {0, CB6_CA7},
+ {0, CB6_CA8},
+ {0, CB6_CA9},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+ {0, CB1_CA8},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+ {0, CB1_CA9},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA15},
+ {0, CB4_CA16},
+ {0, CB1_CA6},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA7},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+ {0, CB2_CA15},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, __, __, __ },
+ { 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, __, 75, __, 76, __ },
+ { 77, 78, 79,__, __, __, 80, __, __, __, 81, 82, 83, 84, 85, 86, 87 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {26, 0}, {39, 0}, {52, 0}, {65, 0}, {85, 0}, { 98, 0}, {111, 0}, {124, 0}, {144, 0}, {157, 0}, {170, 0}, {183, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {13,14}, {26,14}, {39,14}, {52,14}, {65,14}, {79,14}, { 92,14}, {105,14}, {118,14}, {131,14}, {144,14}, {157,14}, {177,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {20,26}, {33,26}, {46,26}, {59,26}, {72,26}, {85,26}, { 98,26}, {111,26}, {124,26}, {138,26}, {151,26}, {164,26}, {178,33}, {198,26}, {211,26}, {224,26},
+ {5,39}, {23,39}, {36,39}, {49,39}, {62,39}, {75,39}, {88,39}, {102,39}, {115,39}, {128,39}, {141,39}, {154,39}, {169,39},
+ {2,51}, {16,51}, {30,51}, {43,51}, {56,51}, {69,51}, {82,51}, { 95,51}, {108,51}, {121,51}, {134,51}, {147,51}, {172,51}, {211,51},
+ {2,64}, {18,64}, {34,64}, {84,64}, {133,64}, {149,64}, {165,64}, {182,64}, {198,64}, {211,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k1_max/jis/rgb/config.h b/keyboards/keychron/k1_max/jis/rgb/config.h
new file mode 100644
index 0000000000..c7c4a2bb3f
--- /dev/null
+++ b/keyboards/keychron/k1_max/jis/rgb/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 91
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define LOW_BAT_IND_INDEX \
+ { 82 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k1_max/jis/rgb/keyboard.json b/keyboards/keychron/k1_max/jis/rgb/keyboard.json
new file mode 100644
index 0000000000..d4e3143d08
--- /dev/null
+++ b/keyboards/keychron/k1_max/jis/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A12",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k1_max/jis/rgb/keymaps/default/keymap.c b/keyboards/keychron/k1_max/jis/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..d92e33934a
--- /dev/null
+++ b/keyboards/keychron/k1_max/jis/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_jis_91(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, RGB_MOD,
+ 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_INT3, KC_BSPC, KC_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_BSLS, KC_ENT,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_jis_91(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_jis_91(
+ 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_CTANA, RGB_MOD,
+ 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_INT3, KC_BSPC, KC_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_BSLS, KC_ENT,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_jis_91(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k1_max/jis/rgb/rgb.c b/keyboards/keychron/k1_max/jis/rgb/rgb.c
new file mode 100644
index 0000000000..289943c02d
--- /dev/null
+++ b/keyboards/keychron/k1_max/jis/rgb/rgb.c
@@ -0,0 +1,157 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1},
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB6_CA8, CB4_CA8, CB5_CA8},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA15, CB4_CA15, CB5_CA15},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB6_CA9, CB4_CA9, CB5_CA9},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB6_CA5, CB4_CA5, CB5_CA5},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA13, CB1_CA13, CB2_CA13},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA4, CB4_CA4, CB5_CA4},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA10, CB4_CA10, CB5_CA10},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, __, __, __ },
+ { 64, __, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, __, 77, __ },
+ { 78, 79, 80, 81, __, __, 82, __, __, 83, 84, 85, 86, 87, 88, 89, 90 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {26, 0}, {39, 0}, {52, 0}, {65, 0}, {85, 0}, { 98, 0}, {111, 0}, {124, 0}, {144, 0}, {157, 0}, {170, 0}, {183, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {13,14}, {26,14}, {39,14}, {52,14}, {65,14}, {79,14}, { 92,14}, {105,14}, {118,14}, {131,14}, {144,14}, {157,14}, {170,14}, {183,14}, {198,14}, {211,14},
+ {3,26}, {20,26}, {33,26}, {46,26}, {59,26}, {72,26}, {85,26}, { 98,26}, {111,26}, {124,26}, {138,26}, {151,26}, {164,26}, {182,33}, {198,26}, {211,26}, {224,26},
+ {5,39}, {23,39}, {36,39}, {49,39}, {62,39}, {75,39}, {88,39}, {102,39}, {115,39}, {128,39}, {141,39}, {154,39}, {224,14}, {167,39},
+ {8,51}, {30,51}, {43,51}, {56,51}, {69,51}, {82,51}, { 95,51}, {108,51}, {121,51}, {134,51}, {147,51}, {160,51}, {178,51}, {211,51},
+ {2,64}, {16,64}, {31,64}, {46,64}, {85,64}, {124,64}, {139,64}, {154,64}, {167,64}, {182,64}, {198,64}, {211,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k1_max/jis/rgb/rules.mk b/keyboards/keychron/k1_max/jis/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k1_max/jis/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k1_max/jis/white/config.h b/keyboards/keychron/k1_max/jis/white/config.h
new file mode 100644
index 0000000000..4b1850dc1f
--- /dev/null
+++ b/keyboards/keychron/k1_max/jis/white/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 91
+# define DRIVER_CS_PINS \
+ { B9 }
+
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Low battery indicating led */
+# define LOW_BAT_IND_INDEX \
+ { 82 }
+
+# define LED_MATRIX_KEYPRESSES
+
+#endif
diff --git a/keyboards/keychron/k1_max/jis/white/keyboard.json b/keyboards/keychron/k1_max/jis/white/keyboard.json
new file mode 100644
index 0000000000..c363ce9c83
--- /dev/null
+++ b/keyboards/keychron/k1_max/jis/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A15",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k1_max/jis/white/keymaps/default/keymap.c b/keyboards/keychron/k1_max/jis/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..31a4f33ae7
--- /dev/null
+++ b/keyboards/keychron/k1_max/jis/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_jis_91(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, BL_STEP,
+ 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_INT3, KC_BSPC, KC_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_BSLS, KC_ENT,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_jis_91(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_jis_91(
+ 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_CTANA, BL_STEP,
+ 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_INT3, KC_BSPC, KC_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_BSLS, KC_ENT,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_jis_91(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k1_max/jis/white/rules.mk b/keyboards/keychron/k1_max/jis/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k1_max/jis/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k1_max/jis/white/white.c b/keyboards/keychron/k1_max/jis/white/white.c
new file mode 100644
index 0000000000..1139f19736
--- /dev/null
+++ b/keyboards/keychron/k1_max/jis/white/white.c
@@ -0,0 +1,155 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA5},
+ {0, CB6_CA6},
+ {0, CB6_CA7},
+ {0, CB6_CA8},
+ {0, CB6_CA9},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+ {0, CB1_CA8},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+ {0, CB1_CA9},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA15},
+ {0, CB4_CA16},
+ {0, CB1_CA6},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB1_CA5},
+ {0, CB3_CA14},
+
+ {0, CB2_CA1},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA4},
+ {0, CB1_CA7},
+ {0, CB1_CA10},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+ {0, CB2_CA15},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, __, __, __ },
+ { 64, __, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, __, 77, __ },
+ { 78, 79, 80, 81, __, __, 82, __, __, 83, 84, 85, 86, 87, 88, 89, 90 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {26, 0}, {39, 0}, {52, 0}, {65, 0}, {85, 0}, { 98, 0}, {111, 0}, {124, 0}, {144, 0}, {157, 0}, {170, 0}, {183, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {13,14}, {26,14}, {39,14}, {52,14}, {65,14}, {79,14}, { 92,14}, {105,14}, {118,14}, {131,14}, {144,14}, {157,14}, {170,14}, {183,14}, {198,14}, {211,14},
+ {3,26}, {20,26}, {33,26}, {46,26}, {59,26}, {72,26}, {85,26}, { 98,26}, {111,26}, {124,26}, {138,26}, {151,26}, {164,26}, {182,33}, {198,26}, {211,26}, {224,26},
+ {5,39}, {23,39}, {36,39}, {49,39}, {62,39}, {75,39}, {88,39}, {102,39}, {115,39}, {128,39}, {141,39}, {154,39}, {224,14}, {167,39},
+ {8,51}, {30,51}, {43,51}, {56,51}, {69,51}, {82,51}, { 95,51}, {108,51}, {121,51}, {134,51}, {147,51}, {160,51}, {178,51}, {211,51},
+ {2,64}, {16,64}, {31,64}, {46,64}, {85,64}, {124,64}, {139,64}, {154,64}, {167,64}, {182,64}, {198,64}, {211,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k1_max/k1_max.c b/keyboards/keychron/k1_max/k1_max.c
new file mode 100644
index 0000000000..5e4bd5f112
--- /dev/null
+++ b/keyboards/keychron/k1_max/k1_max.c
@@ -0,0 +1,96 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "transport.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef LK_WIRELESS_ENABLE
+pin_t bt_led_pins[] = BT_INDICATION_LED_PIN_LIST;
+pin_t p24g_led_pins[] = P24G_INDICATION_LED_PIN_LIST;
+#endif
+
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 2));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+ if (!host_keyboard_led_state().caps_lock) gpio_write_pin(LED_CAPS_LOCK_PIN, !LED_PIN_ON_STATE);
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+ for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(bt_led_pins[i], 1);
+ for (uint8_t i = 0; i < sizeof(p24g_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(p24g_led_pins[i], 1);
+#endif
+
+ } else {
+ gpio_write_pin(LED_CAPS_LOCK_PIN, LED_PIN_ON_STATE);
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+ if (get_transport() != TRANSPORT_P2P4)
+ for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(bt_led_pins[i], 0);
+ if (get_transport() != TRANSPORT_BLUETOOTH)
+ for (uint8_t i = 0; i < sizeof(p24g_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(p24g_led_pins[i], 0);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/k1_max/mcuconf.h b/keyboards/keychron/k1_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/k1_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/k1_max/readme.md b/keyboards/keychron/k1_max/readme.md
new file mode 100644
index 0000000000..226dd15cfe
--- /dev/null
+++ b/keyboards/keychron/k1_max/readme.md
@@ -0,0 +1,23 @@
+# Keychron K1 Max
+
+
+
+A customizable 87 keys TKL keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron K1 Max
+* Hardware Availability: [Keychron K1 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-k1-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/k1_max/ansi/rgb:default
+ make keychron/k1_max/ansi/white:default
+
+Flashing example for this keyboard:
+
+ make keychron/k1_max/ansi/rgb:default:flash
+ make keychron/k1_max/ansi/white:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/k1_max/rules.mk b/keyboards/keychron/k1_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/k1_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/k1_max/via_json/k1_max_ansi_rgb.json b/keyboards/keychron/k1_max/via_json/k1_max_ansi_rgb.json
new file mode 100644
index 0000000000..df20df1838
--- /dev/null
+++ b/keyboards/keychron/k1_max/via_json/k1_max_ansi_rgb.json
@@ -0,0 +1,293 @@
+{
+ "name": "Keychron K1 Max ANSI RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A10",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ {
+ "x": 0.2
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 13"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "x": 1.2,
+ "c": "#cccccc"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k1_max/via_json/k1_max_ansi_white.json b/keyboards/keychron/k1_max/via_json/k1_max_ansi_white.json
new file mode 100644
index 0000000000..d93d34228a
--- /dev/null
+++ b/keyboards/keychron/k1_max/via_json/k1_max_ansi_white.json
@@ -0,0 +1,232 @@
+{
+ "name": "Keychron K1 Max ANSI White",
+ "vendorId": "0x3434",
+ "productId": "0x0A13",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ {
+ "x": 0.2
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 13"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "x": 1.2,
+ "c": "#cccccc"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.2,
+ "c": "#cccccc"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k1_max/via_json/k1_max_jis_rgb .json b/keyboards/keychron/k1_max/via_json/k1_max_jis_rgb .json
new file mode 100644
index 0000000000..98a950f102
--- /dev/null
+++ b/keyboards/keychron/k1_max/via_json/k1_max_jis_rgb .json
@@ -0,0 +1,294 @@
+{
+ "name": "Keychron K1 Max JIS RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A12",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ {
+ "x": 0.2,
+ "c": "#aaaaaa"
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ "1, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 14",
+ {
+ "x": 0.2
+ },
+ "1, 15",
+ "1, 16",
+ "3, 12"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ {
+ "c": "#cccccc"
+ },
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "x": 0.2,
+ "c": "#aaaaaa"
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 13"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "x": 1.2
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "5, 0",
+
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ "5, 3",
+ {
+ "w": 5,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 9",
+ {
+ "w": 1.25
+ },
+ "5, 10",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 11",
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.2
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k1_max/via_json/k1_max_jis_white.json b/keyboards/keychron/k1_max/via_json/k1_max_jis_white.json
new file mode 100644
index 0000000000..58dd02c402
--- /dev/null
+++ b/keyboards/keychron/k1_max/via_json/k1_max_jis_white.json
@@ -0,0 +1,233 @@
+{
+ "name": "Keychron K1 Max JIS White",
+ "vendorId": "0x3434",
+ "productId": "0x0A15",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ {
+ "x": 0.2,
+ "c": "#aaaaaa"
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ "1, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 14",
+ {
+ "x": 0.2
+ },
+ "1, 15",
+ "1, 16",
+ "3, 12"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ {
+ "c": "#cccccc"
+ },
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "x": 0.2,
+ "c": "#aaaaaa"
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 13"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "x": 1.2
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "5, 0",
+
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ "5, 3",
+ {
+ "w": 5,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 9",
+ {
+ "w": 1.25
+ },
+ "5, 10",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 11",
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.2
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k2_max/ansi/info.json b/keyboards/keychron/k2_max/ansi/info.json
new file mode 100644
index 0000000000..b35e609f97
--- /dev/null
+++ b/keyboards/keychron/k2_max/ansi/info.json
@@ -0,0 +1,10 @@
+{
+ "indicators": {
+ "caps_lock": "A13",
+ "on_state": 1
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ }
+}
diff --git a/keyboards/keychron/k2_max/ansi/rgb/config.h b/keyboards/keychron/k2_max/ansi/rgb/config.h
new file mode 100644
index 0000000000..b70995ac3f
--- /dev/null
+++ b/keyboards/keychron/k2_max/ansi/rgb/config.h
@@ -0,0 +1,48 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 84
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 46
+# define LOW_BAT_IND_INDEX \
+ { 77 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k2_max/ansi/rgb/keyboard.json b/keyboards/keychron/k2_max/ansi/rgb/keyboard.json
new file mode 100644
index 0000000000..5732c7265d
--- /dev/null
+++ b/keyboards/keychron/k2_max/ansi/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A20",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k2_max/ansi/rgb/keymaps/default/keymap.c b/keyboards/keychron/k2_max/ansi/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..645230ccb9
--- /dev/null
+++ b/keyboards/keychron/k2_max/ansi/rgb/keymaps/default/keymap.c
@@ -0,0 +1,68 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_ansi_84(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, RGB_MOD,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_ansi_84(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_BASE] = LAYOUT_ansi_84(
+ 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_DEL, RGB_MOD,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_FN] = LAYOUT_ansi_84(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k2_max/ansi/rgb/rgb.c b/keyboards/keychron/k2_max/ansi/rgb/rgb.c
new file mode 100644
index 0000000000..353e831e9a
--- /dev/null
+++ b/keyboards/keychron/k2_max/ansi/rgb/rgb.c
@@ -0,0 +1,147 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1},
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA14, CB7_CA14, CB8_CA14},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {0, CB3_CA1, CB1_CA1, CB2_CA1},
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA14, CB1_CA14, CB2_CA14},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA13, CB1_CA13, CB2_CA13},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA13, CB7_CA13, CB8_CA13},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA10, CB4_CA10, CB5_CA10},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+ {1, CB6_CA5, CB4_CA5, CB5_CA5},
+ {1, CB6_CA4, CB4_CA4, CB5_CA4},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA1, CB4_CA1, CB5_CA1}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, __, 45 },
+ { 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __, 58, __, 59 },
+ { 60, __, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, __, 73 },
+ { 74, 75, 76, __, __, __, 77, __, __, 78, 79, 80, 81, 82, __, 83 }
+ },
+ {
+ {0, 0}, {14, 0}, {29, 0}, {44, 0}, {59, 0}, {74, 0}, { 89, 0}, {104, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209,0}, {223, 0},
+ {0,12}, {14,12}, {29,12}, {44,12}, {59,12}, {74,12}, { 89, 12}, {104, 12}, {119, 12}, {134, 12}, {149, 12}, {164, 12}, {179, 12}, {201, 12}, {223, 12},
+ {3,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 25}, {223, 25},
+ {5,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {201, 38}, {223, 38},
+ {8,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {187, 51}, {209, 51}, {223, 51},
+ {1,64}, {20,64}, {39,64}, { 95, 64}, {149, 64}, {164, 64}, {179, 64}, {194, 64}, {209, 64}, {223, 64}
+ },
+ {
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4
+ }
+};
+#endif
diff --git a/keyboards/keychron/k2_max/ansi/rgb/rules.mk b/keyboards/keychron/k2_max/ansi/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k2_max/ansi/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k2_max/ansi/white/config.h b/keyboards/keychron/k2_max/ansi/white/config.h
new file mode 100644
index 0000000000..cf262ac221
--- /dev/null
+++ b/keyboards/keychron/k2_max/ansi/white/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 84
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+# define LED_MATRIX_VAL_STEP 16
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 46
+# define LOW_BAT_IND_INDEX \
+ { 77 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k2_max/ansi/white/keyboard.json b/keyboards/keychron/k2_max/ansi/white/keyboard.json
new file mode 100644
index 0000000000..75f4a70faf
--- /dev/null
+++ b/keyboards/keychron/k2_max/ansi/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A23",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k2_max/ansi/white/keymaps/default/keymap.c b/keyboards/keychron/k2_max/ansi/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..240da939de
--- /dev/null
+++ b/keyboards/keychron/k2_max/ansi/white/keymaps/default/keymap.c
@@ -0,0 +1,68 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_ansi_84(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, BL_STEP,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_ansi_84(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_BASE] = LAYOUT_ansi_84(
+ 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_DEL, BL_STEP,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_FN] = LAYOUT_ansi_84(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k2_max/ansi/white/rules.mk b/keyboards/keychron/k2_max/ansi/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k2_max/ansi/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k2_max/ansi/white/white.c b/keyboards/keychron/k2_max/ansi/white/white.c
new file mode 100644
index 0000000000..3fc1b8cda8
--- /dev/null
+++ b/keyboards/keychron/k2_max/ansi/white/white.c
@@ -0,0 +1,149 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA16},
+ {0, CB1_CA15},
+ {0, CB1_CA14},
+ {0, CB1_CA13},
+ {0, CB1_CA12},
+ {0, CB1_CA11},
+ {0, CB1_CA10},
+ {0, CB1_CA9},
+ {0, CB1_CA8},
+ {0, CB1_CA7},
+ {0, CB1_CA6},
+ {0, CB1_CA5},
+ {0, CB1_CA4},
+ {0, CB1_CA3},
+ {0, CB1_CA2},
+ {0, CB1_CA1},
+
+ {0, CB2_CA16},
+ {0, CB2_CA15},
+ {0, CB2_CA14},
+ {0, CB2_CA13},
+ {0, CB2_CA12},
+ {0, CB2_CA11},
+ {0, CB2_CA10},
+ {0, CB2_CA9},
+ {0, CB2_CA8},
+ {0, CB2_CA7},
+ {0, CB2_CA6},
+ {0, CB2_CA5},
+ {0, CB2_CA4},
+ {0, CB2_CA3},
+ {0, CB2_CA1},
+
+ {0, CB3_CA16},
+ {0, CB3_CA15},
+ {0, CB3_CA14},
+ {0, CB3_CA13},
+ {0, CB3_CA12},
+ {0, CB3_CA11},
+ {0, CB3_CA10},
+ {0, CB3_CA9},
+ {0, CB3_CA8},
+ {0, CB3_CA7},
+ {0, CB3_CA6},
+ {0, CB3_CA5},
+ {0, CB3_CA4},
+ {0, CB3_CA3},
+ {0, CB3_CA1},
+
+ {0, CB4_CA16},
+ {0, CB4_CA15},
+ {0, CB4_CA14},
+ {0, CB4_CA13},
+ {0, CB4_CA12},
+ {0, CB4_CA11},
+ {0, CB4_CA10},
+ {0, CB4_CA9},
+ {0, CB4_CA8},
+ {0, CB4_CA7},
+ {0, CB4_CA6},
+ {0, CB4_CA5},
+ {0, CB4_CA3},
+ {0, CB4_CA1},
+
+ {0, CB5_CA16},
+ {0, CB5_CA14},
+ {0, CB5_CA13},
+ {0, CB5_CA12},
+ {0, CB5_CA11},
+ {0, CB5_CA10},
+ {0, CB5_CA9},
+ {0, CB5_CA8},
+ {0, CB5_CA7},
+ {0, CB5_CA6},
+ {0, CB5_CA5},
+ {0, CB5_CA4},
+ {0, CB5_CA3},
+ {0, CB5_CA1},
+
+ {0, CB6_CA16},
+ {0, CB6_CA15},
+ {0, CB6_CA14},
+ {0, CB6_CA10},
+ {0, CB6_CA7},
+ {0, CB6_CA6},
+ {0, CB6_CA5},
+ {0, CB6_CA4},
+ {0, CB6_CA3},
+ {0, CB6_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, __, 45 },
+ { 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __, 58, __, 59 },
+ { 60, __, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, __, 73 },
+ { 74, 75, 76, __, __, __, 77, __, __, 78, 79, 80, 81, 82, __, 83 }
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {14, 0}, {29, 0}, {44, 0}, {59, 0}, {74, 0}, { 89, 0}, {104, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209, 0}, {223, 0},
+ {0,12}, {14,12}, {29,12}, {44,12}, {59,12}, {74,12}, { 89, 12}, {104, 12}, {119, 12}, {134, 12}, {149, 12}, {164, 12}, {179, 12}, {201, 12}, {223, 12},
+ {3,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 25}, {223, 25},
+ {5,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {199, 38}, {223, 38},
+ {8,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {187, 51}, {209, 51}, {223, 51},
+ {1,64}, {20,64}, {39,64}, { 95, 64}, {149, 64}, {164, 64}, {179, 64}, {194, 64}, {209, 64}, {223, 64}
+ },
+ {
+ // RGB LED Index to Flag
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/k2_max/board.h b/keyboards/keychron/k2_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/k2_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/k2_max/config.h b/keyboards/keychron/k2_max/config.h
new file mode 100644
index 0000000000..d463f2c202
--- /dev/null
+++ b/keyboards/keychron/k2_max/config.h
@@ -0,0 +1,78 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A9
+# define BT_MODE_SELECT_PIN A10
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/k2_max/halconf.h b/keyboards/keychron/k2_max/halconf.h
new file mode 100644
index 0000000000..cffb2a4455
--- /dev/null
+++ b/keyboards/keychron/k2_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/k2_max/info.json b/keyboards/keychron/k2_max/info.json
new file mode 100644
index 0000000000..0b6172bdd1
--- /dev/null
+++ b/keyboards/keychron/k2_max/info.json
@@ -0,0 +1,319 @@
+{
+ "keyboard_name": "Keychron K2 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "Keychron",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey": true,
+ "mousekey": true,
+ "dip_switch": true,
+ "nkro": true,
+ "raw": true,
+ "send_string": true
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch": {
+ "pins": ["B14"]
+ },
+ "dynamic_keymap": {
+ "layer_count": 4
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "layouts": {
+ "LAYOUT_ansi_84": {
+ "layout": [
+ {"matrix":[0, 0], "x":0, "y":0},
+ {"matrix":[0, 1], "x":1, "y":0},
+ {"matrix":[0, 2], "x":2, "y":0},
+ {"matrix":[0, 3], "x":3, "y":0},
+ {"matrix":[0, 4], "x":4, "y":0},
+ {"matrix":[0, 5], "x":5, "y":0},
+ {"matrix":[0, 6], "x":6, "y":0},
+ {"matrix":[0, 7], "x":7, "y":0},
+ {"matrix":[0, 8], "x":8, "y":0},
+ {"matrix":[0, 9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14, "y":0},
+ {"matrix":[0,15], "x":15, "y":0},
+
+ {"matrix":[1, 0], "x":0, "y":1},
+ {"matrix":[1, 1], "x":1, "y":1},
+ {"matrix":[1, 2], "x":2, "y":1},
+ {"matrix":[1, 3], "x":3, "y":1},
+ {"matrix":[1, 4], "x":4, "y":1},
+ {"matrix":[1, 5], "x":5, "y":1},
+ {"matrix":[1, 6], "x":6, "y":1},
+ {"matrix":[1, 7], "x":7, "y":1},
+ {"matrix":[1, 8], "x":8, "y":1},
+ {"matrix":[1, 9], "x":9, "y":1},
+ {"matrix":[1,10], "x":10, "y":1},
+ {"matrix":[1,11], "x":11, "y":1},
+ {"matrix":[1,12], "x":12, "y":1},
+ {"matrix":[1,13], "x":13, "y":1, "w":2},
+ {"matrix":[1,15], "x":15, "y":1},
+
+ {"matrix":[2, 0], "x":0, "y":2, "w":1.5},
+ {"matrix":[2, 1], "x":1.5, "y":2},
+ {"matrix":[2, 2], "x":2.5, "y":2},
+ {"matrix":[2, 3], "x":3.5, "y":2},
+ {"matrix":[2, 4], "x":4.5, "y":2},
+ {"matrix":[2, 5], "x":5.5, "y":2},
+ {"matrix":[2, 6], "x":6.5, "y":2},
+ {"matrix":[2, 7], "x":7.5, "y":2},
+ {"matrix":[2, 8], "x":8.5, "y":2},
+ {"matrix":[2, 9], "x":9.5, "y":2},
+ {"matrix":[2,10], "x":10.5, "y":2},
+ {"matrix":[2,11], "x":11.5, "y":2},
+ {"matrix":[2,12], "x":12.5, "y":2},
+ {"matrix":[2,13], "x":13.5, "y":2, "w":1.5},
+ {"matrix":[2,15], "x":15, "y":2},
+
+ {"matrix":[3, 0], "x":0, "y":3, "w":1.75},
+ {"matrix":[3, 1], "x":1.75, "y":3},
+ {"matrix":[3, 2], "x":2.75, "y":3},
+ {"matrix":[3, 3], "x":3.75, "y":3},
+ {"matrix":[3, 4], "x":4.75, "y":3},
+ {"matrix":[3, 5], "x":5.75, "y":3},
+ {"matrix":[3, 6], "x":6.75, "y":3},
+ {"matrix":[3, 7], "x":7.75, "y":3},
+ {"matrix":[3, 8], "x":8.75, "y":3},
+ {"matrix":[3, 9], "x":9.75, "y":3},
+ {"matrix":[3,10], "x":10.75, "y":3},
+ {"matrix":[3,11], "x":11.75, "y":3},
+ {"matrix":[3,13], "x":12.75, "y":3, "w":2.25},
+ {"matrix":[3,15], "x":15, "y":3},
+
+ {"matrix":[4, 0], "x":0, "y":4, "w":2.25},
+ {"matrix":[4, 2], "x":2.25, "y":4},
+ {"matrix":[4, 3], "x":3.25, "y":4},
+ {"matrix":[4, 4], "x":4.25, "y":4},
+ {"matrix":[4, 5], "x":5.25, "y":4},
+ {"matrix":[4, 6], "x":6.25, "y":4},
+ {"matrix":[4, 7], "x":7.25, "y":4},
+ {"matrix":[4, 8], "x":8.25, "y":4},
+ {"matrix":[4, 9], "x":9.25, "y":4},
+ {"matrix":[4,10], "x":10.25, "y":4},
+ {"matrix":[4,11], "x":11.25, "y":4},
+ {"matrix":[4,12], "x":12.25, "y":4, "w":1.75},
+ {"matrix":[4,13], "x":14, "y":4},
+ {"matrix":[4,15], "x":15, "y":4},
+
+ {"matrix":[5, 0], "x":0, "y":5, "w":1.25},
+ {"matrix":[5, 1], "x":1.25, "y":5, "w":1.25},
+ {"matrix":[5, 2], "x":2.5, "y":5, "w":1.25},
+ {"matrix":[5, 6], "x":3.75, "y":5, "w":6.25},
+ {"matrix":[5, 9], "x":10, "y":5},
+ {"matrix":[5,10], "x":11, "y":5},
+ {"matrix":[5,11], "x":12, "y":5},
+ {"matrix":[5,12], "x":13, "y":5},
+ {"matrix":[5,13], "x":14, "y":5},
+ {"matrix":[5,15], "x":15, "y":5}
+ ]
+ },
+ "LAYOUT_iso_85": {
+ "layout": [
+ {"matrix":[0, 0], "x":0, "y":0},
+ {"matrix":[0, 1], "x":1, "y":0},
+ {"matrix":[0, 2], "x":2, "y":0},
+ {"matrix":[0, 3], "x":3, "y":0},
+ {"matrix":[0, 4], "x":4, "y":0},
+ {"matrix":[0, 5], "x":5, "y":0},
+ {"matrix":[0, 6], "x":6, "y":0},
+ {"matrix":[0, 7], "x":7, "y":0},
+ {"matrix":[0, 8], "x":8, "y":0},
+ {"matrix":[0, 9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14, "y":0},
+ {"matrix":[0,15], "x":15, "y":0},
+
+ {"matrix":[1, 0], "x":0, "y":1},
+ {"matrix":[1, 1], "x":1, "y":1},
+ {"matrix":[1, 2], "x":2, "y":1},
+ {"matrix":[1, 3], "x":3, "y":1},
+ {"matrix":[1, 4], "x":4, "y":1},
+ {"matrix":[1, 5], "x":5, "y":1},
+ {"matrix":[1, 6], "x":6, "y":1},
+ {"matrix":[1, 7], "x":7, "y":1},
+ {"matrix":[1, 8], "x":8, "y":1},
+ {"matrix":[1, 9], "x":9, "y":1},
+ {"matrix":[1,10], "x":10, "y":1},
+ {"matrix":[1,11], "x":11, "y":1},
+ {"matrix":[1,12], "x":12, "y":1},
+ {"matrix":[1,13], "x":13, "y":1, "w": 2},
+ {"matrix":[1,15], "x":15, "y":1},
+
+ {"matrix":[2, 0], "x":0, "y":2, "w":1.5},
+ {"matrix":[2, 1], "x":1.5, "y":2},
+ {"matrix":[2, 2], "x":2.5, "y":2},
+ {"matrix":[2, 3], "x":3.5, "y":2},
+ {"matrix":[2, 4], "x":4.5, "y":2},
+ {"matrix":[2, 5], "x":5.5, "y":2},
+ {"matrix":[2, 6], "x":6.5, "y":2},
+ {"matrix":[2, 7], "x":7.5, "y":2},
+ {"matrix":[2, 8], "x":8.5, "y":2},
+ {"matrix":[2, 9], "x":9.5, "y":2},
+ {"matrix":[2,10], "x":10.5, "y":2},
+ {"matrix":[2,11], "x":11.5, "y":2},
+ {"matrix":[2,12], "x":12.5, "y":2},
+ {"matrix":[2,15], "x":15, "y":2},
+
+ {"matrix":[3, 0], "x":0, "y":3, "w":1.75},
+ {"matrix":[3, 1], "x":1.75, "y":3},
+ {"matrix":[3, 2], "x":2.75, "y":3},
+ {"matrix":[3, 3], "x":3.75, "y":3},
+ {"matrix":[3, 4], "x":4.75, "y":3},
+ {"matrix":[3, 5], "x":5.75, "y":3},
+ {"matrix":[3, 6], "x":6.75, "y":3},
+ {"matrix":[3, 7], "x":7.75, "y":3},
+ {"matrix":[3, 8], "x":8.75, "y":3},
+ {"matrix":[3, 9], "x":9.75, "y":3},
+ {"matrix":[3,10], "x":10.75, "y":3},
+ {"matrix":[3,11], "x":11.75, "y":3},
+ {"matrix":[3,13], "x":12.75, "y":3},
+ {"matrix":[2,13], "x":13.75, "y":2, "w":1.25, "h": 2},
+ {"matrix":[3,15], "x":15, "y":3},
+
+ {"matrix":[4, 0], "x":0, "y":4, "w":1.25},
+ {"matrix":[4, 1], "x":1.25, "y":4},
+ {"matrix":[4, 2], "x":2.25, "y":4},
+ {"matrix":[4, 3], "x":3.25, "y":4},
+ {"matrix":[4, 4], "x":4.25, "y":4},
+ {"matrix":[4, 5], "x":5.25, "y":4},
+ {"matrix":[4, 6], "x":6.25, "y":4},
+ {"matrix":[4, 7], "x":7.25, "y":4},
+ {"matrix":[4, 8], "x":8.25, "y":4},
+ {"matrix":[4, 9], "x":9.25, "y":4},
+ {"matrix":[4,10], "x":10.25, "y":4},
+ {"matrix":[4,11], "x":11.25, "y":4},
+ {"matrix":[4,12], "x":12.25, "y":4, "w":1.75},
+ {"matrix":[4,13], "x":14, "y":4},
+ {"matrix":[4,15], "x":15, "y":4},
+
+ {"matrix":[5, 0], "x":0, "y":5, "w":1.25},
+ {"matrix":[5, 1], "x":1.25, "y":5, "w":1.25},
+ {"matrix":[5, 2], "x":2.5, "y":5, "w":1.25},
+ {"matrix":[5, 6], "x":3.75, "y":5, "w":6.25},
+ {"matrix":[5, 9], "x":10, "y":5},
+ {"matrix":[5,10], "x":11, "y":5},
+ {"matrix":[5,11], "x":12, "y":5},
+ {"matrix":[5,12], "x":13, "y":5},
+ {"matrix":[5,13], "x":14, "y":5},
+ {"matrix":[5,15], "x":15, "y":5}
+ ]
+ },
+ "LAYOUT_jis_87": {
+ "layout": [
+ {"matrix":[0, 0], "x":0, "y":0},
+ {"matrix":[0, 1], "x":1, "y":0},
+ {"matrix":[0, 2], "x":2, "y":0},
+ {"matrix":[0, 3], "x":3, "y":0},
+ {"matrix":[0, 4], "x":4, "y":0},
+ {"matrix":[0, 5], "x":5, "y":0},
+ {"matrix":[0, 6], "x":6, "y":0},
+ {"matrix":[0, 7], "x":7, "y":0},
+ {"matrix":[0, 8], "x":8, "y":0},
+ {"matrix":[0, 9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14, "y":0},
+ {"matrix":[0,15], "x":15, "y":0},
+
+ {"matrix":[1, 0], "x":0, "y":1},
+ {"matrix":[1, 1], "x":1, "y":1},
+ {"matrix":[1, 2], "x":2, "y":1},
+ {"matrix":[1, 3], "x":3, "y":1},
+ {"matrix":[1, 4], "x":4, "y":1},
+ {"matrix":[1, 5], "x":5, "y":1},
+ {"matrix":[1, 6], "x":6, "y":1},
+ {"matrix":[1, 7], "x":7, "y":1},
+ {"matrix":[1, 8], "x":8, "y":1},
+ {"matrix":[1, 9], "x":9, "y":1},
+ {"matrix":[1,10], "x":10, "y":1},
+ {"matrix":[1,11], "x":11, "y":1},
+ {"matrix":[1,12], "x":12, "y":1},
+ {"matrix":[1,13], "x":13, "y":1},
+ {"matrix":[1,14], "x":14, "y":1},
+ {"matrix":[1,15], "x":15, "y":1},
+
+ {"matrix":[2, 0], "x":0, "y":2, "w":1.5},
+ {"matrix":[2, 1], "x":1.5, "y":2},
+ {"matrix":[2, 2], "x":2.5, "y":2},
+ {"matrix":[2, 3], "x":3.5, "y":2},
+ {"matrix":[2, 4], "x":4.5, "y":2},
+ {"matrix":[2, 5], "x":5.5, "y":2},
+ {"matrix":[2, 6], "x":6.5, "y":2},
+ {"matrix":[2, 7], "x":7.5, "y":2},
+ {"matrix":[2, 8], "x":8.5, "y":2},
+ {"matrix":[2, 9], "x":9.5, "y":2},
+ {"matrix":[2,10], "x":10.5, "y":2},
+ {"matrix":[2,11], "x":11.5, "y":2},
+ {"matrix":[2,12], "x":12.5, "y":2},
+ {"matrix":[2,15], "x":15, "y":2},
+
+ {"matrix":[3, 0], "x":0, "y":3, "w":1.75},
+ {"matrix":[3, 1], "x":1.75, "y":3},
+ {"matrix":[3, 2], "x":2.75, "y":3},
+ {"matrix":[3, 3], "x":3.75, "y":3},
+ {"matrix":[3, 4], "x":4.75, "y":3},
+ {"matrix":[3, 5], "x":5.75, "y":3},
+ {"matrix":[3, 6], "x":6.75, "y":3},
+ {"matrix":[3, 7], "x":7.75, "y":3},
+ {"matrix":[3, 8], "x":8.75, "y":3},
+ {"matrix":[3, 9], "x":9.75, "y":3},
+ {"matrix":[3,10], "x":10.75, "y":3},
+ {"matrix":[3,11], "x":11.75, "y":3},
+ {"matrix":[3,13], "x":12.75, "y":3},
+ {"matrix":[2,13], "x":13.75, "y":2, "w":1.25, "h": 2},
+ {"matrix":[3,15], "x":15, "y":3},
+
+ {"matrix":[4, 0], "x":0, "y":4, "w":2.25},
+ {"matrix":[4, 2], "x":2.25, "y":4},
+ {"matrix":[4, 3], "x":3.25, "y":4},
+ {"matrix":[4, 4], "x":4.25, "y":4},
+ {"matrix":[4, 5], "x":5.25, "y":4},
+ {"matrix":[4, 6], "x":6.25, "y":4},
+ {"matrix":[4, 7], "x":7.25, "y":4},
+ {"matrix":[4, 8], "x":8.25, "y":4},
+ {"matrix":[4, 9], "x":9.25, "y":4},
+ {"matrix":[4,10], "x":10.25, "y":4},
+ {"matrix":[4,11], "x":11.25, "y":4},
+ {"matrix":[4,12], "x":12.25, "y":4, "w":1.75},
+ {"matrix":[4,13], "x":14, "y":4},
+ {"matrix":[4,15], "x":15, "y":4},
+
+ {"matrix":[5, 0], "x":0, "y":5, "w":1.25},
+ {"matrix":[5, 1], "x":1.25, "y":5},
+ {"matrix":[5, 2], "x":2.25, "y":5, "w":1.25},
+ {"matrix":[5, 3], "x":3.5, "y":5},
+ {"matrix":[5, 6], "x":4.5, "y":5, "w":4.5},
+ {"matrix":[5, 9], "x":9, "y":5},
+ {"matrix":[5,10], "x":10, "y":5},
+ {"matrix":[5,11], "x":11, "y":5},
+ {"matrix":[5,12], "x":12, "y":5},
+ {"matrix":[5,13], "x":13, "y":5},
+ {"matrix":[5,14], "x":14, "y":5},
+ {"matrix":[5,15], "x":15, "y":5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/k2_max/iso/info.json b/keyboards/keychron/k2_max/iso/info.json
new file mode 100644
index 0000000000..c571ca5041
--- /dev/null
+++ b/keyboards/keychron/k2_max/iso/info.json
@@ -0,0 +1,10 @@
+{
+ "indicators": {
+ "caps_lock": "C8",
+ "on_state": 1
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "A13", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ }
+}
diff --git a/keyboards/keychron/k2_max/iso/rgb/config.h b/keyboards/keychron/k2_max/iso/rgb/config.h
new file mode 100644
index 0000000000..01809432ca
--- /dev/null
+++ b/keyboards/keychron/k2_max/iso/rgb/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 85
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 46
+# define LOW_BAT_IND_INDEX { 78 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k2_max/iso/rgb/keyboard.json b/keyboards/keychron/k2_max/iso/rgb/keyboard.json
new file mode 100644
index 0000000000..9b0b27c0bc
--- /dev/null
+++ b/keyboards/keychron/k2_max/iso/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A21",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k2_max/iso/rgb/keymaps/default/keymap.c b/keyboards/keychron/k2_max/iso/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..03adc224b2
--- /dev/null
+++ b/keyboards/keychron/k2_max/iso/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_iso_85(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, RGB_MOD,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_iso_85(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_BASE] = LAYOUT_iso_85(
+ 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_DEL, RGB_MOD,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_FN] = LAYOUT_iso_85(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k2_max/iso/rgb/rgb.c b/keyboards/keychron/k2_max/iso/rgb/rgb.c
new file mode 100644
index 0000000000..0ac678d365
--- /dev/null
+++ b/keyboards/keychron/k2_max/iso/rgb/rgb.c
@@ -0,0 +1,148 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1},
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA14, CB7_CA14, CB8_CA14},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {0, CB3_CA1, CB1_CA1, CB2_CA1},
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA14, CB1_CA14, CB2_CA14},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA13, CB1_CA13, CB2_CA13},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB9_CA15, CB7_CA15, CB8_CA15},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA13, CB7_CA13, CB8_CA13},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA10, CB4_CA10, CB5_CA10},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+ {1, CB6_CA5, CB4_CA5, CB5_CA5},
+ {1, CB6_CA4, CB4_CA4, CB5_CA4},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA1, CB4_CA1, CB5_CA1}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, __, 45 },
+ { 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __, 58, __, 59 },
+ { 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, 74 },
+ { 75, 76, 77, __, __, __, 78, __, __, 79, 80, 81, 82, 83, __, 84 }
+ },
+ {
+ {0, 0}, {14, 0}, {29, 0}, {44, 0}, {59, 0}, {74, 0}, { 89, 0}, {104, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209,0}, {223, 0},
+ {0,12}, {14,12}, {29,12}, {44,12}, {59,12}, {74,12}, { 89, 12}, {104, 12}, {119, 12}, {134, 12}, {149, 12}, {164, 12}, {179, 12}, {201, 12}, {223, 12},
+ {3,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 31}, {223, 25},
+ {5,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {190, 38}, {223, 38},
+ {2,51}, {18,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {187, 51}, {209, 51}, {223, 51},
+ {2,64}, {20,64}, {39,64}, { 95, 64}, {149, 64}, {164, 64}, {179, 64}, {194, 64}, {209, 64}, {223, 64}
+ },
+ {
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4
+ }
+};
+#endif
diff --git a/keyboards/keychron/k2_max/iso/rgb/rules.mk b/keyboards/keychron/k2_max/iso/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k2_max/iso/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k2_max/iso/white/config.h b/keyboards/keychron/k2_max/iso/white/config.h
new file mode 100644
index 0000000000..13a836a5b6
--- /dev/null
+++ b/keyboards/keychron/k2_max/iso/white/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 85
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+# define LED_MATRIX_VAL_STEP 16
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 46
+# define LOW_BAT_IND_INDEX \
+ { 78 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k2_max/iso/white/keyboard.json b/keyboards/keychron/k2_max/iso/white/keyboard.json
new file mode 100644
index 0000000000..09feaa1389
--- /dev/null
+++ b/keyboards/keychron/k2_max/iso/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A24",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k2_max/iso/white/keymaps/default/keymap.c b/keyboards/keychron/k2_max/iso/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..144e82273f
--- /dev/null
+++ b/keyboards/keychron/k2_max/iso/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_iso_85(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, BL_STEP,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_iso_85(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_BASE] = LAYOUT_iso_85(
+ 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_DEL, BL_STEP,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_FN] = LAYOUT_iso_85(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k2_max/iso/white/rules.mk b/keyboards/keychron/k2_max/iso/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k2_max/iso/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k2_max/iso/white/white.c b/keyboards/keychron/k2_max/iso/white/white.c
new file mode 100644
index 0000000000..fb733d521f
--- /dev/null
+++ b/keyboards/keychron/k2_max/iso/white/white.c
@@ -0,0 +1,151 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA16},
+ {0, CB1_CA15},
+ {0, CB1_CA14},
+ {0, CB1_CA13},
+ {0, CB1_CA12},
+ {0, CB1_CA11},
+ {0, CB1_CA10},
+ {0, CB1_CA9},
+ {0, CB1_CA8},
+ {0, CB1_CA7},
+ {0, CB1_CA6},
+ {0, CB1_CA5},
+ {0, CB1_CA4},
+ {0, CB1_CA3},
+ {0, CB1_CA2},
+ {0, CB1_CA1},
+
+ {0, CB2_CA16},
+ {0, CB2_CA15},
+ {0, CB2_CA14},
+ {0, CB2_CA13},
+ {0, CB2_CA12},
+ {0, CB2_CA11},
+ {0, CB2_CA10},
+ {0, CB2_CA9},
+ {0, CB2_CA8},
+ {0, CB2_CA7},
+ {0, CB2_CA6},
+ {0, CB2_CA5},
+ {0, CB2_CA4},
+ {0, CB2_CA3},
+ {0, CB2_CA1},
+
+ {0, CB3_CA16},
+ {0, CB3_CA15},
+ {0, CB3_CA14},
+ {0, CB3_CA13},
+ {0, CB3_CA12},
+ {0, CB3_CA11},
+ {0, CB3_CA10},
+ {0, CB3_CA9},
+ {0, CB3_CA8},
+ {0, CB3_CA7},
+ {0, CB3_CA6},
+ {0, CB3_CA5},
+ {0, CB3_CA4},
+ {0, CB3_CA3},
+ {0, CB3_CA1},
+
+ {0, CB4_CA16},
+ {0, CB4_CA15},
+ {0, CB4_CA14},
+ {0, CB4_CA13},
+ {0, CB4_CA12},
+ {0, CB4_CA11},
+ {0, CB4_CA10},
+ {0, CB4_CA9},
+ {0, CB4_CA8},
+ {0, CB4_CA7},
+ {0, CB4_CA6},
+ {0, CB4_CA5},
+ {0, CB4_CA3},
+ {0, CB4_CA1},
+
+ {0, CB5_CA16},
+ {0, CB5_CA15},
+ {0, CB5_CA14},
+ {0, CB5_CA13},
+ {0, CB5_CA12},
+ {0, CB5_CA11},
+ {0, CB5_CA10},
+ {0, CB5_CA9},
+ {0, CB5_CA8},
+ {0, CB5_CA7},
+ {0, CB5_CA6},
+ {0, CB5_CA5},
+ {0, CB5_CA4},
+ {0, CB5_CA3},
+ {0, CB5_CA1},
+
+ {0, CB6_CA16},
+ {0, CB6_CA15},
+ {0, CB6_CA14},
+ {0, CB6_CA10},
+ {0, CB6_CA7},
+ {0, CB6_CA6},
+ {0, CB6_CA5},
+ {0, CB6_CA4},
+ {0, CB6_CA3},
+ {0, CB6_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, __, 45 },
+ { 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __, 58, __, 59 },
+ { 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, 74 },
+ { 75, 76, 77, __, __, __, 78, __, __, 79, 80, 81, 82, 83, __, 84 }
+
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {14, 0}, {29, 0}, {44, 0}, {59, 0}, {74, 0}, { 89, 0}, {104, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209, 0}, {223, 0},
+ {0,12}, {14,12}, {29,12}, {44,12}, {59,12}, {74,12}, { 89, 12}, {104, 12}, {119, 12}, {134, 12}, {149, 12}, {164, 12}, {179, 12}, {201, 12}, {223, 12},
+ {3,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 31}, {223, 25},
+ {5,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {190, 38}, {223, 38},
+ {1,51}, {18,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {187, 51}, {209, 51}, {223, 51},
+ {1,64}, {20,64}, {39,64}, { 95, 64}, {149, 64}, {164, 64}, {179, 64}, {194, 64}, {209, 64}, {223, 64}
+ },
+ {
+ // RGB LED Index to Flag
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/k2_max/jis/info.json b/keyboards/keychron/k2_max/jis/info.json
new file mode 100644
index 0000000000..c571ca5041
--- /dev/null
+++ b/keyboards/keychron/k2_max/jis/info.json
@@ -0,0 +1,10 @@
+{
+ "indicators": {
+ "caps_lock": "C8",
+ "on_state": 1
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "A13", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ }
+}
diff --git a/keyboards/keychron/k2_max/jis/rgb/config.h b/keyboards/keychron/k2_max/jis/rgb/config.h
new file mode 100644
index 0000000000..14143fc351
--- /dev/null
+++ b/keyboards/keychron/k2_max/jis/rgb/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 87
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define CAPS_LOCK_INDEX 47
+# define LOW_BAT_IND_INDEX \
+ { 79 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k2_max/jis/rgb/keyboard.json b/keyboards/keychron/k2_max/jis/rgb/keyboard.json
new file mode 100644
index 0000000000..4d6443346e
--- /dev/null
+++ b/keyboards/keychron/k2_max/jis/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A22",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k2_max/jis/rgb/keymaps/default/keymap.c b/keyboards/keychron/k2_max/jis/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..479806e287
--- /dev/null
+++ b/keyboards/keychron/k2_max/jis/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_jis_87(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, RGB_MOD,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_UP, KC_END,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_jis_87(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_BASE] = LAYOUT_jis_87(
+ 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_DEL, RGB_MOD,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_UP, KC_END,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_FN] = LAYOUT_jis_87(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k2_max/jis/rgb/rgb.c b/keyboards/keychron/k2_max/jis/rgb/rgb.c
new file mode 100644
index 0000000000..86ad60982f
--- /dev/null
+++ b/keyboards/keychron/k2_max/jis/rgb/rgb.c
@@ -0,0 +1,154 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1},
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA14, CB7_CA14, CB8_CA14},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {0, CB3_CA1, CB1_CA1, CB2_CA1},
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA14, CB1_CA14, CB2_CA14},
+ {0, CB3_CA15, CB1_CA15, CB2_CA15},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA13, CB1_CA13, CB2_CA13},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA13, CB7_CA13, CB8_CA13},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA10, CB4_CA10, CB5_CA10},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+ {1, CB6_CA5, CB4_CA5, CB5_CA5},
+ {1, CB6_CA4, CB4_CA4, CB5_CA4},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA1, CB4_CA1, CB5_CA1}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31 },
+ { 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, __, 46 },
+ { 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, __, 59, __, 60 },
+ { 61, __, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, __, 72, 73, 74 },
+ { 75, 76, 77, 78, __, __, 79, __, __, 80, 81, 82, 83, 84, 85, 86 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {30, 0}, {45, 0}, {60, 0}, {75, 0}, { 90, 0}, {105, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209, 0}, {224, 0},
+ {0,13}, {15,13}, {30,13}, {45,13}, {60,13}, {75,13}, { 90,13}, {105,13}, {119,13}, {134,13}, {149,13}, {164,13}, {179,13}, {194,13}, {209,13}, {224,13},
+ {4,26}, {22,26}, {37,26}, {52,26}, {67,26}, {82,26}, { 97,26}, {112,26}, {127,26}, {142,26}, {157,26}, {172,26}, {187,26}, {207,32}, {224,26},
+ {6,38}, {26,38}, {41,38}, {56,38}, {71,38}, {86,38}, {101,38}, {116,38}, {131,38}, {146,38}, {161,38}, {175,38}, {190,38}, {224,38},
+ {9,51}, {34,51}, {49,51}, {64,51}, {78,51}, { 93,51}, {108,51}, {123,51}, {138,51}, {153,51}, {168,51}, {183,51}, {203,51}, {224,51},
+ {0,64}, {15,64}, {30,64}, {45,64}, { 90,64}, {134,64}, {149,64}, {164,64}, {179,64}, {194,64}, {209,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k2_max/jis/rgb/rules.mk b/keyboards/keychron/k2_max/jis/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k2_max/jis/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k2_max/jis/white/config.h b/keyboards/keychron/k2_max/jis/white/config.h
new file mode 100644
index 0000000000..865838ea7a
--- /dev/null
+++ b/keyboards/keychron/k2_max/jis/white/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 87
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+# define LED_MATRIX_VAL_STEP 16
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 47
+# define LOW_BAT_IND_INDEX \
+ { 79 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k2_max/jis/white/keyboard.json b/keyboards/keychron/k2_max/jis/white/keyboard.json
new file mode 100644
index 0000000000..c043fe7c31
--- /dev/null
+++ b/keyboards/keychron/k2_max/jis/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A25",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k2_max/jis/white/keymaps/default/keymap.c b/keyboards/keychron/k2_max/jis/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..038dc3d090
--- /dev/null
+++ b/keyboards/keychron/k2_max/jis/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_jis_87(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, BL_STEP,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_UP, KC_END,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_jis_87(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_BASE] = LAYOUT_jis_87(
+ 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_DEL, BL_STEP,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_UP, KC_END,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_FN] = LAYOUT_jis_87(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k2_max/jis/white/rules.mk b/keyboards/keychron/k2_max/jis/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k2_max/jis/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k2_max/jis/white/white.c b/keyboards/keychron/k2_max/jis/white/white.c
new file mode 100644
index 0000000000..791fd39e1e
--- /dev/null
+++ b/keyboards/keychron/k2_max/jis/white/white.c
@@ -0,0 +1,151 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA16},
+ {0, CB1_CA15},
+ {0, CB1_CA14},
+ {0, CB1_CA13},
+ {0, CB1_CA12},
+ {0, CB1_CA11},
+ {0, CB1_CA10},
+ {0, CB1_CA9},
+ {0, CB1_CA8},
+ {0, CB1_CA7},
+ {0, CB1_CA6},
+ {0, CB1_CA5},
+ {0, CB1_CA4},
+ {0, CB1_CA3},
+ {0, CB1_CA2},
+ {0, CB1_CA1},
+
+ {0, CB2_CA16},
+ {0, CB2_CA15},
+ {0, CB2_CA14},
+ {0, CB2_CA13},
+ {0, CB2_CA12},
+ {0, CB2_CA11},
+ {0, CB2_CA10},
+ {0, CB2_CA9},
+ {0, CB2_CA8},
+ {0, CB2_CA7},
+ {0, CB2_CA6},
+ {0, CB2_CA5},
+ {0, CB2_CA4},
+ {0, CB2_CA3},
+ {0, CB2_CA2},
+ {0, CB2_CA1},
+
+ {0, CB3_CA16},
+ {0, CB3_CA15},
+ {0, CB3_CA14},
+ {0, CB3_CA13},
+ {0, CB3_CA12},
+ {0, CB3_CA11},
+ {0, CB3_CA10},
+ {0, CB3_CA9},
+ {0, CB3_CA8},
+ {0, CB3_CA7},
+ {0, CB3_CA6},
+ {0, CB3_CA5},
+ {0, CB3_CA4},
+ {0, CB3_CA3},
+ {0, CB3_CA1},
+
+ {0, CB4_CA16},
+ {0, CB4_CA15},
+ {0, CB4_CA14},
+ {0, CB4_CA13},
+ {0, CB4_CA12},
+ {0, CB4_CA11},
+ {0, CB4_CA10},
+ {0, CB4_CA9},
+ {0, CB4_CA8},
+ {0, CB4_CA7},
+ {0, CB4_CA6},
+ {0, CB4_CA5},
+ {0, CB4_CA3},
+ {0, CB4_CA1},
+
+ {0, CB5_CA16},
+ {0, CB5_CA14},
+ {0, CB5_CA13},
+ {0, CB5_CA12},
+ {0, CB5_CA11},
+ {0, CB5_CA10},
+ {0, CB5_CA9},
+ {0, CB5_CA8},
+ {0, CB5_CA7},
+ {0, CB5_CA6},
+ {0, CB5_CA5},
+ {0, CB5_CA4},
+ {0, CB5_CA3},
+ {0, CB5_CA1},
+
+ {0, CB6_CA16},
+ {0, CB6_CA15},
+ {0, CB6_CA14},
+ {0, CB6_CA13},
+ {0, CB6_CA10},
+ {0, CB6_CA7},
+ {0, CB6_CA6},
+ {0, CB6_CA5},
+ {0, CB6_CA4},
+ {0, CB6_CA3},
+ {0, CB6_CA2},
+ {0, CB6_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31 },
+ { 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, __, 46 },
+ { 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, __, 59, __, 60 },
+ { 61, __, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, __, 72, 73, 74 },
+ { 75, 76, 77, 78, __, __, 79, __, __, 80, 81, 82, 83, 84, 85, 86 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {30, 0}, {45, 0}, {60, 0}, {75, 0}, { 90, 0}, {105, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209, 0}, {224, 0},
+ {0,13}, {15,13}, {30,13}, {45,13}, {60,13}, {75,13}, { 90,13}, {105,13}, {119,13}, {134,13}, {149,13}, {164,13}, {179,13}, {194,13}, {209,13}, {224,13},
+ {4,26}, {22,26}, {37,26}, {52,26}, {67,26}, {82,26}, { 97,26}, {112,26}, {127,26}, {142,26}, {157,26}, {172,26}, {187,26}, {207,32}, {224,26},
+ {6,38}, {26,38}, {41,38}, {56,38}, {71,38}, {86,38}, {101,38}, {116,38}, {131,38}, {146,38}, {161,38}, {175,38}, {190,38}, {224,38},
+ {9,51}, {34,51}, {49,51}, {64,51}, {78,51}, { 93,51}, {108,51}, {123,51}, {138,51}, {153,51}, {168,51}, {183,51}, {203,51}, {224,51},
+ {0,64}, {15,64}, {30,64}, {45,64}, { 90,64}, {134,64}, {149,64}, {164,64}, {179,64}, {194,64}, {209,64}, {224,64}
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k2_max/k2_max.c b/keyboards/keychron/k2_max/k2_max.c
new file mode 100644
index 0000000000..bb41317172
--- /dev/null
+++ b/keyboards/keychron/k2_max/k2_max.c
@@ -0,0 +1,56 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "transport.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 2 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/k2_max/mcuconf.h b/keyboards/keychron/k2_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/k2_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/k2_max/readme.md b/keyboards/keychron/k2_max/readme.md
new file mode 100644
index 0000000000..12d21f8ba4
--- /dev/null
+++ b/keyboards/keychron/k2_max/readme.md
@@ -0,0 +1,35 @@
+# Keychron K2 Max
+
+
+
+A customizable 84 keys TKL keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron K2 Max
+* Hardware Availability: [Keychron K2 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/collections/keychron-k-max-series-keyboard/products/keychron-k2-max-qmk-wireless-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/k2_max/ansi/rgb:default
+ make keychron/k2_max/ansi/white:default
+
+ make keychron/k2_max/iso/rgb:default
+ make keychron/k2_max/iso/white:default
+
+ make keychron/k2_max/jis/rgb:default
+ make keychron/k2_max/jis/white:default
+
+Flashing example for this keyboard:
+
+ make keychron/k2_max/ansi/rgb:default:flash
+ make keychron/k2_max/ansi/white:default:flash
+
+ make keychron/k2_max/iso/rgb:default:flash
+ make keychron/k2_max/iso/white:default:flash
+
+ make keychron/k2_max/jis/rgb:default:flash
+ make keychron/k2_max/jis/white:default:flash
+
+**Reset Key**: Disconnect the USB cable, toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar, then connect the USB cable.
+
+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).
diff --git a/keyboards/keychron/k2_max/rules.mk b/keyboards/keychron/k2_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/k2_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/k2_max/via_json/k2_max_ansi_rgb.json b/keyboards/keychron/k2_max/via_json/k2_max_ansi_rgb.json
new file mode 100644
index 0000000000..db597ab35f
--- /dev/null
+++ b/keyboards/keychron/k2_max/via_json/k2_max_ansi_rgb.json
@@ -0,0 +1,266 @@
+{
+ "name": "Keychron K2 Max ANSI RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A20",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,13",
+ "0,14",
+ "0,15"
+ ],
+ [
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,13",
+ "1,15"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,13",
+ "2,15"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,13",
+ {
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ {
+ "w": 2.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,12",
+ {
+ "c": "#cccccc"
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,9",
+ "5,10",
+ "5,11",
+ {
+ "c": "#cccccc"
+ },
+ "5,12",
+ "5,13",
+ "5,15"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k2_max/via_json/k2_max_ansi_white.json b/keyboards/keychron/k2_max/via_json/k2_max_ansi_white.json
new file mode 100644
index 0000000000..0a3bd4ddc4
--- /dev/null
+++ b/keyboards/keychron/k2_max/via_json/k2_max_ansi_white.json
@@ -0,0 +1,205 @@
+{
+ "name": "Keychron K2 Max ANSI White",
+ "vendorId": "0x3434",
+ "productId": "0x0A23",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,13",
+ "0,14",
+ "0,15"
+ ],
+ [
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,13",
+ "1,15"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,13",
+ "2,15"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,13",
+ {
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ {
+ "w": 2.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,12",
+ {
+ "c": "#cccccc"
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,9",
+ "5,10",
+ "5,11",
+ {
+ "c": "#cccccc"
+ },
+ "5,12",
+ "5,13",
+ "5,15"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k2_max/via_json/k2_max_iso_rgb.json b/keyboards/keychron/k2_max/via_json/k2_max_iso_rgb.json
new file mode 100644
index 0000000000..e7cc996731
--- /dev/null
+++ b/keyboards/keychron/k2_max/via_json/k2_max_iso_rgb.json
@@ -0,0 +1,269 @@
+{
+ "name": "Keychron K2 Max ISO RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A21",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,13",
+ "0,14",
+ "0,15"
+ ],
+ [
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,13",
+ "1,15"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,13",
+ "2,15"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,1",
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,12",
+ {
+ "c": "#cccccc"
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,9",
+ "5,10",
+ "5,11",
+ {
+ "c": "#cccccc"
+ },
+ "5,12",
+ "5,13",
+ "5,15"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k2_max/via_json/k2_max_iso_white.json b/keyboards/keychron/k2_max/via_json/k2_max_iso_white.json
new file mode 100644
index 0000000000..8c41349811
--- /dev/null
+++ b/keyboards/keychron/k2_max/via_json/k2_max_iso_white.json
@@ -0,0 +1,208 @@
+{
+ "name": "Keychron K2 Max ISO White",
+ "vendorId": "0x3434",
+ "productId": "0x0A24",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,13",
+ "0,14",
+ "0,15"
+ ],
+ [
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,13",
+ "1,15"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,13",
+ "2,15"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,1",
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,12",
+ {
+ "c": "#cccccc"
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,9",
+ "5,10",
+ "5,11",
+ {
+ "c": "#cccccc"
+ },
+ "5,12",
+ "5,13",
+ "5,15"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k2_max/via_json/k2_max_jis_rgb.json b/keyboards/keychron/k2_max/via_json/k2_max_jis_rgb.json
new file mode 100644
index 0000000000..cc86fdb586
--- /dev/null
+++ b/keyboards/keychron/k2_max/via_json/k2_max_jis_rgb.json
@@ -0,0 +1,261 @@
+{
+ "name": "Keychron K2 Max JIS RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A22",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,13",
+ "0,14",
+ "0,15"
+ ],
+ [
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ "1,13",
+ "1,14",
+ {
+ "c": "#aaaaaa"
+ },
+ "1,15"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,13",
+ "2,15"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ {
+ "w": 2.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,13",
+ "4,15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "5,0",
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ "5,3",
+ {
+ "c": "#cccccc",
+ "w": 4.5
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,9",
+ "5,10",
+ "5,11",
+ "5,12",
+ {
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k2_max/via_json/k2_max_jis_white.json b/keyboards/keychron/k2_max/via_json/k2_max_jis_white.json
new file mode 100644
index 0000000000..8ed26559e9
--- /dev/null
+++ b/keyboards/keychron/k2_max/via_json/k2_max_jis_white.json
@@ -0,0 +1,200 @@
+{
+ "name": "Keychron K2 Max JIS White",
+ "vendorId": "0x3434",
+ "productId": "0x0A25",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0,13",
+ "0,14",
+ "0,15"
+ ],
+ [
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ "1,13",
+ "1,14",
+ {
+ "c": "#aaaaaa"
+ },
+ "1,15"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,13",
+ "2,15"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ {
+ "w": 2.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,13",
+ "4,15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "5,0",
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ "5,3",
+ {
+ "c": "#cccccc",
+ "w": 4.5
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,9",
+ "5,10",
+ "5,11",
+ "5,12",
+ {
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k3_max/ansi/rgb/config.h b/keyboards/keychron/k3_max/ansi/rgb/config.h
new file mode 100644
index 0000000000..7600ab8ba8
--- /dev/null
+++ b/keyboards/keychron/k3_max/ansi/rgb/config.h
@@ -0,0 +1,48 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 84
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 46
+# define LOW_BAT_IND_INDEX \
+ { 77 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k3_max/ansi/rgb/keyboard.json b/keyboards/keychron/k3_max/ansi/rgb/keyboard.json
new file mode 100644
index 0000000000..e38679305b
--- /dev/null
+++ b/keyboards/keychron/k3_max/ansi/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A30",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_max/ansi/rgb/keymaps/default/keymap.c b/keyboards/keychron/k3_max/ansi/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..645230ccb9
--- /dev/null
+++ b/keyboards/keychron/k3_max/ansi/rgb/keymaps/default/keymap.c
@@ -0,0 +1,68 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_ansi_84(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, RGB_MOD,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_ansi_84(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_BASE] = LAYOUT_ansi_84(
+ 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_DEL, RGB_MOD,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_FN] = LAYOUT_ansi_84(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k3_max/ansi/rgb/rgb.c b/keyboards/keychron/k3_max/ansi/rgb/rgb.c
new file mode 100644
index 0000000000..45befff6b1
--- /dev/null
+++ b/keyboards/keychron/k3_max/ansi/rgb/rgb.c
@@ -0,0 +1,150 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1},
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA14, CB7_CA14, CB8_CA14},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, __, 45 },
+ { 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __, 58, __, 59 },
+ { 60, __, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, __, 71, 72, 73 },
+ { 74, 75, 76, __, __, __, 77, __, __, __, 78, 79, 80, 81, 82, 83 }
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {14, 0}, {29, 0}, {44, 0}, {59, 0}, {74, 0}, { 89, 0}, {104, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209, 0}, {223, 0},
+ {0,12}, {14,12}, {29,12}, {44,12}, {59,12}, {74,12}, { 89, 12}, {104, 12}, {119, 12}, {134, 12}, {149, 12}, {164, 12}, {179, 12}, {201, 12}, {223, 12},
+ {3,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 25}, {223, 25},
+ {5,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {199, 38}, {223, 38},
+ {9,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {188, 51}, {209, 51}, {223, 51},
+ {1,64}, {20,64}, {39,64}, { 95, 64}, {149, 64}, {164, 64}, {179, 64}, {194, 64}, {209, 64}, {223, 64}
+ },
+ {
+ // RGB LED Index to Flag
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4
+ }
+};
+#endif
diff --git a/keyboards/keychron/k3_max/ansi/rgb/rules.mk b/keyboards/keychron/k3_max/ansi/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k3_max/ansi/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k3_max/ansi/white/config.h b/keyboards/keychron/k3_max/ansi/white/config.h
new file mode 100644
index 0000000000..1ab8510cf8
--- /dev/null
+++ b/keyboards/keychron/k3_max/ansi/white/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 84
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 46
+# define LOW_BAT_IND_INDEX \
+ { 77 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k3_max/ansi/white/keyboard.json b/keyboards/keychron/k3_max/ansi/white/keyboard.json
new file mode 100644
index 0000000000..01b475fa03
--- /dev/null
+++ b/keyboards/keychron/k3_max/ansi/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A33",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_max/ansi/white/keymaps/default/keymap.c b/keyboards/keychron/k3_max/ansi/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..240da939de
--- /dev/null
+++ b/keyboards/keychron/k3_max/ansi/white/keymaps/default/keymap.c
@@ -0,0 +1,68 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_ansi_84(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, BL_STEP,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_ansi_84(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_BASE] = LAYOUT_ansi_84(
+ 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_DEL, BL_STEP,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_FN] = LAYOUT_ansi_84(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k3_max/ansi/white/rules.mk b/keyboards/keychron/k3_max/ansi/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k3_max/ansi/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k3_max/ansi/white/white.c b/keyboards/keychron/k3_max/ansi/white/white.c
new file mode 100644
index 0000000000..5038005a44
--- /dev/null
+++ b/keyboards/keychron/k3_max/ansi/white/white.c
@@ -0,0 +1,149 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA4},
+ {0, CB1_CA5},
+ {0, CB1_CA6},
+ {0, CB1_CA7},
+ {0, CB1_CA8},
+ {0, CB1_CA9},
+ {0, CB1_CA10},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA13},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA14},
+ {0, CB4_CA16},
+
+ {0, CB5_CA1},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA7},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA14},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, __, 45 },
+ { 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __, 58, __, 59 },
+ { 60, __, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, __, 71, 72, 73 },
+ { 74, 75, 76, __, __, __, 77, __, __, __, 78, 79, 80, 81, 82, 83 }
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {14, 0}, {29, 0}, {44, 0}, {59, 0}, {74, 0}, { 89, 0}, {104, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209, 0}, {223, 0},
+ {0,12}, {14,12}, {29,12}, {44,12}, {59,12}, {74,12}, { 89, 12}, {104, 12}, {119, 12}, {134, 12}, {149, 12}, {164, 12}, {179, 12}, {201, 12}, {223, 12},
+ {3,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 25}, {223, 25},
+ {5,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {199, 38}, {223, 38},
+ {9,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {188, 51}, {209, 51}, {223, 51},
+ {1,64}, {20,64}, {39,64}, { 95, 64}, {149, 64}, {164, 64}, {179, 64}, {194, 64}, {209, 64}, {223, 64}
+ },
+ {
+ // RGB LED Index to Flag
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/k3_max/board.h b/keyboards/keychron/k3_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/k3_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/k3_max/config.h b/keyboards/keychron/k3_max/config.h
new file mode 100644
index 0000000000..da3598c441
--- /dev/null
+++ b/keyboards/keychron/k3_max/config.h
@@ -0,0 +1,78 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/k3_max/halconf.h b/keyboards/keychron/k3_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/k3_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/k3_max/info.json b/keyboards/keychron/k3_max/info.json
new file mode 100644
index 0000000000..0e17f7eaae
--- /dev/null
+++ b/keyboards/keychron/k3_max/info.json
@@ -0,0 +1,325 @@
+{
+ "keyboard_name": "Keychron K3 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey": true,
+ "mousekey": true,
+ "dip_switch": true,
+ "nkro": true,
+ "raw": true,
+ "send_string": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch": {
+ "pins": ["B14"]
+ },
+ "indicators": {
+ "caps_lock": "A13",
+ "on_state": 1
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "layouts": {
+ "LAYOUT_ansi_84": {
+ "layout": [
+ {"matrix":[0, 0], "x":0, "y":0},
+ {"matrix":[0, 1], "x":1, "y":0},
+ {"matrix":[0, 2], "x":2, "y":0},
+ {"matrix":[0, 3], "x":3, "y":0},
+ {"matrix":[0, 4], "x":4, "y":0},
+ {"matrix":[0, 5], "x":5, "y":0},
+ {"matrix":[0, 6], "x":6, "y":0},
+ {"matrix":[0, 7], "x":7, "y":0},
+ {"matrix":[0, 8], "x":8, "y":0},
+ {"matrix":[0, 9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14, "y":0},
+ {"matrix":[0,15], "x":15, "y":0},
+
+ {"matrix":[1, 0], "x":0, "y":1},
+ {"matrix":[1, 1], "x":1, "y":1},
+ {"matrix":[1, 2], "x":2, "y":1},
+ {"matrix":[1, 3], "x":3, "y":1},
+ {"matrix":[1, 4], "x":4, "y":1},
+ {"matrix":[1, 5], "x":5, "y":1},
+ {"matrix":[1, 6], "x":6, "y":1},
+ {"matrix":[1, 7], "x":7, "y":1},
+ {"matrix":[1, 8], "x":8, "y":1},
+ {"matrix":[1, 9], "x":9, "y":1},
+ {"matrix":[1,10], "x":10, "y":1},
+ {"matrix":[1,11], "x":11, "y":1},
+ {"matrix":[1,12], "x":12, "y":1},
+ {"matrix":[1,13], "x":13, "y":1, "w":2},
+ {"matrix":[1,15], "x":15, "y":1},
+
+ {"matrix":[2, 0], "x":0, "y":2, "w":1.5},
+ {"matrix":[2, 1], "x":1.5, "y":2},
+ {"matrix":[2, 2], "x":2.5, "y":2},
+ {"matrix":[2, 3], "x":3.5, "y":2},
+ {"matrix":[2, 4], "x":4.5, "y":2},
+ {"matrix":[2, 5], "x":5.5, "y":2},
+ {"matrix":[2, 6], "x":6.5, "y":2},
+ {"matrix":[2, 7], "x":7.5, "y":2},
+ {"matrix":[2, 8], "x":8.5, "y":2},
+ {"matrix":[2, 9], "x":9.5, "y":2},
+ {"matrix":[2,10], "x":10.5, "y":2},
+ {"matrix":[2,11], "x":11.5, "y":2},
+ {"matrix":[2,12], "x":12.5, "y":2},
+ {"matrix":[2,13], "x":13.5, "y":2, "w":1.5},
+ {"matrix":[2,15], "x":15, "y":2},
+
+ {"matrix":[3, 0], "x":0, "y":3, "w":1.75},
+ {"matrix":[3, 1], "x":1.75, "y":3},
+ {"matrix":[3, 2], "x":2.75, "y":3},
+ {"matrix":[3, 3], "x":3.75, "y":3},
+ {"matrix":[3, 4], "x":4.75, "y":3},
+ {"matrix":[3, 5], "x":5.75, "y":3},
+ {"matrix":[3, 6], "x":6.75, "y":3},
+ {"matrix":[3, 7], "x":7.75, "y":3},
+ {"matrix":[3, 8], "x":8.75, "y":3},
+ {"matrix":[3, 9], "x":9.75, "y":3},
+ {"matrix":[3,10], "x":10.75, "y":3},
+ {"matrix":[3,11], "x":11.75, "y":3},
+ {"matrix":[3,13], "x":12.75, "y":3, "w":2.25},
+ {"matrix":[3,15], "x":15, "y":3},
+
+ {"matrix":[4, 0], "x":0, "y":4, "w":2.25},
+ {"matrix":[4, 2], "x":2.25, "y":4},
+ {"matrix":[4, 3], "x":3.25, "y":4},
+ {"matrix":[4, 4], "x":4.25, "y":4},
+ {"matrix":[4, 5], "x":5.25, "y":4},
+ {"matrix":[4, 6], "x":6.25, "y":4},
+ {"matrix":[4, 7], "x":7.25, "y":4},
+ {"matrix":[4, 8], "x":8.25, "y":4},
+ {"matrix":[4, 9], "x":9.25, "y":4},
+ {"matrix":[4,10], "x":10.25, "y":4},
+ {"matrix":[4,11], "x":11.25, "y":4},
+ {"matrix":[4,13], "x":12.25, "y":4, "w":1.75},
+ {"matrix":[4,14], "x":14, "y":4},
+ {"matrix":[4,15], "x":15, "y":4},
+
+ {"matrix":[5, 0], "x":0, "y":5, "w":1.25},
+ {"matrix":[5, 1], "x":1.25, "y":5, "w":1.25},
+ {"matrix":[5, 2], "x":2.5, "y":5, "w":1.25},
+ {"matrix":[5, 6], "x":3.75, "y":5, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5},
+ {"matrix":[5,11], "x":11, "y":5},
+ {"matrix":[5,12], "x":12, "y":5},
+ {"matrix":[5,13], "x":13, "y":5},
+ {"matrix":[5,14], "x":14, "y":5},
+ {"matrix":[5,15], "x":15, "y":5}
+ ]
+ },
+ "LAYOUT_iso_85": {
+ "layout": [
+ {"matrix":[0, 0], "x":0, "y":0},
+ {"matrix":[0, 1], "x":1, "y":0},
+ {"matrix":[0, 2], "x":2, "y":0},
+ {"matrix":[0, 3], "x":3, "y":0},
+ {"matrix":[0, 4], "x":4, "y":0},
+ {"matrix":[0, 5], "x":5, "y":0},
+ {"matrix":[0, 6], "x":6, "y":0},
+ {"matrix":[0, 7], "x":7, "y":0},
+ {"matrix":[0, 8], "x":8, "y":0},
+ {"matrix":[0, 9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14, "y":0},
+ {"matrix":[0,15], "x":15, "y":0},
+
+ {"matrix":[1, 0], "x":0, "y":1},
+ {"matrix":[1, 1], "x":1, "y":1},
+ {"matrix":[1, 2], "x":2, "y":1},
+ {"matrix":[1, 3], "x":3, "y":1},
+ {"matrix":[1, 4], "x":4, "y":1},
+ {"matrix":[1, 5], "x":5, "y":1},
+ {"matrix":[1, 6], "x":6, "y":1},
+ {"matrix":[1, 7], "x":7, "y":1},
+ {"matrix":[1, 8], "x":8, "y":1},
+ {"matrix":[1, 9], "x":9, "y":1},
+ {"matrix":[1,10], "x":10, "y":1},
+ {"matrix":[1,11], "x":11, "y":1},
+ {"matrix":[1,12], "x":12, "y":1},
+ {"matrix":[1,13], "x":13, "y":1, "w":2},
+ {"matrix":[1,15], "x":15, "y":1},
+
+ {"matrix":[2, 0], "x":0, "y":2, "w":1.5},
+ {"matrix":[2, 1], "x":1.5, "y":2},
+ {"matrix":[2, 2], "x":2.5, "y":2},
+ {"matrix":[2, 3], "x":3.5, "y":2},
+ {"matrix":[2, 4], "x":4.5, "y":2},
+ {"matrix":[2, 5], "x":5.5, "y":2},
+ {"matrix":[2, 6], "x":6.5, "y":2},
+ {"matrix":[2, 7], "x":7.5, "y":2},
+ {"matrix":[2, 8], "x":8.5, "y":2},
+ {"matrix":[2, 9], "x":9.5, "y":2},
+ {"matrix":[2,10], "x":10.5, "y":2},
+ {"matrix":[2,11], "x":11.5, "y":2},
+ {"matrix":[2,12], "x":12.5, "y":2},
+ {"matrix":[2,15], "x":15, "y":2},
+
+ {"matrix":[3, 0], "x":0, "y":3, "w":1.75},
+ {"matrix":[3, 1], "x":1.75, "y":3},
+ {"matrix":[3, 2], "x":2.75, "y":3},
+ {"matrix":[3, 3], "x":3.75, "y":3},
+ {"matrix":[3, 4], "x":4.75, "y":3},
+ {"matrix":[3, 5], "x":5.75, "y":3},
+ {"matrix":[3, 6], "x":6.75, "y":3},
+ {"matrix":[3, 7], "x":7.75, "y":3},
+ {"matrix":[3, 8], "x":8.75, "y":3},
+ {"matrix":[3, 9], "x":9.75, "y":3},
+ {"matrix":[3,10], "x":10.75, "y":3},
+ {"matrix":[3,11], "x":11.75, "y":3},
+ {"matrix":[3,13], "x":12.75, "y":3},
+ {"matrix":[2,13], "x":13.75, "y":2, "w": 1.25, "h": 2},
+ {"matrix":[3,15], "x":15, "y":3},
+
+ {"matrix":[4, 0], "x":0, "y":4, "w":1.25},
+ {"matrix":[4, 1], "x":1.25, "y":4},
+ {"matrix":[4, 2], "x":2.25, "y":4},
+ {"matrix":[4, 3], "x":3.25, "y":4},
+ {"matrix":[4, 4], "x":4.25, "y":4},
+ {"matrix":[4, 5], "x":5.25, "y":4},
+ {"matrix":[4, 6], "x":6.25, "y":4},
+ {"matrix":[4, 7], "x":7.25, "y":4},
+ {"matrix":[4, 8], "x":8.25, "y":4},
+ {"matrix":[4, 9], "x":9.25, "y":4},
+ {"matrix":[4,10], "x":10.25, "y":4},
+ {"matrix":[4,11], "x":11.25, "y":4},
+ {"matrix":[4,13], "x":12.25, "y":4, "w":1.75},
+ {"matrix":[4,14], "x":14, "y":4},
+ {"matrix":[4,15], "x":15, "y":4},
+
+ {"matrix":[5, 0], "x":0, "y":5, "w":1.25},
+ {"matrix":[5, 1], "x":1.25, "y":5, "w":1.25},
+ {"matrix":[5, 2], "x":2.5, "y":5, "w":1.25},
+ {"matrix":[5, 6], "x":3.75, "y":5, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5},
+ {"matrix":[5,11], "x":11, "y":5},
+ {"matrix":[5,12], "x":12, "y":5},
+ {"matrix":[5,13], "x":13, "y":5},
+ {"matrix":[5,14], "x":14, "y":5},
+ {"matrix":[5,15], "x":15, "y":5}
+ ]
+ },
+ "LAYOUT_jis_87": {
+ "layout": [
+ {"matrix":[0, 0], "x":0, "y":0},
+ {"matrix":[0, 1], "x":1, "y":0},
+ {"matrix":[0, 2], "x":2, "y":0},
+ {"matrix":[0, 3], "x":3, "y":0},
+ {"matrix":[0, 4], "x":4, "y":0},
+ {"matrix":[0, 5], "x":5, "y":0},
+ {"matrix":[0, 6], "x":6, "y":0},
+ {"matrix":[0, 7], "x":7, "y":0},
+ {"matrix":[0, 8], "x":8, "y":0},
+ {"matrix":[0, 9], "x":9, "y":0},
+ {"matrix":[0, 10], "x":10, "y":0},
+ {"matrix":[0, 11], "x":11, "y":0},
+ {"matrix":[0, 12], "x":12, "y":0},
+ {"matrix":[0, 13], "x":13, "y":0},
+ {"matrix":[0, 14], "x":14, "y":0},
+ {"matrix":[0, 15], "x":15, "y":0},
+
+ {"matrix":[1, 0], "x":0, "y":1},
+ {"matrix":[1, 1], "x":1, "y":1},
+ {"matrix":[1, 2], "x":2, "y":1},
+ {"matrix":[1, 3], "x":3, "y":1},
+ {"matrix":[1, 4], "x":4, "y":1},
+ {"matrix":[1, 5], "x":5, "y":1},
+ {"matrix":[1, 6], "x":6, "y":1},
+ {"matrix":[1, 7], "x":7, "y":1},
+ {"matrix":[1, 8], "x":8, "y":1},
+ {"matrix":[1, 9], "x":9, "y":1},
+ {"matrix":[1, 10], "x":10, "y":1},
+ {"matrix":[1, 11], "x":11, "y":1},
+ {"matrix":[1, 12], "x":12, "y":1},
+ {"matrix":[1, 13], "x":13, "y":1},
+ {"matrix":[1, 14], "x":14, "y":1},
+ {"matrix":[1, 15], "x":15, "y":1},
+
+ {"matrix":[2, 0], "x":0, "y":2, "w": 1.5},
+ {"matrix":[2, 1], "x":1.5, "y":2},
+ {"matrix":[2, 2], "x":2.5, "y":2},
+ {"matrix":[2, 3], "x":3.5, "y":2},
+ {"matrix":[2, 4], "x":4.5, "y":2},
+ {"matrix":[2, 5], "x":5.5, "y":2},
+ {"matrix":[2, 6], "x":6.5, "y":2},
+ {"matrix":[2, 7], "x":7.5, "y":2},
+ {"matrix":[2, 8], "x":8.5, "y":2},
+ {"matrix":[2, 9], "x":9.5, "y":2},
+ {"matrix":[2, 10], "x":10.5, "y":2},
+ {"matrix":[2, 11], "x":11.5, "y":2},
+ {"matrix":[2, 12], "x":12.5, "y":2},
+ {"matrix":[2, 15], "x":15, "y":2},
+
+ {"matrix":[3, 0], "x":0, "y":3, "w": 1.75},
+ {"matrix":[3, 1], "x":1.75, "y":3},
+ {"matrix":[3, 2], "x":2.75, "y":3},
+ {"matrix":[3, 3], "x":3.75, "y":3},
+ {"matrix":[3, 4], "x":4.75, "y":3},
+ {"matrix":[3, 5], "x":5.75, "y":3},
+ {"matrix":[3, 6], "x":6.75, "y":3},
+ {"matrix":[3, 7], "x":7.75, "y":3},
+ {"matrix":[3, 8], "x":8.75, "y":3},
+ {"matrix":[3, 9], "x":9.75, "y":3},
+ {"matrix":[3, 10], "x":10.75, "y":3},
+ {"matrix":[3, 11], "x":11.75, "y":3},
+ {"matrix":[3, 13], "x":12.75, "y":3},
+ {"matrix":[2, 13], "x":13.75, "y":2, "w": 1.25, "h": 2},
+ {"matrix":[3, 15], "x":15, "y":3},
+
+ {"matrix":[4, 0], "x":0, "y":4, "w": 2.25},
+ {"matrix":[4, 2], "x":2.25, "y":4},
+ {"matrix":[4, 3], "x":3.25, "y":4},
+ {"matrix":[4, 4], "x":4.25, "y":4},
+ {"matrix":[4, 5], "x":5.25, "y":4},
+ {"matrix":[4, 6], "x":6.25, "y":4},
+ {"matrix":[4, 7], "x":7.25, "y":4},
+ {"matrix":[4, 8], "x":8.25, "y":4},
+ {"matrix":[4, 9], "x":9.25, "y":4},
+ {"matrix":[4, 10], "x":10.25, "y":4},
+ {"matrix":[4, 11], "x":11.25, "y":4},
+ {"matrix":[4, 13], "x":12.25, "y":4},
+ {"matrix":[4, 14], "x":13.25, "y":4, "w": 1.75},
+ {"matrix":[4, 15], "x":15, "y":4},
+
+ {"matrix":[5, 0], "x":0, "y":5},
+ {"matrix":[5, 1], "x":1, "y":5},
+ {"matrix":[5, 2], "x":2, "y":5},
+ {"matrix":[5, 3], "x":3, "y":5},
+ {"matrix":[5, 6], "x":4, "y":5, "w": 5},
+ {"matrix":[5, 9], "x":9, "y":5},
+ {"matrix":[5, 10], "x":10, "y":5},
+ {"matrix":[5, 11], "x":11, "y":5},
+ {"matrix":[5, 12], "x":12, "y":5},
+ {"matrix":[5, 13], "x":13, "y":5},
+ {"matrix":[5, 14], "x":14, "y":5},
+ {"matrix":[5, 15], "x":15, "y":5}
+ ]
+ }
+ }
+
+}
diff --git a/keyboards/keychron/k3_max/iso/rgb/config.h b/keyboards/keychron/k3_max/iso/rgb/config.h
new file mode 100644
index 0000000000..f5d07abc4b
--- /dev/null
+++ b/keyboards/keychron/k3_max/iso/rgb/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 85
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 46
+# define LOW_BAT_IND_INDEX { 78 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k3_max/iso/rgb/keyboard.json b/keyboards/keychron/k3_max/iso/rgb/keyboard.json
new file mode 100644
index 0000000000..7bdd8611a5
--- /dev/null
+++ b/keyboards/keychron/k3_max/iso/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A31",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_max/iso/rgb/keymaps/default/keymap.c b/keyboards/keychron/k3_max/iso/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..03adc224b2
--- /dev/null
+++ b/keyboards/keychron/k3_max/iso/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_iso_85(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, RGB_MOD,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_iso_85(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_BASE] = LAYOUT_iso_85(
+ 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_DEL, RGB_MOD,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_FN] = LAYOUT_iso_85(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k3_max/iso/rgb/rgb.c b/keyboards/keychron/k3_max/iso/rgb/rgb.c
new file mode 100644
index 0000000000..fd7050e351
--- /dev/null
+++ b/keyboards/keychron/k3_max/iso/rgb/rgb.c
@@ -0,0 +1,148 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1},
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA14, CB7_CA14, CB8_CA14},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA2, CB1_CA2, CB2_CA2},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+
+};
+
+led_config_t g_led_config = {
+ {
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, NO_LED, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, NO_LED, 45 },
+ { 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, NO_LED, 58, NO_LED, 59 },
+ { 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, NO_LED, 72, 73, 74 },
+ { 75, 76, 77, NO_LED, NO_LED, NO_LED, 78, NO_LED, NO_LED, NO_LED, 79, 80, 81, 82, 83, 84 }
+ },
+ {
+ {0, 0}, {14, 0}, {29, 0}, {44, 0}, {59, 0}, {74, 0}, { 89, 0}, {104, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209, 0}, {223, 0},
+ {0,12}, {14,12}, {29,12}, {44,12}, {59,12}, {74,12}, { 89, 12}, {104, 12}, {119, 12}, {134, 12}, {149, 12}, {164, 12}, {179, 12}, {201, 12}, {223, 12},
+ {3,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 32}, {223, 25},
+ {5,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {190, 38}, {223, 38},
+ {1,51}, {17,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {188, 51}, {209, 51}, {223, 51},
+ {1,64}, {20,64}, {39,64}, { 95, 64}, {149, 64}, {164, 64}, {179, 64}, {194, 64}, {209, 64}, {223, 64}
+ },
+ {
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4
+
+ }
+};
+#endif
diff --git a/keyboards/keychron/k3_max/iso/rgb/rules.mk b/keyboards/keychron/k3_max/iso/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k3_max/iso/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k3_max/iso/white/config.h b/keyboards/keychron/k3_max/iso/white/config.h
new file mode 100644
index 0000000000..62acbfbe6b
--- /dev/null
+++ b/keyboards/keychron/k3_max/iso/white/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 85
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 46
+# define LOW_BAT_IND_INDEX \
+ { 78 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k3_max/iso/white/keyboard.json b/keyboards/keychron/k3_max/iso/white/keyboard.json
new file mode 100644
index 0000000000..49b7033444
--- /dev/null
+++ b/keyboards/keychron/k3_max/iso/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A34",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_max/iso/white/keymaps/default/keymap.c b/keyboards/keychron/k3_max/iso/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..144e82273f
--- /dev/null
+++ b/keyboards/keychron/k3_max/iso/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_iso_85(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, BL_STEP,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_iso_85(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_BASE] = LAYOUT_iso_85(
+ 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_DEL, BL_STEP,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_FN] = LAYOUT_iso_85(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k3_max/iso/white/rules.mk b/keyboards/keychron/k3_max/iso/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k3_max/iso/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k3_max/iso/white/white.c b/keyboards/keychron/k3_max/iso/white/white.c
new file mode 100644
index 0000000000..bb519da562
--- /dev/null
+++ b/keyboards/keychron/k3_max/iso/white/white.c
@@ -0,0 +1,148 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA4},
+ {0, CB1_CA5},
+ {0, CB1_CA6},
+ {0, CB1_CA7},
+ {0, CB1_CA8},
+ {0, CB1_CA9},
+ {0, CB1_CA10},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA13},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA14},
+ {0, CB4_CA16},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA7},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA14},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+};
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, NO_LED, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, NO_LED, 45 },
+ { 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, NO_LED, 58, NO_LED, 59 },
+ { 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, NO_LED, 72, 73, 74 },
+ { 75, 76, 77, NO_LED, NO_LED, NO_LED, 78, NO_LED, NO_LED, NO_LED, 79, 80, 81, 82, 83, 84 }
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {14, 0}, {29, 0}, {44, 0}, {59, 0}, {74, 0}, { 89, 0}, {104, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209, 0}, {223, 0},
+ {0,12}, {14,12}, {29,12}, {44,12}, {59,12}, {74,12}, { 89, 12}, {104, 12}, {119, 12}, {134, 12}, {149, 12}, {164, 12}, {179, 12}, {201, 12}, {223, 12},
+ {3,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 32}, {223, 25},
+ {5,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {190, 38}, {223, 38},
+ {1,51}, {17,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {188, 51}, {209, 51}, {223, 51},
+ {1,64}, {20,64}, {39,64}, { 95, 64}, {149, 64}, {164, 64}, {179, 64}, {194, 64}, {209, 64}, {223, 64}
+ },
+ {
+ // RGB LED Index to Flag
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/k3_max/jis/rgb/config.h b/keyboards/keychron/k3_max/jis/rgb/config.h
new file mode 100644
index 0000000000..80c6455d56
--- /dev/null
+++ b/keyboards/keychron/k3_max/jis/rgb/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 87
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x11, 0x11, 0x11, 0x11, 0x11, 0x11, 0x11, 0x11, 0x11, 0x11, 0x11, 0x11 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 47
+# define LOW_BAT_IND_INDEX { 79 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k3_max/jis/rgb/keyboard.json b/keyboards/keychron/k3_max/jis/rgb/keyboard.json
new file mode 100644
index 0000000000..21c26d9084
--- /dev/null
+++ b/keyboards/keychron/k3_max/jis/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A32",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_max/jis/rgb/keymaps/default/keymap.c b/keyboards/keychron/k3_max/jis/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..bf8c7ed941
--- /dev/null
+++ b/keyboards/keychron/k3_max/jis/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_jis_87(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, RGB_MOD,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_END,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD,MO(MAC_FN),KC_LEFT, KC_UP, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_jis_87(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_BASE] = LAYOUT_jis_87(
+ 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_DEL, RGB_MOD,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_END,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, MO(WIN_FN),KC_LEFT, KC_UP, KC_DOWN, KC_RGHT),
+
+[WIN_FN] = LAYOUT_jis_87(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k3_max/jis/rgb/rgb.c b/keyboards/keychron/k3_max/jis/rgb/rgb.c
new file mode 100644
index 0000000000..ad2fbeb3c3
--- /dev/null
+++ b/keyboards/keychron/k3_max/jis/rgb/rgb.c
@@ -0,0 +1,154 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1},
+ {0, CB9_CA2, CB7_CA2, CB8_CA2},
+ {0, CB9_CA3, CB7_CA3, CB8_CA3},
+ {0, CB9_CA4, CB7_CA4, CB8_CA4},
+ {0, CB9_CA5, CB7_CA5, CB8_CA5},
+ {0, CB9_CA6, CB7_CA6, CB8_CA6},
+ {0, CB9_CA7, CB7_CA7, CB8_CA7},
+ {0, CB9_CA8, CB7_CA8, CB8_CA8},
+ {0, CB9_CA9, CB7_CA9, CB8_CA9},
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA14, CB7_CA14, CB8_CA14},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA15, CB4_CA15, CB5_CA15},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA4, CB4_CA4, CB5_CA4},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA10, CB4_CA10, CB5_CA10},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31 },
+ { 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, __, 46 },
+ { 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, __, 59, __, 60 },
+ { 61, __, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, __, 72, 73, 74 },
+ { 75, 76, 77, 78, __, __, 79, __, __, 80, 81, 82, 83, 84, 85, 86 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {30, 0}, {45, 0}, {60, 0}, {75, 0}, { 90, 0}, {105, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209, 0}, {224, 0},
+ {0,13}, {15,13}, {30,13}, {45,13}, {60,13}, {75,13}, { 90,13}, {105,13}, {119,13}, {134,13}, {149,13}, {164,13}, {179,13}, {194,13}, {209,13}, {224,13},
+ {4,26}, {22,26}, {37,26}, {52,26}, {67,26}, {82,26}, { 97,26}, {112,26}, {127,26}, {142,26}, {157,26}, {172,26}, {187,26}, {207,32}, {224,26},
+ {6,38}, {26,38}, {41,38}, {56,38}, {71,38}, {86,38}, {101,38}, {116,38}, {131,38}, {146,38}, {161,38}, {175,38}, {190,38}, {224,38},
+ {9,51}, {34,51}, {49,51}, {64,51}, {78,51}, { 93,51}, {108,51}, {123,51}, {138,51}, {153,51}, {168,51}, {183,51}, {203,51}, {224,51},
+ {0,64}, {15,64}, {30,64}, {45,64}, { 90,64}, {134,64}, {149,64}, {164,64}, {179,64}, {194,64}, {209,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k3_max/jis/rgb/rules.mk b/keyboards/keychron/k3_max/jis/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k3_max/jis/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k3_max/jis/white/config.h b/keyboards/keychron/k3_max/jis/white/config.h
new file mode 100644
index 0000000000..1ac4bec95e
--- /dev/null
+++ b/keyboards/keychron/k3_max/jis/white/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 87
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 47
+# define LOW_BAT_IND_INDEX \
+ { 79 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k3_max/jis/white/keyboard.json b/keyboards/keychron/k3_max/jis/white/keyboard.json
new file mode 100644
index 0000000000..f8413de8c0
--- /dev/null
+++ b/keyboards/keychron/k3_max/jis/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A35",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_max/jis/white/keymaps/default/keymap.c b/keyboards/keychron/k3_max/jis/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..9ae6700081
--- /dev/null
+++ b/keyboards/keychron/k3_max/jis/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_jis_87(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, BL_STEP,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_END,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD,MO(MAC_FN),KC_LEFT, KC_UP, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_jis_87(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_BASE] = LAYOUT_jis_87(
+ 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_DEL, BL_STEP,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_END,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, MO(WIN_FN),KC_LEFT, KC_UP, KC_DOWN, KC_RGHT),
+
+[WIN_FN] = LAYOUT_jis_87(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k3_max/jis/white/rules.mk b/keyboards/keychron/k3_max/jis/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k3_max/jis/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k3_max/jis/white/white.c b/keyboards/keychron/k3_max/jis/white/white.c
new file mode 100644
index 0000000000..d314bb809c
--- /dev/null
+++ b/keyboards/keychron/k3_max/jis/white/white.c
@@ -0,0 +1,151 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA4},
+ {0, CB1_CA5},
+ {0, CB1_CA6},
+ {0, CB1_CA7},
+ {0, CB1_CA8},
+ {0, CB1_CA9},
+ {0, CB1_CA10},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA14},
+ {0, CB2_CA15},
+ {0, CB2_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA13},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA14},
+ {0, CB4_CA16},
+
+ {0, CB5_CA1},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA7},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA14},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31 },
+ { 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, __, 46 },
+ { 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, __, 59, __, 60 },
+ { 61, __, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, __, 72, 73, 74 },
+ { 75, 76, 77, 78, __, __, 79, __, __, 80, 81, 82, 83, 84, 85, 86 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {30, 0}, {45, 0}, {60, 0}, {75, 0}, { 90, 0}, {105, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209, 0}, {224, 0},
+ {0,13}, {15,13}, {30,13}, {45,13}, {60,13}, {75,13}, { 90,13}, {105,13}, {119,13}, {134,13}, {149,13}, {164,13}, {179,13}, {194,13}, {209,13}, {224,13},
+ {4,26}, {22,26}, {37,26}, {52,26}, {67,26}, {82,26}, { 97,26}, {112,26}, {127,26}, {142,26}, {157,26}, {172,26}, {187,26}, {207,32}, {224,26},
+ {6,38}, {26,38}, {41,38}, {56,38}, {71,38}, {86,38}, {101,38}, {116,38}, {131,38}, {146,38}, {161,38}, {175,38}, {190,38}, {224,38},
+ {9,51}, {34,51}, {49,51}, {64,51}, {78,51}, { 93,51}, {108,51}, {123,51}, {138,51}, {153,51}, {168,51}, {183,51}, {203,51}, {224,51},
+ {0,64}, {15,64}, {30,64}, {45,64}, { 90,64}, {134,64}, {149,64}, {164,64}, {179,64}, {194,64}, {209,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k3_max/k3_max.c b/keyboards/keychron/k3_max/k3_max.c
new file mode 100644
index 0000000000..c871fef54e
--- /dev/null
+++ b/keyboards/keychron/k3_max/k3_max.c
@@ -0,0 +1,83 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "transport.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 2));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+
+ } else {
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/k3_max/mcuconf.h b/keyboards/keychron/k3_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/k3_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/k3_max/readme.md b/keyboards/keychron/k3_max/readme.md
new file mode 100644
index 0000000000..136dff5a91
--- /dev/null
+++ b/keyboards/keychron/k3_max/readme.md
@@ -0,0 +1,23 @@
+# Keychron K3 Max
+
+
+
+A customizable 84 keys TKL keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron K3 Max
+* Hardware Availability: [Keychron K3 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-k3-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/k3_max/ansi/rgb:default
+ make keychron/k3_max/ansi/white:default
+
+Flashing example for this keyboard:
+
+ make keychron/k3_max/ansi/rgb:default:flash
+ make keychron/k3_max/ansi/white:default:flash
+
+**Reset Key**: Disconnect the USB cable, toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar, then connect the USB cable.
+
+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).
diff --git a/keyboards/keychron/k3_max/rules.mk b/keyboards/keychron/k3_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/k3_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/k3_max/via_json/k3_max_ansi_rgb.json b/keyboards/keychron/k3_max/via_json/k3_max_ansi_rgb.json
new file mode 100644
index 0000000000..07e18987dd
--- /dev/null
+++ b/keyboards/keychron/k3_max/via_json/k3_max_ansi_rgb.json
@@ -0,0 +1,273 @@
+{
+ "name": "Keychron K3 Max ANSI RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A30",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "c": "#cccccc"
+ },
+ "4, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "c": "#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k3_max/via_json/k3_max_ansi_white.json b/keyboards/keychron/k3_max/via_json/k3_max_ansi_white.json
new file mode 100644
index 0000000000..b249eaded6
--- /dev/null
+++ b/keyboards/keychron/k3_max/via_json/k3_max_ansi_white.json
@@ -0,0 +1,212 @@
+{
+ "name": "Keychron K3 Max ANSI White",
+ "vendorId": "0x3434",
+ "productId": "0x0A33",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "c": "#cccccc"
+ },
+ "4, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "c": "#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k3_max/via_json/k3_max_iso_rgb.json b/keyboards/keychron/k3_max/via_json/k3_max_iso_rgb.json
new file mode 100644
index 0000000000..6e1158c6a4
--- /dev/null
+++ b/keyboards/keychron/k3_max/via_json/k3_max_iso_rgb.json
@@ -0,0 +1,279 @@
+{
+ "name": "Keychron K3 Max ISO RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A31",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 1",
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "c": "#cccccc"
+ },
+ "4, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "c": "#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k3_max/via_json/k3_max_iso_white.json b/keyboards/keychron/k3_max/via_json/k3_max_iso_white.json
new file mode 100644
index 0000000000..5bdfbb24b7
--- /dev/null
+++ b/keyboards/keychron/k3_max/via_json/k3_max_iso_white.json
@@ -0,0 +1,218 @@
+{
+ "name": "Keychron K3 Max ISO White",
+ "vendorId": "0x3434",
+ "productId": "0x0A34",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 1",
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "c": "#cccccc"
+ },
+ "4, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "c": "#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k3_max/via_json/k3_max_jis_rgb.json b/keyboards/keychron/k3_max/via_json/k3_max_jis_rgb.json
new file mode 100644
index 0000000000..8598a7447f
--- /dev/null
+++ b/keyboards/keychron/k3_max/via_json/k3_max_jis_rgb.json
@@ -0,0 +1,267 @@
+{
+ "name": "Keychron K3 Max JIS RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A32",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ "1, 13",
+ "1, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ "4, 13",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 14",
+ "4, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ "5, 1",
+ "5, 2",
+ "5, 3",
+ {
+ "w": 5,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 9",
+ "5, 10",
+ "5, 11",
+ {
+ "c": "#cccccc"
+ },
+ "5, 12",
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k3_max/via_json/k3_max_jis_white.json b/keyboards/keychron/k3_max/via_json/k3_max_jis_white.json
new file mode 100644
index 0000000000..895fd7d187
--- /dev/null
+++ b/keyboards/keychron/k3_max/via_json/k3_max_jis_white.json
@@ -0,0 +1,205 @@
+{
+ "name": "Keychron K3 Max JIS White",
+ "vendorId": "0x3434",
+ "productId": "0x0A35",
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ "1, 13",
+ "1, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ "4, 13",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 14",
+ "4, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ "5, 1",
+ "5, 2",
+ "5, 3",
+ {
+ "w": 5,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 9",
+ "5, 10",
+ "5, 11",
+ {
+ "c": "#cccccc"
+ },
+ "5, 12",
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k3_version_3/ansi/info.json b/keyboards/keychron/k3_version_3/ansi/info.json
new file mode 100644
index 0000000000..f00707f592
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/ansi/info.json
@@ -0,0 +1,6 @@
+{
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ }
+}
diff --git a/keyboards/keychron/k3_version_3/ansi/rgb/config.h b/keyboards/keychron/k3_version_3/ansi/rgb/config.h
new file mode 100644
index 0000000000..046b5eeb66
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/ansi/rgb/config.h
@@ -0,0 +1,48 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#define MCU_UNUSED_PINS \
+ { A13, B2 }
+#define MCU_UNSED_PINS_STATE \
+ { PAL_MODE_INPUT_PULLDOWN, PAL_MODE_INPUT_PULLDOWN }
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 84
+# define DRIVER_CS_PINS \
+ { A8, C9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+/* Indications */
+# define CAPS_LOCK_INDEX 46
+# define LOW_BAT_IND_INDEX \
+ { 77 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+#endif
diff --git a/keyboards/keychron/k3_version_3/ansi/rgb/keyboard.json b/keyboards/keychron/k3_version_3/ansi/rgb/keyboard.json
new file mode 100644
index 0000000000..1867db5a20
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/ansi/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0D30",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_version_3/ansi/rgb/keymaps/default/keymap.c b/keyboards/keychron/k3_version_3/ansi/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..4886c2b875
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/ansi/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_84(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, RGB_MOD,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_84(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_84(
+ 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_DEL, RGB_MOD,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_84(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k3_version_3/ansi/rgb/rgb.c b/keyboards/keychron/k3_version_3/ansi/rgb/rgb.c
new file mode 100644
index 0000000000..e01fb75134
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/ansi/rgb/rgb.c
@@ -0,0 +1,150 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t PROGMEM g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1 },
+ {0, CB9_CA2, CB7_CA2, CB8_CA2 },
+ {0, CB9_CA3, CB7_CA3, CB8_CA3 },
+ {0, CB9_CA4, CB7_CA4, CB8_CA4 },
+ {0, CB9_CA5, CB7_CA5, CB8_CA5 },
+ {0, CB9_CA6, CB7_CA6, CB8_CA6 },
+ {0, CB9_CA7, CB7_CA7, CB8_CA7 },
+ {0, CB9_CA8, CB7_CA8, CB8_CA8 },
+ {0, CB9_CA9, CB7_CA9, CB8_CA9 },
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA14, CB7_CA14, CB8_CA14},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, __, 45 },
+ { 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __, 58, __, 59 },
+ { 60, __, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, __, 71, 72, 73 },
+ { 74, 75, 76, __, __, __, 77, __, __, __, 78, 79, 80, 81, 82, 83 },
+ },
+ {
+ // LED Index to Physical Position
+ {3, 0}, {14, 0}, {33, 0}, {48, 0}, {63, 0}, {78, 0}, { 93, 0}, {108, 0}, {123, 0}, {138, 0}, {153, 0}, {168, 0}, {183, 0}, {198, 0}, {213,0}, {223, 0},
+ {3,12}, {14,12}, {33,12}, {48,12}, {63,12}, {78,12}, { 93, 12}, {108, 12}, {123, 12}, {138, 12}, {153, 12}, {168, 12}, {183, 12}, {205, 12}, {223, 12},
+ {7,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 31}, {223, 25},
+ {8,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {187, 38}, {223, 38},
+ {9,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {183, 51}, {213, 51},{223, 51},
+ {1,64}, {20,64}, {39,64}, { 95, 64}, {149, 64}, {164, 64}, {183, 64}, {198, 64}, {213, 64},{223, 64}
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k3_version_3/ansi/rgb/rules.mk b/keyboards/keychron/k3_version_3/ansi/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/ansi/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k3_version_3/ansi/white/config.h b/keyboards/keychron/k3_version_3/ansi/white/config.h
new file mode 100644
index 0000000000..13836560fd
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/ansi/white/config.h
@@ -0,0 +1,50 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#define MCU_UNUSED_PINS \
+ { B2 }
+#define MCU_UNSED_PINS_STATE \
+ { PAL_MODE_INPUT_PULLDOWN }
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 84
+# define DRIVER_CS_PINS \
+ { C9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 46
+# define LOW_BAT_IND_INDEX \
+ { 77 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k3_version_3/ansi/white/keyboard.json b/keyboards/keychron/k3_version_3/ansi/white/keyboard.json
new file mode 100644
index 0000000000..d8e11dfd9f
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/ansi/white/keyboard.json
@@ -0,0 +1,34 @@
+{
+ "usb": {
+ "pid": "0x0D33",
+ "device_version": "1.0.1"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "indicators": {
+ "caps_lock": "A13",
+ "on_state": 1
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_version_3/ansi/white/keymaps/default/keymap.c b/keyboards/keychron/k3_version_3/ansi/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..2678995fe7
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/ansi/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_84(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, BL_STEP,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_84(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_84(
+ 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_DEL, BL_STEP,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_END,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_84(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k3_version_3/ansi/white/rules.mk b/keyboards/keychron/k3_version_3/ansi/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/ansi/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k3_version_3/ansi/white/white.c b/keyboards/keychron/k3_version_3/ansi/white/white.c
new file mode 100644
index 0000000000..ec1ddb0e0a
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/ansi/white/white.c
@@ -0,0 +1,148 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA4},
+ {0, CB1_CA5},
+ {0, CB1_CA6},
+ {0, CB1_CA7},
+ {0, CB1_CA8},
+ {0, CB1_CA9},
+ {0, CB1_CA10},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA13},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA14},
+ {0, CB4_CA16},
+
+ {0, CB5_CA1},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA7},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA14},
+ {0, CB6_CA15},
+ {0, CB6_CA16}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, __, 45 },
+ { 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __, 58, __, 59 },
+ { 60, __, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, __, 71, 72, 73 },
+ { 74, 75, 76, __, __, __, 77, __, __, __, 78, 79, 80, 81, 82, 83 }
+ },
+ {
+ // LED Index to Physical Position
+ {3, 0}, {14, 0}, {33, 0}, {48, 0}, {63, 0}, {78, 0}, { 93, 0}, {108, 0}, {123, 0}, {138, 0}, {153, 0}, {168, 0}, {183, 0}, {198, 0}, {213,0}, {223, 0},
+ {3,12}, {14,12}, {33,12}, {48,12}, {63,12}, {78,12}, { 93, 12}, {108, 12}, {123, 12}, {138, 12}, {153, 12}, {168, 12}, {183, 12}, {205, 12}, {223, 12},
+ {7,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 25}, {223, 25},
+ {8,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {183, 38}, {205, 38}, {223, 38},
+ {9,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {190, 51}, {213, 51},{223, 51},
+ {1,64}, {20,64}, {39,64}, { 95, 64}, {149, 64}, {164, 64}, {183, 64}, {198, 64}, {213, 64},{223, 64}
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k3_version_3/config.h b/keyboards/keychron/k3_version_3/config.h
new file mode 100644
index 0000000000..6b81293757
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/config.h
@@ -0,0 +1,88 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* I2C Driver Configuration */
+#define I2C1_SCL_PIN B8
+#define I2C1_SDA_PIN B9
+#define I2C1_CLOCK_SPEED 400000
+#define I2C1_DUTY_CYCLE FAST_DUTY_CYCLE_2
+
+/* EEPROM Driver Configuration */
+#define EXTERNAL_EEPROM_BYTE_COUNT 2048
+#define EXTERNAL_EEPROM_PAGE_SIZE 32
+#define EXTERNAL_EEPROM_WRITE_TIME 3
+
+#define I2C1_OPMODE OPMODE_I2C
+#define EXTERNAL_EEPROM_I2C_BASE_ADDRESS 0b10100010
+#define DYNAMIC_KEYMAP_BUFFER_ENABLE
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPIDQ
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+
+# ifdef LK_WIRELESS_ENABLE
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define BT_MODE_SELECT_PIN A10
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define DP_PULLUP_CONTROL_PIN B15
+
+# define BT_HOST_DEVICES_COUNT 3
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define MATRIX_IO_DELAY 30
\ No newline at end of file
diff --git a/keyboards/keychron/k3_version_3/halconf.h b/keyboards/keychron/k3_version_3/halconf.h
new file mode 100644
index 0000000000..53c73dd43d
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/halconf.h
@@ -0,0 +1,32 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#define HAL_USE_I2C TRUE
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/k3_version_3/info.json b/keyboards/keychron/k3_version_3/info.json
new file mode 100644
index 0000000000..5097347319
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/info.json
@@ -0,0 +1,315 @@
+{
+ "keyboard_name": "Keychron K3 Version 3",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "Joe",
+ "processor": "WB32F3G71",
+ "bootloader": "wb32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey": true,
+ "mousekey": true,
+ "dip_switch": true,
+ "nkro": true,
+ "raw": true,
+ "sendstring": true
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch" :{
+ "pins": ["B14"]
+ },
+ "dynamic_keymap": {
+ "layer_count": 4
+ },
+ "eeprom": {
+ "driver": "i2c"
+ },
+ "layouts": {
+ "LAYOUT_ansi_84": {
+ "layout": [
+ {"matrix":[0, 0], "x":0, "y":0},
+ {"matrix":[0, 1], "x":1, "y":0},
+ {"matrix":[0, 2], "x":2, "y":0},
+ {"matrix":[0, 3], "x":3, "y":0},
+ {"matrix":[0, 4], "x":4, "y":0},
+ {"matrix":[0, 5], "x":5, "y":0},
+ {"matrix":[0, 6], "x":6, "y":0},
+ {"matrix":[0, 7], "x":7, "y":0},
+ {"matrix":[0, 8], "x":8, "y":0},
+ {"matrix":[0, 9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14, "y":0},
+ {"matrix":[0,15], "x":15, "y":0},
+
+ {"matrix":[1, 0], "x":0, "y":1},
+ {"matrix":[1, 1], "x":1, "y":1},
+ {"matrix":[1, 2], "x":2, "y":1},
+ {"matrix":[1, 3], "x":3, "y":1},
+ {"matrix":[1, 4], "x":4, "y":1},
+ {"matrix":[1, 5], "x":5, "y":1},
+ {"matrix":[1, 6], "x":6, "y":1},
+ {"matrix":[1, 7], "x":7, "y":1},
+ {"matrix":[1, 8], "x":8, "y":1},
+ {"matrix":[1, 9], "x":9, "y":1},
+ {"matrix":[1,10], "x":10, "y":1},
+ {"matrix":[1,11], "x":11, "y":1},
+ {"matrix":[1,12], "x":12, "y":1},
+ {"matrix":[1,13], "x":13, "y":1, "w":2},
+ {"matrix":[1,15], "x":15, "y":1},
+
+ {"matrix":[2, 0], "x":0, "y":2, "w":1.5},
+ {"matrix":[2, 1], "x":1.5, "y":2},
+ {"matrix":[2, 2], "x":2.5, "y":2},
+ {"matrix":[2, 3], "x":3.5, "y":2},
+ {"matrix":[2, 4], "x":4.5, "y":2},
+ {"matrix":[2, 5], "x":5.5, "y":2},
+ {"matrix":[2, 6], "x":6.5, "y":2},
+ {"matrix":[2, 7], "x":7.5, "y":2},
+ {"matrix":[2, 8], "x":8.5, "y":2},
+ {"matrix":[2, 9], "x":9.5, "y":2},
+ {"matrix":[2,10], "x":10.5, "y":2},
+ {"matrix":[2,11], "x":11.5, "y":2},
+ {"matrix":[2,12], "x":12.5, "y":2},
+ {"matrix":[2,13], "x":13.5, "y":2, "w":1.5},
+ {"matrix":[2,15], "x":15, "y":2},
+
+ {"matrix":[3, 0], "x":0, "y":3, "w":1.75},
+ {"matrix":[3, 1], "x":1.75, "y":3},
+ {"matrix":[3, 2], "x":2.75, "y":3},
+ {"matrix":[3, 3], "x":3.75, "y":3},
+ {"matrix":[3, 4], "x":4.75, "y":3},
+ {"matrix":[3, 5], "x":5.75, "y":3},
+ {"matrix":[3, 6], "x":6.75, "y":3},
+ {"matrix":[3, 7], "x":7.75, "y":3},
+ {"matrix":[3, 8], "x":8.75, "y":3},
+ {"matrix":[3, 9], "x":9.75, "y":3},
+ {"matrix":[3,10], "x":10.75, "y":3},
+ {"matrix":[3,11], "x":11.75, "y":3},
+ {"matrix":[3,13], "x":12.75, "y":3, "w":2.25},
+ {"matrix":[3,15], "x":15, "y":3},
+
+ {"matrix":[4, 0], "x":0, "y":4, "w":2.25},
+ {"matrix":[4, 2], "x":2.25, "y":4},
+ {"matrix":[4, 3], "x":3.25, "y":4},
+ {"matrix":[4, 4], "x":4.25, "y":4},
+ {"matrix":[4, 5], "x":5.25, "y":4},
+ {"matrix":[4, 6], "x":6.25, "y":4},
+ {"matrix":[4, 7], "x":7.25, "y":4},
+ {"matrix":[4, 8], "x":8.25, "y":4},
+ {"matrix":[4, 9], "x":9.25, "y":4},
+ {"matrix":[4,10], "x":10.25, "y":4},
+ {"matrix":[4,11], "x":11.25, "y":4},
+ {"matrix":[4,13], "x":12.25, "y":4, "w":1.75},
+ {"matrix":[4,14], "x":14, "y":4},
+ {"matrix":[4,15], "x":15, "y":4},
+
+ {"matrix":[5, 0], "x":0, "y":5, "w":1.25},
+ {"matrix":[5, 1], "x":1.25, "y":5, "w":1.25},
+ {"matrix":[5, 2], "x":2.5, "y":5, "w":1.25},
+ {"matrix":[5, 6], "x":3.75, "y":5, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5},
+ {"matrix":[5,11], "x":11, "y":5},
+ {"matrix":[5,12], "x":12, "y":5},
+ {"matrix":[5,13], "x":13, "y":5},
+ {"matrix":[5,14], "x":14, "y":5},
+ {"matrix":[5,15], "x":15, "y":5}
+ ]
+ },
+ "LAYOUT_iso_85": {
+ "layout": [
+ {"matrix":[0, 0], "x":0, "y":0},
+ {"matrix":[0, 1], "x":1, "y":0},
+ {"matrix":[0, 2], "x":2, "y":0},
+ {"matrix":[0, 3], "x":3, "y":0},
+ {"matrix":[0, 4], "x":4, "y":0},
+ {"matrix":[0, 5], "x":5, "y":0},
+ {"matrix":[0, 6], "x":6, "y":0},
+ {"matrix":[0, 7], "x":7, "y":0},
+ {"matrix":[0, 8], "x":8, "y":0},
+ {"matrix":[0, 9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14, "y":0},
+ {"matrix":[0,15], "x":15, "y":0},
+
+ {"matrix":[1, 0], "x":0, "y":1},
+ {"matrix":[1, 1], "x":1, "y":1},
+ {"matrix":[1, 2], "x":2, "y":1},
+ {"matrix":[1, 3], "x":3, "y":1},
+ {"matrix":[1, 4], "x":4, "y":1},
+ {"matrix":[1, 5], "x":5, "y":1},
+ {"matrix":[1, 6], "x":6, "y":1},
+ {"matrix":[1, 7], "x":7, "y":1},
+ {"matrix":[1, 8], "x":8, "y":1},
+ {"matrix":[1, 9], "x":9, "y":1},
+ {"matrix":[1,10], "x":10, "y":1},
+ {"matrix":[1,11], "x":11, "y":1},
+ {"matrix":[1,12], "x":12, "y":1},
+ {"matrix":[1,13], "x":13, "y":1, "w":2},
+ {"matrix":[1,15], "x":15, "y":1},
+
+ {"matrix":[2, 0], "x":0, "y":2, "w":1.5},
+ {"matrix":[2, 1], "x":1.5, "y":2},
+ {"matrix":[2, 2], "x":2.5, "y":2},
+ {"matrix":[2, 3], "x":3.5, "y":2},
+ {"matrix":[2, 4], "x":4.5, "y":2},
+ {"matrix":[2, 5], "x":5.5, "y":2},
+ {"matrix":[2, 6], "x":6.5, "y":2},
+ {"matrix":[2, 7], "x":7.5, "y":2},
+ {"matrix":[2, 8], "x":8.5, "y":2},
+ {"matrix":[2, 9], "x":9.5, "y":2},
+ {"matrix":[2,10], "x":10.5, "y":2},
+ {"matrix":[2,11], "x":11.5, "y":2},
+ {"matrix":[2,12], "x":12.5, "y":2},
+ {"matrix":[2,15], "x":15, "y":2},
+
+ {"matrix":[3, 0], "x":0, "y":3, "w":1.75},
+ {"matrix":[3, 1], "x":1.75, "y":3},
+ {"matrix":[3, 2], "x":2.75, "y":3},
+ {"matrix":[3, 3], "x":3.75, "y":3},
+ {"matrix":[3, 4], "x":4.75, "y":3},
+ {"matrix":[3, 5], "x":5.75, "y":3},
+ {"matrix":[3, 6], "x":6.75, "y":3},
+ {"matrix":[3, 7], "x":7.75, "y":3},
+ {"matrix":[3, 8], "x":8.75, "y":3},
+ {"matrix":[3, 9], "x":9.75, "y":3},
+ {"matrix":[3,10], "x":10.75, "y":3},
+ {"matrix":[3,11], "x":11.75, "y":3},
+ {"matrix":[3,13], "x":12.75, "y":3},
+ {"matrix":[2,13], "x":13.75, "y":2, "w": 1.25, "h": 2},
+ {"matrix":[3,15], "x":15, "y":3},
+
+ {"matrix":[4, 0], "x":0, "y":4, "w":1.25},
+ {"matrix":[4, 1], "x":1.25, "y":4},
+ {"matrix":[4, 2], "x":2.25, "y":4},
+ {"matrix":[4, 3], "x":3.25, "y":4},
+ {"matrix":[4, 4], "x":4.25, "y":4},
+ {"matrix":[4, 5], "x":5.25, "y":4},
+ {"matrix":[4, 6], "x":6.25, "y":4},
+ {"matrix":[4, 7], "x":7.25, "y":4},
+ {"matrix":[4, 8], "x":8.25, "y":4},
+ {"matrix":[4, 9], "x":9.25, "y":4},
+ {"matrix":[4,10], "x":10.25, "y":4},
+ {"matrix":[4,11], "x":11.25, "y":4},
+ {"matrix":[4,13], "x":12.25, "y":4, "w":1.75},
+ {"matrix":[4,14], "x":14, "y":4},
+ {"matrix":[4,15], "x":15, "y":4},
+
+ {"matrix":[5, 0], "x":0, "y":5, "w":1.25},
+ {"matrix":[5, 1], "x":1.25, "y":5, "w":1.25},
+ {"matrix":[5, 2], "x":2.5, "y":5, "w":1.25},
+ {"matrix":[5, 6], "x":3.75, "y":5, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5},
+ {"matrix":[5,11], "x":11, "y":5},
+ {"matrix":[5,12], "x":12, "y":5},
+ {"matrix":[5,13], "x":13, "y":5},
+ {"matrix":[5,14], "x":14, "y":5},
+ {"matrix":[5,15], "x":15, "y":5}
+ ]
+ },
+ "LAYOUT_jis_87": {
+ "layout": [
+ {"matrix":[0, 0], "x":0, "y":0},
+ {"matrix":[0, 1], "x":1, "y":0},
+ {"matrix":[0, 2], "x":2, "y":0},
+ {"matrix":[0, 3], "x":3, "y":0},
+ {"matrix":[0, 4], "x":4, "y":0},
+ {"matrix":[0, 5], "x":5, "y":0},
+ {"matrix":[0, 6], "x":6, "y":0},
+ {"matrix":[0, 7], "x":7, "y":0},
+ {"matrix":[0, 8], "x":8, "y":0},
+ {"matrix":[0, 9], "x":9, "y":0},
+ {"matrix":[0,10], "x":10, "y":0},
+ {"matrix":[0,11], "x":11, "y":0},
+ {"matrix":[0,12], "x":12, "y":0},
+ {"matrix":[0,13], "x":13, "y":0},
+ {"matrix":[0,14], "x":14, "y":0},
+ {"matrix":[0,15], "x":15, "y":0},
+
+ {"matrix":[1, 0], "x":0, "y":1},
+ {"matrix":[1, 1], "x":1, "y":1},
+ {"matrix":[1, 2], "x":2, "y":1},
+ {"matrix":[1, 3], "x":3, "y":1},
+ {"matrix":[1, 4], "x":4, "y":1},
+ {"matrix":[1, 5], "x":5, "y":1},
+ {"matrix":[1, 6], "x":6, "y":1},
+ {"matrix":[1, 7], "x":7, "y":1},
+ {"matrix":[1, 8], "x":8, "y":1},
+ {"matrix":[1, 9], "x":9, "y":1},
+ {"matrix":[1,10], "x":10, "y":1},
+ {"matrix":[1,11], "x":11, "y":1},
+ {"matrix":[1,12], "x":12, "y":1},
+ {"matrix":[1,13], "x":13, "y":1},
+ {"matrix":[1,14], "x":14, "y":1},
+ {"matrix":[1,15], "x":15, "y":1},
+
+ {"matrix":[2, 0], "x":0, "y":2, "w":1.5},
+ {"matrix":[2, 1], "x":1.5, "y":2},
+ {"matrix":[2, 2], "x":2.5, "y":2},
+ {"matrix":[2, 3], "x":3.5, "y":2},
+ {"matrix":[2, 4], "x":4.5, "y":2},
+ {"matrix":[2, 5], "x":5.5, "y":2},
+ {"matrix":[2, 6], "x":6.5, "y":2},
+ {"matrix":[2, 7], "x":7.5, "y":2},
+ {"matrix":[2, 8], "x":8.5, "y":2},
+ {"matrix":[2, 9], "x":9.5, "y":2},
+ {"matrix":[2,10], "x":10.5, "y":2},
+ {"matrix":[2,11], "x":11.5, "y":2},
+ {"matrix":[2,12], "x":12.5, "y":2},
+ {"matrix":[2,15], "x":15, "y":2},
+
+ {"matrix":[3, 0], "x":0, "y":3, "w":1.75},
+ {"matrix":[3, 1], "x":1.75, "y":3},
+ {"matrix":[3, 2], "x":2.75, "y":3},
+ {"matrix":[3, 3], "x":3.75, "y":3},
+ {"matrix":[3, 4], "x":4.75, "y":3},
+ {"matrix":[3, 5], "x":5.75, "y":3},
+ {"matrix":[3, 6], "x":6.75, "y":3},
+ {"matrix":[3, 7], "x":7.75, "y":3},
+ {"matrix":[3, 8], "x":8.75, "y":3},
+ {"matrix":[3, 9], "x":9.75, "y":3},
+ {"matrix":[3,10], "x":10.75, "y":3},
+ {"matrix":[3,11], "x":11.75, "y":3},
+ {"matrix":[3,13], "x":12.75, "y":3},
+ {"matrix":[2,13], "x":13.75, "y":2, "w": 1.25, "h": 2},
+ {"matrix":[3,15], "x":15, "y":3},
+
+ {"matrix":[4, 0], "x":0, "y":4, "w":2.25},
+ {"matrix":[4, 2], "x":2.25, "y":4},
+ {"matrix":[4, 3], "x":3.25, "y":4},
+ {"matrix":[4, 4], "x":4.25, "y":4},
+ {"matrix":[4, 5], "x":5.25, "y":4},
+ {"matrix":[4, 6], "x":6.25, "y":4},
+ {"matrix":[4, 7], "x":7.25, "y":4},
+ {"matrix":[4, 8], "x":8.25, "y":4},
+ {"matrix":[4, 9], "x":9.25, "y":4},
+ {"matrix":[4,10], "x":10.25, "y":4},
+ {"matrix":[4,11], "x":11.25, "y":4},
+ {"matrix":[4,13], "x":12.25, "y":4},
+ {"matrix":[4,14], "x":13.25, "y":4, "w":1.75},
+ {"matrix":[4,15], "x":15, "y":4},
+
+ {"matrix":[5, 0], "x":0, "y":5},
+ {"matrix":[5, 1], "x":1, "y":5},
+ {"matrix":[5, 2], "x":2, "y":5},
+ {"matrix":[5, 3], "x":3, "y":5},
+ {"matrix":[5, 6], "x":4, "y":5, "w":5},
+ {"matrix":[5, 9], "x":9, "y":5},
+ {"matrix":[5,10], "x":10, "y":5},
+ {"matrix":[5,11], "x":11, "y":5},
+ {"matrix":[5,12], "x":12, "y":5},
+ {"matrix":[5,13], "x":13, "y":5},
+ {"matrix":[5,14], "x":14, "y":5},
+ {"matrix":[5,15], "x":15, "y":5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_version_3/iso/info.json b/keyboards/keychron/k3_version_3/iso/info.json
new file mode 100644
index 0000000000..c29a567973
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/iso/info.json
@@ -0,0 +1,6 @@
+{
+ "matrix_pins": {
+ "cols": ["C6", "C7", "A13", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ }
+}
diff --git a/keyboards/keychron/k3_version_3/iso/rgb/config.h b/keyboards/keychron/k3_version_3/iso/rgb/config.h
new file mode 100644
index 0000000000..fe62865700
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/iso/rgb/config.h
@@ -0,0 +1,48 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#define MCU_UNUSED_PINS \
+ { C8, B2 }
+#define MCU_UNSED_PINS_STATE \
+ { PAL_MODE_INPUT_PULLDOWN, PAL_MODE_INPUT_PULLDOWN }
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 85
+# define DRIVER_CS_PINS \
+ { A8, C9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+/* Indications */
+# define CAPS_LOCK_INDEX 46
+# define LOW_BAT_IND_INDEX \
+ { 78 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+#endif
diff --git a/keyboards/keychron/k3_version_3/iso/rgb/keyboard.json b/keyboards/keychron/k3_version_3/iso/rgb/keyboard.json
new file mode 100644
index 0000000000..629e143660
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/iso/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0D31",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_version_3/iso/rgb/keymaps/default/keymap.c b/keyboards/keychron/k3_version_3/iso/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..e9c3a0eaf7
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/iso/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+*/
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_85(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, RGB_MOD,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_85(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_85(
+ 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_DEL, RGB_MOD,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_85(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k3_version_3/iso/rgb/rgb.c b/keyboards/keychron/k3_version_3/iso/rgb/rgb.c
new file mode 100644
index 0000000000..f8884522fc
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/iso/rgb/rgb.c
@@ -0,0 +1,152 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t PROGMEM g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1 },
+ {0, CB9_CA2, CB7_CA2, CB8_CA2 },
+ {0, CB9_CA3, CB7_CA3, CB8_CA3 },
+ {0, CB9_CA4, CB7_CA4, CB8_CA4 },
+ {0, CB9_CA5, CB7_CA5, CB8_CA5 },
+ {0, CB9_CA6, CB7_CA6, CB8_CA6 },
+ {0, CB9_CA7, CB7_CA7, CB8_CA7 },
+ {0, CB9_CA8, CB7_CA8, CB8_CA8 },
+ {0, CB9_CA9, CB7_CA9, CB8_CA9 },
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA14, CB7_CA14, CB8_CA14},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA2, CB1_CA2, CB2_CA2},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, __, 45 },
+ { 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __, 58, __, 59 },
+ { 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, __, 72, 73, 74 },
+ { 75, 76, 77, __, __, __, 78, __, __, __, 79, 80, 81, 82, 83, 84 },
+ },
+ {
+ // LED Index to Physical Position
+ {3, 0}, {14, 0}, {33, 0}, {48, 0}, {63, 0}, {78, 0}, { 93, 0}, {108, 0}, {123, 0}, {138, 0}, {153, 0}, {168, 0}, {183, 0}, {198, 0}, {213,0}, {223, 0},
+ {3,12}, {14,12}, {33,12}, {48,12}, {63,12}, {78,12}, { 93, 12}, {108, 12}, {123, 12}, {138, 12}, {153, 12}, {168, 12}, {183, 12}, {205, 12}, {223, 12},
+ {7,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 25}, {223, 25},
+ {8,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {190, 38}, {223, 38},
+ {9,51}, {14,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {190, 51}, {213, 51},{223, 51},
+ {1,64}, {20,64}, {39,64}, { 95, 64}, {149, 64}, {164, 64}, {183, 64}, {198, 64}, {213, 64},{223, 64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+
+};
+#endif
diff --git a/keyboards/keychron/k3_version_3/iso/rgb/rules.mk b/keyboards/keychron/k3_version_3/iso/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/iso/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k3_version_3/iso/white/config.h b/keyboards/keychron/k3_version_3/iso/white/config.h
new file mode 100644
index 0000000000..04af74ef6f
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/iso/white/config.h
@@ -0,0 +1,50 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#define MCU_UNUSED_PINS \
+ { B2 }
+#define MCU_UNSED_PINS_STATE \
+ { PAL_MODE_INPUT_PULLDOWN }
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 85
+# define DRIVER_CS_PINS \
+ { C9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 46
+# define LOW_BAT_IND_INDEX \
+ { 78 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k3_version_3/iso/white/keyboard.json b/keyboards/keychron/k3_version_3/iso/white/keyboard.json
new file mode 100644
index 0000000000..886b86b8d6
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/iso/white/keyboard.json
@@ -0,0 +1,34 @@
+{
+ "usb": {
+ "pid": "0x0D34",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "indicators": {
+ "caps_lock": "C8",
+ "on_state": 1
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_version_3/iso/white/keymaps/default/keymap.c b/keyboards/keychron/k3_version_3/iso/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..20d83a323e
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/iso/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_85(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, BL_STEP,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_85(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_85(
+ 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_DEL, BL_STEP,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_85(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k3_version_3/iso/white/rules.mk b/keyboards/keychron/k3_version_3/iso/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/iso/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k3_version_3/iso/white/white.c b/keyboards/keychron/k3_version_3/iso/white/white.c
new file mode 100644
index 0000000000..18db33670a
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/iso/white/white.c
@@ -0,0 +1,150 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA4},
+ {0, CB1_CA5},
+ {0, CB1_CA6},
+ {0, CB1_CA7},
+ {0, CB1_CA8},
+ {0, CB1_CA9},
+ {0, CB1_CA10},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA13},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA14},
+ {0, CB4_CA16},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA7},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA14},
+ {0, CB6_CA15},
+ {0, CB6_CA16}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, __, 45 },
+ { 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __, 58, __, 59 },
+ { 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, __, 72, 73, 74 },
+ { 75, 76, 77, __, __, __, 78, __, __, __, 79, 80, 81, 82, 83, 84 },
+ },
+ {
+ {3, 0}, {14, 0}, {33, 0}, {48, 0}, {63, 0}, {78, 0}, { 93, 0}, {108, 0}, {123, 0}, {138, 0}, {153, 0}, {168, 0}, {183, 0}, {198, 0}, {213,0}, {223, 0},
+ {3,12}, {14,12}, {33,12}, {48,12}, {63,12}, {78,12}, { 93, 12}, {108, 12}, {123, 12}, {138, 12}, {153, 12}, {168, 12}, {183, 12}, {205, 12}, {223, 12},
+ {7,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 31}, {223, 25},
+ {8,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {190, 38}, {223, 38},
+ {9,51}, {14,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {190, 51}, {213, 51},{223, 51},
+ {1,64}, {20,64}, {39,64}, { 95, 64}, {149, 64}, {164, 64}, {183, 64}, {198, 64}, {213, 64},{223, 64}
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+
+};
+
+#endif
diff --git a/keyboards/keychron/k3_version_3/jis/info.json b/keyboards/keychron/k3_version_3/jis/info.json
new file mode 100644
index 0000000000..8c66c8b1cb
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/jis/info.json
@@ -0,0 +1,10 @@
+{
+ "matrix_pins": {
+ "cols": ["C6", "C7", "A13", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "indicators": {
+ "caps_lock": "C8",
+ "on_state": 1
+ }
+}
diff --git a/keyboards/keychron/k3_version_3/jis/rgb/config.h b/keyboards/keychron/k3_version_3/jis/rgb/config.h
new file mode 100644
index 0000000000..2b04b43562
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/jis/rgb/config.h
@@ -0,0 +1,48 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#define MCU_UNUSED_PINS \
+ { C8, B2 }
+#define MCU_UNSED_PINS_STATE \
+ { PAL_MODE_INPUT_PULLDOWN, PAL_MODE_INPUT_PULLDOWN }
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 87
+# define DRIVER_CS_PINS \
+ { A8, C9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+/* Indications */
+# define CAPS_LOCK_INDEX 47
+# define LOW_BAT_IND_INDEX \
+ { 79 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+#endif
diff --git a/keyboards/keychron/k3_version_3/jis/rgb/keyboard.json b/keyboards/keychron/k3_version_3/jis/rgb/keyboard.json
new file mode 100644
index 0000000000..9d61a03beb
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/jis/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0D32",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_version_3/jis/rgb/keymaps/default/keymap.c b/keyboards/keychron/k3_version_3/jis/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..80ab2205b9
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/jis/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+*/
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_jis_87(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, RGB_MOD,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_UP, KC_END,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_jis_87(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_jis_87(
+ 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_DEL, RGB_MOD,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_UP, KC_END,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_jis_87(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k3_version_3/jis/rgb/rgb.c b/keyboards/keychron/k3_version_3/jis/rgb/rgb.c
new file mode 100644
index 0000000000..e8cfa1edb1
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/jis/rgb/rgb.c
@@ -0,0 +1,153 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t PROGMEM g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB9_CA1, CB7_CA1, CB8_CA1 },
+ {0, CB9_CA2, CB7_CA2, CB8_CA2 },
+ {0, CB9_CA3, CB7_CA3, CB8_CA3 },
+ {0, CB9_CA4, CB7_CA4, CB8_CA4 },
+ {0, CB9_CA5, CB7_CA5, CB8_CA5 },
+ {0, CB9_CA6, CB7_CA6, CB8_CA6 },
+ {0, CB9_CA7, CB7_CA7, CB8_CA7 },
+ {0, CB9_CA8, CB7_CA8, CB8_CA8 },
+ {0, CB9_CA9, CB7_CA9, CB8_CA9 },
+ {0, CB9_CA10, CB7_CA10, CB8_CA10},
+ {0, CB9_CA11, CB7_CA11, CB8_CA11},
+ {0, CB9_CA12, CB7_CA12, CB8_CA12},
+ {0, CB9_CA13, CB7_CA13, CB8_CA13},
+ {0, CB9_CA14, CB7_CA14, CB8_CA14},
+ {0, CB9_CA15, CB7_CA15, CB8_CA15},
+ {0, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA15, CB4_CA15, CB5_CA15},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA4, CB4_CA4, CB5_CA4},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA10, CB4_CA10, CB5_CA10},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31 },
+ { 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, __, 46 },
+ { 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, __, 59, __, 60 },
+ { 61, __, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, __, 72, 73, 74 },
+ { 75, 76, 77, 78, __, __, 79, __, __, 80, 81, 82, 83, 84, 85, 86 },
+ },
+ {
+ {3, 0}, {14, 0}, {33, 0}, {48, 0}, {63, 0}, {78, 0}, { 93, 0}, {108, 0}, {123, 0}, {138, 0}, {153, 0}, {168, 0}, {183, 0}, {198, 0}, {213,0}, {223, 0},
+ {3,12}, {14,12}, {33,12}, {48,12}, {63,12}, {78,12}, { 93, 12}, {108, 12}, {123, 12}, {138, 12}, {153, 12}, {168, 12}, {183, 12}, {205, 12}, {213,12}, {223, 12},
+ {7,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 31}, {223, 25},
+ {8,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {187, 38}, {223, 38},
+ {9,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {183, 51}, {213, 51},{223, 51},
+ {1,64}, {20,64}, {39,64}, {54,64}, { 95, 64}, {138, 64}, {149, 64}, {164, 64}, {183, 64}, {205, 64}, {213, 64},{223, 64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+
+};
+#endif
diff --git a/keyboards/keychron/k3_version_3/jis/rgb/rules.mk b/keyboards/keychron/k3_version_3/jis/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/jis/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k3_version_3/jis/white/config.h b/keyboards/keychron/k3_version_3/jis/white/config.h
new file mode 100644
index 0000000000..7642edf0d9
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/jis/white/config.h
@@ -0,0 +1,51 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#define MCU_UNUSED_PINS \
+ { B2 }
+#define MCU_UNSED_PINS_STATE \
+ { PAL_MODE_INPUT_PULLDOWN }
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 87
+# define DRIVER_CS_PINS \
+ { C9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 47
+# define LOW_BAT_IND_INDEX \
+ { 79 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k3_version_3/jis/white/keyboard.json b/keyboards/keychron/k3_version_3/jis/white/keyboard.json
new file mode 100644
index 0000000000..7bdd287950
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/jis/white/keyboard.json
@@ -0,0 +1,34 @@
+{
+ "usb": {
+ "pid": "0x0D35",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "indicators": {
+ "caps_lock": "C8",
+ "on_state": 1
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k3_version_3/jis/white/keymaps/default/keymap.c b/keyboards/keychron/k3_version_3/jis/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..427f6bae7f
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/jis/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_jis_87(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_DEL, BL_STEP,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_UP, KC_END,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_jis_87(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_jis_87(
+ 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_DEL, BL_STEP,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_UP, KC_END,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_jis_87(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k3_version_3/jis/white/rules.mk b/keyboards/keychron/k3_version_3/jis/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/jis/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k3_version_3/jis/white/white.c b/keyboards/keychron/k3_version_3/jis/white/white.c
new file mode 100644
index 0000000000..22518af6cf
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/jis/white/white.c
@@ -0,0 +1,151 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA4},
+ {0, CB1_CA5},
+ {0, CB1_CA6},
+ {0, CB1_CA7},
+ {0, CB1_CA8},
+ {0, CB1_CA9},
+ {0, CB1_CA10},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA14},
+ {0, CB2_CA15},
+ {0, CB2_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA13},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA14},
+ {0, CB4_CA16},
+
+ {0, CB5_CA1},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA7},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA14},
+ {0, CB6_CA15},
+ {0, CB6_CA16}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31 },
+ { 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, __, 46 },
+ { 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, __, 59, __, 60 },
+ { 61, __, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, __, 72, 73, 74 },
+ { 75, 76, 77, 78, __, __, 79, __, __, 80, 81, 82, 83, 84, 85, 86 },
+ },
+ {
+ // LED Index to Physical Position
+ {3, 0}, {14, 0}, {33, 0}, {48, 0}, {63, 0}, {78, 0}, { 93, 0}, {108, 0}, {123, 0}, {138, 0}, {153, 0}, {168, 0}, {183, 0}, {198, 0}, {213,0}, {223, 0},
+ {3,12}, {14,12}, {33,12}, {48,12}, {63,12}, {78,12}, { 93, 12}, {108, 12}, {123, 12}, {138, 12}, {153, 12}, {168, 12}, {183, 12}, {205, 12}, {213,12}, {223, 12},
+ {7,25}, {22,25}, {37,25}, {52,25}, {67,25}, {82,25}, { 97, 25}, {112, 25}, {126, 25}, {141, 25}, {156, 25}, {171, 25}, {186, 25}, {205, 31}, {223, 25},
+ {8,38}, {26,38}, {41,38}, {55,38}, {70,38}, {85,38}, {100, 38}, {115, 38}, {130, 38}, {145, 38}, {160, 38}, {175, 38}, {205, 38}, {223, 38},
+ {9,51}, {33,51}, {48,51}, {63,51}, {78,51}, { 93, 51}, {108, 51}, {123, 51}, {138, 51}, {153, 51}, {168, 51}, {190, 51}, {213, 51},{223, 51},
+ {1,64}, {20,64}, {39,64}, {54,64}, { 95, 64}, {138, 64}, {149, 64}, {164, 64}, {183, 64}, {205, 64}, {213, 64},{223, 64}
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k3_version_3/k3_version_3.c b/keyboards/keychron/k3_version_3/k3_version_3.c
new file mode 100644
index 0000000000..970d09d5db
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/k3_version_3.c
@@ -0,0 +1,122 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "transport.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#include "print.h"
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef BT_INDICATION_LED_PIN_LIST
+pin_t bt_led_pins[] = BT_INDICATION_LED_PIN_LIST;
+#endif
+
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 2));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+
+#if 0
+extern bool wakeup_from_lpm;
+
+void early_hardware_init_post(void)
+{
+ if (!wakeup_from_lpm)
+ {
+ gpio_set_pin_output_push_pull(LED_CAPS_LOCK_PIN);
+ gpio_write_pin(LED_CAPS_LOCK_PIN, !LED_PIN_ON_STATE);
+ }
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+# ifdef P2P4_MODE_SELECT_PIN
+ palSetLineMode(P2P4_MODE_SELECT_PIN, PAL_MODE_INPUT);
+# elif defined(USB_MODE_SELECT_PIN)
+ palSetLineMode(USB_MODE_SELECT_PIN, PAL_MODE_INPUT);
+# endif
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+#if defined(MCU_UNUSED_PINS) && defined(MCU_UNSED_PINS_STATE)
+ pin_t unused_pins[] = MCU_UNUSED_PINS;
+ uint32_t unused_pins_state[] = MCU_UNSED_PINS_STATE;
+
+ for (uint8_t i = 0; i < ARRAY_SIZE(unused_pins); i++) {
+ palSetLineMode(unused_pins[i], unused_pins_state[i]);
+ }
+#endif
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+ // if (!host_keyboard_led_state().caps_lock) gpio_write_pin(LED_CAPS_LOCK_PIN, !LED_PIN_ON_STATE);
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+ // for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ // gpio_write_pin(bt_led_pins[i], 1);
+#endif
+
+ } else {
+ // gpio_write_pin(LED_CAPS_LOCK_PIN, LED_PIN_ON_STATE);
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+ // if (get_transport() != TRANSPORT_P2P4)
+ // for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ // gpio_write_pin(bt_led_pins[i], 0);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/k3_version_3/mcuconf.h b/keyboards/keychron/k3_version_3/mcuconf.h
new file mode 100644
index 0000000000..dcbd5309f1
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/mcuconf.h
@@ -0,0 +1,25 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+#undef WB32_I2C_USE_I2C1
+#define WB32_I2C_USE_I2C1 TRUE
+
+#undef WB32_SPI_USE_QSPI
+#define WB32_SPI_USE_QSPI TRUE
diff --git a/keyboards/keychron/k3_version_3/readme.md b/keyboards/keychron/k3_version_3/readme.md
new file mode 100644
index 0000000000..d27a1d8d25
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/readme.md
@@ -0,0 +1,23 @@
+# Keychron K3 Version 3
+
+
+
+A customizable TKL keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron K3 Version 3
+* Hardware Availability: [Keychron K3 Version 3 QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-k3-qmk-wireless-mechanical-keyboard-version-3)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/k3_version_3/ansi/rgb:default
+ make keychron/k3_version_3/ansi/white:default
+
+Flashing example for this keyboard:
+
+ make keychron/k3_version_3/ansi/rgb:default:flash
+ make keychron/k3_version_3/ansi/white:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/k3_version_3/rules.mk b/keyboards/keychron/k3_version_3/rules.mk
new file mode 100644
index 0000000000..50ba854ed9
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
\ No newline at end of file
diff --git a/keyboards/keychron/k3_version_3/via_json/k3_version_3_ansi_rgb.json b/keyboards/keychron/k3_version_3/via_json/k3_version_3_ansi_rgb.json
new file mode 100644
index 0000000000..ea5df6c888
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/via_json/k3_version_3_ansi_rgb.json
@@ -0,0 +1,268 @@
+{
+ "name": "Keychron K3 Version 3 ANSI RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0D30",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ "3, 15"
+ ],
+ [
+ {
+ "w": 2.25
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "c": "#cccccc"
+ },
+ "4, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "c": "#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k3_version_3/via_json/k3_version_3_ansi_white.json b/keyboards/keychron/k3_version_3/via_json/k3_version_3_ansi_white.json
new file mode 100644
index 0000000000..1e8ac9dfaa
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/via_json/k3_version_3_ansi_white.json
@@ -0,0 +1,207 @@
+{
+ "name": "Keychron K3 Version 3 ANSI WHITE",
+ "vendorId": "0x3434",
+ "productId": "0x0D33",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ "3, 15"
+ ],
+ [
+ {
+ "w": 2.25
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "c": "#cccccc"
+ },
+ "4, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "c": "#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k3_version_3/via_json/k3_version_3_iso_rgb.json b/keyboards/keychron/k3_version_3/via_json/k3_version_3_iso_rgb.json
new file mode 100644
index 0000000000..d1da01e314
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/via_json/k3_version_3_iso_rgb.json
@@ -0,0 +1,279 @@
+{
+ "name": "Keychron K3 Version 3 ISO RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0D31",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ {
+ "x":1.25
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "4, 0",
+ "4, 1",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w":1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "c": "#cccccc"
+ },
+ "4, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "c": "#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k3_version_3/via_json/k3_version_3_iso_white.json b/keyboards/keychron/k3_version_3/via_json/k3_version_3_iso_white.json
new file mode 100644
index 0000000000..c7bcf6d252
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/via_json/k3_version_3_iso_white.json
@@ -0,0 +1,218 @@
+{
+ "name": "Keychron K3 Version 3 ISO WHITE",
+ "vendorId": "0x3434",
+ "productId": "0x0D34",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ {
+ "x":1.25
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "4, 0",
+ "4, 1",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w":1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "c": "#cccccc"
+ },
+ "4, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "c": "#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k3_version_3/via_json/k3_version_3_jis_rgb.json b/keyboards/keychron/k3_version_3/via_json/k3_version_3_jis_rgb.json
new file mode 100644
index 0000000000..1f36625821
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/via_json/k3_version_3_jis_rgb.json
@@ -0,0 +1,276 @@
+{
+ "name": "Keychron K3 Version 3 JIS RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0D32",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ "1, 14",
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "c": "#777777",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ {
+ "x":1.25
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 2.25
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "c": "#cccccc",
+ "w": 1.75
+ },
+ "4, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w":1.25
+ },
+ "5, 0",
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ "5, 3",
+ {
+ "w": 4.5,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 9",
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "c": "#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k3_version_3/via_json/k3_version_3_jis_white.json b/keyboards/keychron/k3_version_3/via_json/k3_version_3_jis_white.json
new file mode 100644
index 0000000000..f62d4e7456
--- /dev/null
+++ b/keyboards/keychron/k3_version_3/via_json/k3_version_3_jis_white.json
@@ -0,0 +1,215 @@
+{
+ "name": "Keychron K3 Version 3 JIS WHITE",
+ "vendorId": "0x3434",
+ "productId": "0x0D35",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ "1, 14",
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "c": "#777777",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ {
+ "x":1.25
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 2.25
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "c": "#cccccc",
+ "w": 1.75
+ },
+ "4, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w":1.25
+ },
+ "5, 0",
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ "5, 3",
+ {
+ "w": 4.5,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 9",
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "c": "#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k5_max/ansi/rgb/config.h b/keyboards/keychron/k5_max/ansi/rgb/config.h
new file mode 100644
index 0000000000..bb1bfb402e
--- /dev/null
+++ b/keyboards/keychron/k5_max/ansi/rgb/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 108
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define LOW_BAT_IND_INDEX \
+ { 98 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k5_max/ansi/rgb/keyboard.json b/keyboards/keychron/k5_max/ansi/rgb/keyboard.json
new file mode 100644
index 0000000000..9ace101719
--- /dev/null
+++ b/keyboards/keychron/k5_max/ansi/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A50",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k5_max/ansi/rgb/keymaps/default/keymap.c b/keyboards/keychron/k5_max/ansi/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..c2d9a795aa
--- /dev/null
+++ b/keyboards/keychron/k5_max/ansi/rgb/keymaps/default/keymap.c
@@ -0,0 +1,68 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_108_ansi(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, RGB_MOD, KC_F13, KC_F14, KC_F15, KC_F16,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [MAC_FN] = LAYOUT_108_ansi(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_108_ansi(
+ 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_CTANA, RGB_MOD, _______, _______, _______, _______,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [WIN_FN] = LAYOUT_108_ansi(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k5_max/ansi/rgb/rgb.c b/keyboards/keychron/k5_max/ansi/rgb/rgb.c
new file mode 100644
index 0000000000..f7d5c558ba
--- /dev/null
+++ b/keyboards/keychron/k5_max/ansi/rgb/rgb.c
@@ -0,0 +1,174 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+
+ {0, CB3_CA1, CB1_CA1, CB2_CA1},
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA14, CB1_CA14, CB2_CA14},
+ {0, CB3_CA15, CB1_CA15, CB2_CA15},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB10_CA10, CB12_CA10, CB11_CA10},
+ {1, CB10_CA11, CB12_CA11, CB11_CA11},
+ {1, CB10_CA12, CB12_CA12, CB11_CA12},
+ {1, CB10_CA13, CB12_CA13, CB11_CA13},
+
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB10_CA14, CB12_CA14, CB11_CA14},
+ {1, CB10_CA15, CB12_CA15, CB11_CA15},
+ {1, CB10_CA16, CB12_CA16, CB11_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, 14, 15, 16, 17, 18, 19 },
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40 },
+ { 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61 },
+ { 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, 74, __, __, __, 75, 76, 77, __ },
+ { 78, __, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, __, 89, __, 90, __, 91, 92, 93, 94 },
+ { 95, 96, 97, __, __, __, 98, __, __, __, 99, 100, 101, 102, 103, 104, 105, 106, __, 107, __ },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {21, 0}, {32, 0}, {42, 0}, {53, 0}, {69, 0}, {79, 0}, {90, 0}, {100, 0}, {116, 0}, {127, 0}, {137, 0}, {148, 0}, {160, 0}, {170, 0}, {181, 0}, {192, 0}, {203, 0}, {213, 0}, {224, 0},
+ {0,14}, {11,14}, {21,14}, {32,14}, {42,14}, {53,14}, {63,14}, {74,14}, { 84,14}, { 95,14}, {106,14}, {116,14}, {127,14}, {143,14}, {160,14}, {170,14}, {181,14}, {192,14}, {203,14}, {213,14}, {224,14},
+ {3,26}, {16,26}, {26,26}, {37,26}, {48,26}, {58,26}, {69,26}, {79,26}, { 90,26}, {100,26}, {111,26}, {121,26}, {132,26}, {145,26}, {160,26}, {170,26}, {181,26}, {192,26}, {203,26}, {213,26}, {224,33},
+ {4,39}, {19,39}, {29,39}, {40,39}, {50,39}, {61,39}, {71,39}, {82,39}, { 92,39}, {103,39}, {114,39}, {124,39}, {141,39}, {192,39}, {203,39}, {213,39},
+ {7,51}, {24,51}, {34,51}, {45,51}, {55,51}, {66,51}, {77,51}, { 87,51}, { 98,51}, {108,51}, {119,51}, {139,51}, {170,51}, {192,51}, {203,51}, {213,51}, {224,58},
+ {1,64}, {15,64}, {28,64}, {67,64}, {107,64}, {120,64}, {133,64}, {147,64}, {160,64}, {170,64}, {181,64}, {198,64}, {213,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k5_max/ansi/rgb/rules.mk b/keyboards/keychron/k5_max/ansi/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k5_max/ansi/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k5_max/ansi/white/config.h b/keyboards/keychron/k5_max/ansi/white/config.h
new file mode 100644
index 0000000000..c5ae9518b3
--- /dev/null
+++ b/keyboards/keychron/k5_max/ansi/white/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 108
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_8_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define LOW_BAT_IND_INDEX \
+ { 98 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k5_max/ansi/white/keyboard.json b/keyboards/keychron/k5_max/ansi/white/keyboard.json
new file mode 100644
index 0000000000..e031f22b73
--- /dev/null
+++ b/keyboards/keychron/k5_max/ansi/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A53",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k5_max/ansi/white/keymaps/default/keymap.c b/keyboards/keychron/k5_max/ansi/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..99c1055ba3
--- /dev/null
+++ b/keyboards/keychron/k5_max/ansi/white/keymaps/default/keymap.c
@@ -0,0 +1,68 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_108_ansi(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, BL_STEP, KC_F13, KC_F14, KC_F15, KC_F16,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [MAC_FN] = LAYOUT_108_ansi(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_108_ansi(
+ 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_CTANA, BL_STEP, _______, _______, _______, _______,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [WIN_FN] = LAYOUT_108_ansi(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k5_max/ansi/white/rules.mk b/keyboards/keychron/k5_max/ansi/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k5_max/ansi/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k5_max/ansi/white/white.c b/keyboards/keychron/k5_max/ansi/white/white.c
new file mode 100644
index 0000000000..ff761ed9be
--- /dev/null
+++ b/keyboards/keychron/k5_max/ansi/white/white.c
@@ -0,0 +1,172 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA5},
+ {0, CB6_CA6},
+ {0, CB6_CA7},
+ {0, CB6_CA8},
+ {0, CB6_CA9},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+ {0, CB6_CA14},
+ {0, CB8_CA7},
+ {0, CB8_CA8},
+ {0, CB8_CA9},
+ {0, CB8_CA10},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+ {0, CB7_CA7},
+ {0, CB7_CA8},
+ {0, CB7_CA9},
+ {0, CB7_CA10},
+ {0, CB7_CA11},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA15},
+ {0, CB4_CA16},
+ {0, CB7_CA12},
+ {0, CB7_CA13},
+ {0, CB7_CA14},
+ {0, CB7_CA15},
+ {0, CB7_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+ {0, CB3_CA13},
+ {0, CB3_CA15},
+ {0, CB3_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+ {0, CB2_CA13},
+ {0, CB8_CA11},
+ {0, CB8_CA12},
+ {0, CB8_CA13},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA7},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+ {0, CB8_CA14},
+ {0, CB8_CA15},
+ {0, CB8_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, 14, 15, 16, 17, 18, 19 },
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40 },
+ { 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61 },
+ { 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, 74, __, __, __, 75, 76, 77, __ },
+ { 78, __, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, __, 89, __, 90, __, 91, 92, 93, 94 },
+ { 95, 96, 97, __, __, __, 98, __, __, __, 99, 100, 101, 102, 103, 104, 105, 106, __, 107, __ },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {21, 0}, {32, 0}, {42, 0}, {53, 0}, {69, 0}, {79, 0}, {90, 0}, {100, 0}, {116, 0}, {127, 0}, {137, 0}, {148, 0}, {160, 0}, {170, 0}, {181, 0}, {192, 0}, {203, 0}, {213, 0}, {224, 0},
+ {0,14}, {11,14}, {21,14}, {32,14}, {42,14}, {53,14}, {63,14}, {74,14}, { 84,14}, { 95,14}, {106,14}, {116,14}, {127,14}, {143,14}, {160,14}, {170,14}, {181,14}, {192,14}, {203,14}, {213,14}, {224,14},
+ {3,26}, {16,26}, {26,26}, {37,26}, {48,26}, {58,26}, {69,26}, {79,26}, { 90,26}, {100,26}, {111,26}, {121,26}, {132,26}, {145,26}, {160,26}, {170,26}, {181,26}, {192,26}, {203,26}, {213,26}, {224,33},
+ {4,39}, {19,39}, {29,39}, {40,39}, {50,39}, {61,39}, {71,39}, {82,39}, { 92,39}, {103,39}, {114,39}, {124,39}, {141,39}, {192,39}, {203,39}, {213,39},
+ {7,51}, {24,51}, {34,51}, {45,51}, {55,51}, {66,51}, {77,51}, { 87,51}, { 98,51}, {108,51}, {119,51}, {139,51}, {170,51}, {192,51}, {203,51}, {213,51}, {224,58},
+ {1,64}, {15,64}, {28,64}, {67,64}, {107,64}, {120,64}, {133,64}, {147,64}, {160,64}, {170,64}, {181,64}, {198,64}, {213,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k5_max/board.h b/keyboards/keychron/k5_max/board.h
new file mode 100644
index 0000000000..eb1aac7713
--- /dev/null
+++ b/keyboards/keychron/k5_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLDOWN(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/k5_max/config.h b/keyboards/keychron/k5_max/config.h
new file mode 100644
index 0000000000..0dee7fdf07
--- /dev/null
+++ b/keyboards/keychron/k5_max/config.h
@@ -0,0 +1,84 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+# define BT_INDICATION_LED_PIN_LIST \
+ { C9, C9, C9 }
+# define BT_INDICATION_LED_ON_STATE 0
+
+# define P24G_HOST_DEVICES_COUNT 1
+# define P24G_INDICATION_LED_PIN_LIST \
+ { A8 }
+
+# if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 24
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 21, 22, 23 }
+# define BAT_LEVEL_LED_LIST \
+ { 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/k5_max/halconf.h b/keyboards/keychron/k5_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/k5_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/k5_max/info.json b/keyboards/keychron/k5_max/info.json
new file mode 100644
index 0000000000..57addbb8b3
--- /dev/null
+++ b/keyboards/keychron/k5_max/info.json
@@ -0,0 +1,276 @@
+{
+ "keyboard_name": "Keychron K5 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey": true,
+ "mousekey": true,
+ "dip_switch": true,
+ "nkro": true,
+ "raw": true,
+ "send_string": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "C5", "B10", "B15"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch": {
+ "pins": ["B14"]
+ },
+ "indicators": {
+ "caps_lock": "A13",
+ "on_state": 1
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "layouts": {
+ "LAYOUT_108_ansi": {
+ "layout": [
+ {"matrix":[0,0], "x":0, "y":0},
+ {"matrix":[0,1], "x":2, "y":0},
+ {"matrix":[0,2], "x":3, "y":0},
+ {"matrix":[0,3], "x":4, "y":0},
+ {"matrix":[0,4], "x":5, "y":0},
+ {"matrix":[0,5], "x":6.5, "y":0},
+ {"matrix":[0,6], "x":7.5, "y":0},
+ {"matrix":[0,7], "x":8.5, "y":0},
+ {"matrix":[0,8], "x":9.5, "y":0},
+ {"matrix":[0,9], "x":11, "y":0},
+ {"matrix":[0,10], "x":12, "y":0},
+ {"matrix":[0,11], "x":13, "y":0},
+ {"matrix":[0,12], "x":14, "y":0},
+ {"matrix":[0,14], "x":15.25, "y":0},
+ {"matrix":[0,15], "x":16.25, "y":0},
+ {"matrix":[0,16], "x":17.25, "y":0},
+ {"matrix":[0,17], "x":18.5, "y":0},
+ {"matrix":[0,18], "x":19.5, "y":0},
+ {"matrix":[0,19], "x":20.5, "y":0},
+ {"matrix":[0,20], "x":21.5, "y":0},
+
+ {"matrix":[1,0], "x":0, "y":1.25},
+ {"matrix":[1,1], "x":1, "y":1.25},
+ {"matrix":[1,2], "x":2, "y":1.25},
+ {"matrix":[1,3], "x":3, "y":1.25},
+ {"matrix":[1,4], "x":4, "y":1.25},
+ {"matrix":[1,5], "x":5, "y":1.25},
+ {"matrix":[1,6], "x":6, "y":1.25},
+ {"matrix":[1,7], "x":7, "y":1.25},
+ {"matrix":[1,8], "x":8, "y":1.25},
+ {"matrix":[1,9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[1,13], "x":13, "y":1.25, "w":2},
+ {"matrix":[1,14], "x":15.25, "y":1.25},
+ {"matrix":[1,15], "x":16.25, "y":1.25},
+ {"matrix":[1,16], "x":17.25, "y":1.25},
+ {"matrix":[1,17], "x":18.5, "y":1.25},
+ {"matrix":[1,18], "x":19.5, "y":1.25},
+ {"matrix":[1,19], "x":20.5, "y":1.25},
+ {"matrix":[1,20], "x":21.5, "y":1.25},
+
+ {"matrix":[2,0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2,1], "x":1.5, "y":2.25},
+ {"matrix":[2,2], "x":2.5, "y":2.25},
+ {"matrix":[2,3], "x":3.5, "y":2.25},
+ {"matrix":[2,4], "x":4.5, "y":2.25},
+ {"matrix":[2,5], "x":5.5, "y":2.25},
+ {"matrix":[2,6], "x":6.5, "y":2.25},
+ {"matrix":[2,7], "x":7.5, "y":2.25},
+ {"matrix":[2,8], "x":8.5, "y":2.25},
+ {"matrix":[2,9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,13], "x":13.5, "y":2.25, "w":1.5},
+ {"matrix":[2,14], "x":15.25, "y":2.25},
+ {"matrix":[2,15], "x":16.25, "y":2.25},
+ {"matrix":[2,16], "x":17.25, "y":2.25},
+ {"matrix":[2,17], "x":18.5, "y":2.25},
+ {"matrix":[2,18], "x":19.5, "y":2.25},
+ {"matrix":[2,19], "x":20.5, "y":2.25},
+
+ {"matrix":[3,0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3,1], "x":1.75, "y":3.25},
+ {"matrix":[3,2], "x":2.75, "y":3.25},
+ {"matrix":[3,3], "x":3.75, "y":3.25},
+ {"matrix":[3,4], "x":4.75, "y":3.25},
+ {"matrix":[3,5], "x":5.75, "y":3.25},
+ {"matrix":[3,6], "x":6.75, "y":3.25},
+ {"matrix":[3,7], "x":7.75, "y":3.25},
+ {"matrix":[3,8], "x":8.75, "y":3.25},
+ {"matrix":[3,9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,13], "x":12.75, "y":3.25, "w":2.25},
+ {"matrix":[3,17], "x":18.5, "y":3.25},
+ {"matrix":[3,18], "x":19.5, "y":3.25},
+ {"matrix":[3,19], "x":20.5, "y":3.25},
+ {"matrix":[2,20], "x":21.5, "y":2.25, "h":2},
+
+ {"matrix":[4,0], "x":0, "y":4.25, "w":2.25},
+ {"matrix":[4,2], "x":2.25, "y":4.25},
+ {"matrix":[4,3], "x":3.25, "y":4.25},
+ {"matrix":[4,4], "x":4.25, "y":4.25},
+ {"matrix":[4,5], "x":5.25, "y":4.25},
+ {"matrix":[4,6], "x":6.25, "y":4.25},
+ {"matrix":[4,7], "x":7.25, "y":4.25},
+ {"matrix":[4,8], "x":8.25, "y":4.25},
+ {"matrix":[4,9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25, "y":4.25},
+ {"matrix":[4,11], "x":11.25, "y":4.25},
+ {"matrix":[4,13], "x":12.25, "y":4.25, "w":2.75},
+ {"matrix":[4,15], "x":16.25, "y":4.25},
+ {"matrix":[4,17], "x":18.5, "y":4.25},
+ {"matrix":[4,18], "x":19.5, "y":4.25},
+ {"matrix":[4,19], "x":20.5, "y":4.25},
+
+ {"matrix":[5,0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5,1], "x":1.25, "y":5.25, "w":1.25},
+ {"matrix":[5,2], "x":2.5, "y":5.25, "w":1.25},
+ {"matrix":[5,6], "x":3.75, "y":5.25, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5.25, "w":1.25},
+ {"matrix":[5,11], "x":11.25, "y":5.25, "w":1.25},
+ {"matrix":[5,12], "x":12.5, "y":5.25, "w":1.25},
+ {"matrix":[5,13], "x":13.75, "y":5.25, "w":1.25},
+ {"matrix":[5,14], "x":15.25, "y":5.25},
+ {"matrix":[5,15], "x":16.25, "y":5.25},
+ {"matrix":[5,16], "x":17.25, "y":5.25},
+ {"matrix":[5,17], "x":18.5, "y":5.25, "w":2},
+ {"matrix":[5,19], "x":20.5, "y":5.25}
+ {"matrix":[4,20], "x":21.5, "y":4.25, "h":2},
+ ]
+ },
+ "LAYOUT_109_iso": {
+ "layout": [
+ {"matrix":[0,0], "x":0, "y":0},
+ {"matrix":[0,1], "x":2, "y":0},
+ {"matrix":[0,2], "x":3, "y":0},
+ {"matrix":[0,3], "x":4, "y":0},
+ {"matrix":[0,4], "x":5, "y":0},
+ {"matrix":[0,5], "x":6.5, "y":0},
+ {"matrix":[0,6], "x":7.5, "y":0},
+ {"matrix":[0,7], "x":8.5, "y":0},
+ {"matrix":[0,8], "x":9.5, "y":0},
+ {"matrix":[0,9], "x":11, "y":0},
+ {"matrix":[0,10], "x":12, "y":0},
+ {"matrix":[0,11], "x":13, "y":0},
+ {"matrix":[0,12], "x":14, "y":0},
+ {"matrix":[0,14], "x":15.25, "y":0},
+ {"matrix":[0,15], "x":16.25, "y":0},
+ {"matrix":[0,16], "x":17.25, "y":0},
+ {"matrix":[0,17], "x":18.5, "y":0},
+ {"matrix":[0,18], "x":19.5, "y":0},
+ {"matrix":[0,19], "x":20.5, "y":0},
+ {"matrix":[0,20], "x":21.5, "y":0},
+
+ {"matrix":[1,0], "x":0, "y":1.25},
+ {"matrix":[1,1], "x":1, "y":1.25},
+ {"matrix":[1,2], "x":2, "y":1.25},
+ {"matrix":[1,3], "x":3, "y":1.25},
+ {"matrix":[1,4], "x":4, "y":1.25},
+ {"matrix":[1,5], "x":5, "y":1.25},
+ {"matrix":[1,6], "x":6, "y":1.25},
+ {"matrix":[1,7], "x":7, "y":1.25},
+ {"matrix":[1,8], "x":8, "y":1.25},
+ {"matrix":[1,9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[1,13], "x":13, "y":1.25, "w":2},
+ {"matrix":[1,14], "x":15.25, "y":1.25},
+ {"matrix":[1,15], "x":16.25, "y":1.25},
+ {"matrix":[1,16], "x":17.25, "y":1.25},
+ {"matrix":[1,17], "x":18.5, "y":1.25},
+ {"matrix":[1,18], "x":19.5, "y":1.25},
+ {"matrix":[1,19], "x":20.5, "y":1.25},
+ {"matrix":[1,20], "x":21.5, "y":1.25},
+
+ {"matrix":[2,0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2,1], "x":1.5, "y":2.25},
+ {"matrix":[2,2], "x":2.5, "y":2.25},
+ {"matrix":[2,3], "x":3.5, "y":2.25},
+ {"matrix":[2,4], "x":4.5, "y":2.25},
+ {"matrix":[2,5], "x":5.5, "y":2.25},
+ {"matrix":[2,6], "x":6.5, "y":2.25},
+ {"matrix":[2,7], "x":7.5, "y":2.25},
+ {"matrix":[2,8], "x":8.5, "y":2.25},
+ {"matrix":[2,9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,14], "x":15.25, "y":2.25},
+ {"matrix":[2,15], "x":16.25, "y":2.25},
+ {"matrix":[2,16], "x":17.25, "y":2.25},
+ {"matrix":[2,17], "x":18.5, "y":2.25},
+ {"matrix":[2,18], "x":19.5, "y":2.25},
+ {"matrix":[2,19], "x":20.5, "y":2.25},
+
+ {"matrix":[3,0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3,1], "x":1.75, "y":3.25},
+ {"matrix":[3,2], "x":2.75, "y":3.25},
+ {"matrix":[3,3], "x":3.75, "y":3.25},
+ {"matrix":[3,4], "x":4.75, "y":3.25},
+ {"matrix":[3,5], "x":5.75, "y":3.25},
+ {"matrix":[3,6], "x":6.75, "y":3.25},
+ {"matrix":[3,7], "x":7.75, "y":3.25},
+ {"matrix":[3,8], "x":8.75, "y":3.25},
+ {"matrix":[3,9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,13], "x":12.75, "y":3.25},
+ {"matrix":[2,13], "x":13.75, "y":2.25, "w":1.25, "h":2},
+ {"matrix":[3,17], "x":18.5, "y":3.25},
+ {"matrix":[3,18], "x":19.5, "y":3.25},
+ {"matrix":[3,19], "x":20.5, "y":3.25},
+ {"matrix":[2,20], "x":21.5, "y":2.25, "h":2},
+
+ {"matrix":[4,0], "x":0, "y":4.25, "w":1.25},
+ {"matrix":[4,1], "x":1.25, "y":4.25},
+ {"matrix":[4,2], "x":2.25, "y":4.25},
+ {"matrix":[4,3], "x":3.25, "y":4.25},
+ {"matrix":[4,4], "x":4.25, "y":4.25},
+ {"matrix":[4,5], "x":5.25, "y":4.25},
+ {"matrix":[4,6], "x":6.25, "y":4.25},
+ {"matrix":[4,7], "x":7.25, "y":4.25},
+ {"matrix":[4,8], "x":8.25, "y":4.25},
+ {"matrix":[4,9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25, "y":4.25},
+ {"matrix":[4,11], "x":11.25, "y":4.25},
+ {"matrix":[4,13], "x":12.25, "y":4.25, "w":2.75},
+ {"matrix":[4,15], "x":16.25, "y":4.25},
+ {"matrix":[4,17], "x":18.5, "y":4.25},
+ {"matrix":[4,18], "x":19.5, "y":4.25},
+ {"matrix":[4,19], "x":20.5, "y":4.25},
+
+ {"matrix":[5,0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5,1], "x":1.25, "y":5.25, "w":1.25},
+ {"matrix":[5,2], "x":2.5, "y":5.25, "w":1.25},
+ {"matrix":[5,6], "x":3.75, "y":5.25, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5.25, "w":1.25},
+ {"matrix":[5,11], "x":11.25, "y":5.25, "w":1.25},
+ {"matrix":[5,12], "x":12.5, "y":5.25, "w":1.25},
+ {"matrix":[5,13], "x":13.75, "y":5.25, "w":1.25},
+ {"matrix":[5,14], "x":15.25, "y":5.25},
+ {"matrix":[5,15], "x":16.25, "y":5.25},
+ {"matrix":[5,16], "x":17.25, "y":5.25},
+ {"matrix":[5,17], "x":18.5, "y":5.25, "w":2},
+ {"matrix":[5,19], "x":20.5, "y":5.25},
+ {"matrix":[4,20], "x":21.5, "y":4.25, "h":2}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/k5_max/iso/rgb/config.h b/keyboards/keychron/k5_max/iso/rgb/config.h
new file mode 100644
index 0000000000..7621f0942d
--- /dev/null
+++ b/keyboards/keychron/k5_max/iso/rgb/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 109
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12, 0x12 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define LOW_BAT_IND_INDEX \
+ { 99 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k5_max/iso/rgb/keyboard.json b/keyboards/keychron/k5_max/iso/rgb/keyboard.json
new file mode 100644
index 0000000000..5be8112bad
--- /dev/null
+++ b/keyboards/keychron/k5_max/iso/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A51",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k5_max/iso/rgb/keymaps/default/keymap.c b/keyboards/keychron/k5_max/iso/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..ffb0cd86fd
--- /dev/null
+++ b/keyboards/keychron/k5_max/iso/rgb/keymaps/default/keymap.c
@@ -0,0 +1,68 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_109_iso(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, RGB_MOD, KC_F13, KC_F14, KC_F15, KC_F16,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [MAC_FN] = LAYOUT_109_iso(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_109_iso(
+ 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_CTANA, RGB_MOD, _______, _______, _______, _______,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [WIN_FN] = LAYOUT_109_iso(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k5_max/iso/rgb/rgb.c b/keyboards/keychron/k5_max/iso/rgb/rgb.c
new file mode 100644
index 0000000000..20cc5b749f
--- /dev/null
+++ b/keyboards/keychron/k5_max/iso/rgb/rgb.c
@@ -0,0 +1,175 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+
+ {0, CB3_CA1, CB1_CA1, CB2_CA1},
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA14, CB1_CA14, CB2_CA14},
+ {0, CB3_CA15, CB1_CA15, CB2_CA15},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB10_CA10, CB12_CA10, CB11_CA10},
+ {1, CB10_CA11, CB12_CA11, CB11_CA11},
+ {1, CB10_CA12, CB12_CA12, CB11_CA12},
+ {1, CB10_CA13, CB12_CA13, CB11_CA13},
+
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB10_CA14, CB12_CA14, CB11_CA14},
+ {1, CB10_CA15, CB12_CA15, CB11_CA15},
+ {1, CB10_CA16, CB12_CA16, CB11_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, 14, 15, 16, 17, 18, 19 },
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40 },
+ { 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61 },
+ { 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, 74, __, __, __, 75, 76, 77, __ },
+ { 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, __, 90, __, 91, __, 92, 93, 94, 95 },
+ { 96, 97, 98, __, __, __, 99, __, __, __, 100, 101, 102, 103, 104, 105, 106, 107, __, 108, __ },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {21, 0}, {32, 0}, {42, 0}, {53, 0}, {69, 0}, {79, 0}, {90, 0}, {100, 0}, {116, 0}, {127, 0}, {137, 0}, {148, 0}, {160, 0}, {170, 0}, {181, 0}, {192, 0}, {203, 0}, {213, 0}, {224, 0},
+ {0,14}, {11,14}, {21,14}, {32,14}, {42,14}, {53,14}, {63,14}, {74,14}, { 84,14}, { 95,14}, {106,14}, {116,14}, {127,14}, {143,14}, {160,14}, {170,14}, {181,14}, {192,14}, {203,14}, {213,14}, {224,14},
+ {3,26}, {16,26}, {26,26}, {37,26}, {48,26}, {58,26}, {69,26}, {79,26}, { 90,26}, {100,26}, {111,26}, {121,26}, {132,26}, {145,32}, {160,26}, {170,26}, {181,26}, {192,26}, {203,26}, {213,26}, {224,33},
+ {4,39}, {19,39}, {29,39}, {40,39}, {50,39}, {61,39}, {71,39}, {82,39}, { 92,39}, {103,39}, {114,39}, {124,39}, {134,39}, {192,39}, {203,39}, {213,39},
+ {4,51}, {12,39}, {24,51}, {34,51}, {45,51}, {55,51}, {66,51}, {77,51}, { 87,51}, { 98,51}, {108,51}, {119,51}, {139,51}, {170,51}, {192,51}, {203,51}, {213,51}, {224,58},
+ {1,64}, {15,64}, {28,64}, {67,64}, {107,64}, {120,64}, {133,64}, {147,64}, {160,64}, {170,64}, {181,64}, {198,64}, {213,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k5_max/iso/rgb/rules.mk b/keyboards/keychron/k5_max/iso/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k5_max/iso/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k5_max/iso/white/config.h b/keyboards/keychron/k5_max/iso/white/config.h
new file mode 100644
index 0000000000..0090003a24
--- /dev/null
+++ b/keyboards/keychron/k5_max/iso/white/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 109
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 8 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_8_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define LOW_BAT_IND_INDEX \
+ { 99 }
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k5_max/iso/white/keyboard.json b/keyboards/keychron/k5_max/iso/white/keyboard.json
new file mode 100644
index 0000000000..ec3b99c11e
--- /dev/null
+++ b/keyboards/keychron/k5_max/iso/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A54",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k5_max/iso/white/keymaps/default/keymap.c b/keyboards/keychron/k5_max/iso/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..99c1055ba3
--- /dev/null
+++ b/keyboards/keychron/k5_max/iso/white/keymaps/default/keymap.c
@@ -0,0 +1,68 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_108_ansi(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, BL_STEP, KC_F13, KC_F14, KC_F15, KC_F16,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [MAC_FN] = LAYOUT_108_ansi(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_108_ansi(
+ 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_CTANA, BL_STEP, _______, _______, _______, _______,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [WIN_FN] = LAYOUT_108_ansi(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k5_max/iso/white/rules.mk b/keyboards/keychron/k5_max/iso/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k5_max/iso/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k5_max/iso/white/white.c b/keyboards/keychron/k5_max/iso/white/white.c
new file mode 100644
index 0000000000..b733e874df
--- /dev/null
+++ b/keyboards/keychron/k5_max/iso/white/white.c
@@ -0,0 +1,173 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB6_CA1},
+ {0, CB6_CA2},
+ {0, CB6_CA3},
+ {0, CB6_CA4},
+ {0, CB6_CA5},
+ {0, CB6_CA6},
+ {0, CB6_CA7},
+ {0, CB6_CA8},
+ {0, CB6_CA9},
+ {0, CB6_CA10},
+ {0, CB6_CA11},
+ {0, CB6_CA12},
+ {0, CB6_CA13},
+ {0, CB6_CA15},
+ {0, CB6_CA16},
+ {0, CB6_CA14},
+ {0, CB8_CA7},
+ {0, CB8_CA8},
+ {0, CB8_CA9},
+ {0, CB8_CA10},
+
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+ {0, CB7_CA7},
+ {0, CB7_CA8},
+ {0, CB7_CA9},
+ {0, CB7_CA10},
+ {0, CB7_CA11},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA15},
+ {0, CB4_CA16},
+ {0, CB7_CA12},
+ {0, CB7_CA13},
+ {0, CB7_CA14},
+ {0, CB7_CA15},
+ {0, CB7_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+ {0, CB3_CA13},
+ {0, CB3_CA15},
+ {0, CB3_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+ {0, CB2_CA13},
+ {0, CB8_CA11},
+ {0, CB8_CA12},
+ {0, CB8_CA13},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA7},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+ {0, CB8_CA14},
+ {0, CB8_CA15},
+ {0, CB8_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, 14, 15, 16, 17, 18, 19 },
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40 },
+ { 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61 },
+ { 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, 74, __, __, __, 75, 76, 77, __ },
+ { 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, __, 90, __, 91, __, 92, 93, 94, 95 },
+ { 96, 97, 98, __, __, __, 99, __, __, __, 100, 101, 102, 103, 104, 105, 106, 107, __, 108, __ },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {21, 0}, {32, 0}, {42, 0}, {53, 0}, {69, 0}, {79, 0}, {90, 0}, {100, 0}, {116, 0}, {127, 0}, {137, 0}, {148, 0}, {160, 0}, {170, 0}, {181, 0}, {192, 0}, {203, 0}, {213, 0}, {224, 0},
+ {0,14}, {11,14}, {21,14}, {32,14}, {42,14}, {53,14}, {63,14}, {74,14}, { 84,14}, { 95,14}, {106,14}, {116,14}, {127,14}, {143,14}, {160,14}, {170,14}, {181,14}, {192,14}, {203,14}, {213,14}, {224,14},
+ {3,26}, {16,26}, {26,26}, {37,26}, {48,26}, {58,26}, {69,26}, {79,26}, { 90,26}, {100,26}, {111,26}, {121,26}, {132,26}, {145,32}, {160,26}, {170,26}, {181,26}, {192,26}, {203,26}, {213,26}, {224,33},
+ {4,39}, {19,39}, {29,39}, {40,39}, {50,39}, {61,39}, {71,39}, {82,39}, { 92,39}, {103,39}, {114,39}, {124,39}, {134,39}, {192,39}, {203,39}, {213,39},
+ {4,51}, {12,39}, {24,51}, {34,51}, {45,51}, {55,51}, {66,51}, {77,51}, { 87,51}, { 98,51}, {108,51}, {119,51}, {139,51}, {170,51}, {192,51}, {203,51}, {213,51}, {224,58},
+ {1,64}, {15,64}, {28,64}, {67,64}, {107,64}, {120,64}, {133,64}, {147,64}, {160,64}, {170,64}, {181,64}, {198,64}, {213,64},
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k5_max/k5_max.c b/keyboards/keychron/k5_max/k5_max.c
new file mode 100644
index 0000000000..727a314e98
--- /dev/null
+++ b/keyboards/keychron/k5_max/k5_max.c
@@ -0,0 +1,100 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "transport.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef LK_WIRELESS_ENABLE
+pin_t bt_led_pins[] = BT_INDICATION_LED_PIN_LIST;
+pin_t p24g_led_pins[] = P24G_INDICATION_LED_PIN_LIST;
+#endif
+
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 2));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+ if (!host_keyboard_led_state().caps_lock) gpio_write_pin(LED_CAPS_LOCK_PIN, !LED_PIN_ON_STATE);
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+ for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(bt_led_pins[i], 1);
+ for (uint8_t i = 0; i < sizeof(p24g_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(p24g_led_pins[i], 1);
+#endif
+
+ } else {
+ gpio_write_pin(LED_CAPS_LOCK_PIN, LED_PIN_ON_STATE);
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+ if (get_transport() != TRANSPORT_P2P4)
+ for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(bt_led_pins[i], 0);
+ if (get_transport() != TRANSPORT_BLUETOOTH)
+ for (uint8_t i = 0; i < sizeof(p24g_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(p24g_led_pins[i], 0);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/k5_max/mcuconf.h b/keyboards/keychron/k5_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/k5_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/k5_max/readme.md b/keyboards/keychron/k5_max/readme.md
new file mode 100644
index 0000000000..b5918289a0
--- /dev/null
+++ b/keyboards/keychron/k5_max/readme.md
@@ -0,0 +1,23 @@
+# Keychron K5 Max
+
+
+
+A customizable 84 keys 100% fullsize keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron K5 Max
+* Hardware Availability: [Keychron K5 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-k5-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/k5_max/ansi/rgb:default
+ make keychron/k5_max/ansi/white:default
+
+Flashing example for this keyboard:
+
+ make keychron/k5_max/ansi/rgb:default:flash
+ make keychron/k5_max/ansi/white:default:flash
+
+**Reset Key**: Disconnect the USB cable, toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar, then connect the USB cable.
+
+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).
diff --git a/keyboards/keychron/k5_max/rules.mk b/keyboards/keychron/k5_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/k5_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/k5_max/via_json/k5_max_ansi_rgb.json b/keyboards/keychron/k5_max/via_json/k5_max_ansi_rgb.json
new file mode 100644
index 0000000000..ea914fbd76
--- /dev/null
+++ b/keyboards/keychron/k5_max/via_json/k5_max_ansi_rgb.json
@@ -0,0 +1,342 @@
+{
+ "name": "Keychron K5 Max ANSI RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A50",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 21},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 17",
+ "0, 18",
+ "0, 19",
+ "0, 20"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "1, 17",
+ "1, 18",
+ "1, 19",
+ "1, 20"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "2, 17",
+ "2, 18",
+ "2, 19",
+ {
+ "h": 2
+ },
+ "2, 20"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 13",
+ {
+ "x": 3.5,
+ "c": "#cccccc"
+ },
+ "3, 17",
+ "3, 18",
+ "3, 19"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "x": 1.25,
+ "c": "#cccccc"
+ },
+ "4, 15",
+ {
+ "x": 1.25
+ },
+ "4, 17",
+ "4, 18",
+ "4, 19",
+ {
+ "h": 2
+ },
+ "4, 20"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16",
+ {
+ "x": 0.25,
+ "w": 2
+ },
+ "5, 17",
+ "5, 19"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k5_max/via_json/k5_max_ansi_white.json b/keyboards/keychron/k5_max/via_json/k5_max_ansi_white.json
new file mode 100644
index 0000000000..e1f8f410f7
--- /dev/null
+++ b/keyboards/keychron/k5_max/via_json/k5_max_ansi_white.json
@@ -0,0 +1,281 @@
+{
+ "name": "Keychron K5 Max ANSI White",
+ "vendorId": "0x3434",
+ "productId": "0x0A53",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 21},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 17",
+ "0, 18",
+ "0, 19",
+ "0, 20"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "1, 17",
+ "1, 18",
+ "1, 19",
+ "1, 20"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "2, 17",
+ "2, 18",
+ "2, 19",
+ {
+ "h": 2
+ },
+ "2, 20"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 13",
+ {
+ "x": 3.5,
+ "c": "#cccccc"
+ },
+ "3, 17",
+ "3, 18",
+ "3, 19"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "x": 1.25,
+ "c": "#cccccc"
+ },
+ "4, 15",
+ {
+ "x": 1.25
+ },
+ "4, 17",
+ "4, 18",
+ "4, 19",
+ {
+ "h": 2
+ },
+ "4, 20"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16",
+ {
+ "x": 0.25,
+ "w": 2
+ },
+ "5, 17",
+ "5, 19"
+ ]
+ ]
+ }
+ }
\ No newline at end of file
diff --git a/keyboards/keychron/k7_max/ansi/rgb/config.h b/keyboards/keychron/k7_max/ansi/rgb/config.h
new file mode 100644
index 0000000000..e90bc31b76
--- /dev/null
+++ b/keyboards/keychron/k7_max/ansi/rgb/config.h
@@ -0,0 +1,50 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 68
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 30
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 16, 17, 18 }
+# define P24G_INDICATION_LED_MATRIX_INDEX 19
+# define LOW_BAT_IND_INDEX \
+ { 61 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+#endif
diff --git a/keyboards/keychron/k7_max/ansi/rgb/keyboard.json b/keyboards/keychron/k7_max/ansi/rgb/keyboard.json
new file mode 100644
index 0000000000..69b6943f69
--- /dev/null
+++ b/keyboards/keychron/k7_max/ansi/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A70",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k7_max/ansi/rgb/keymaps/default/keymap.c b/keyboards/keychron/k7_max/ansi/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..398675ab01
--- /dev/null
+++ b/keyboards/keychron/k7_max/ansi/rgb/keymaps/default/keymap.c
@@ -0,0 +1,72 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_ansi_68(
+ KC_ESC, 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_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_HOME,
+ 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_PGUP,
+ 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_PGDN,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN1),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_BASE] = LAYOUT_ansi_68(
+ KC_ESC, 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_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_HOME,
+ 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_PGUP,
+ 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_PGDN,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN1),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN1] = LAYOUT_ansi_68(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_FN1] = LAYOUT_ansi_68(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[FN2] = LAYOUT_ansi_68(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k7_max/ansi/rgb/rgb.c b/keyboards/keychron/k7_max/ansi/rgb/rgb.c
new file mode 100644
index 0000000000..4a5c425532
--- /dev/null
+++ b/keyboards/keychron/k7_max/ansi/rgb/rgb.c
@@ -0,0 +1,130 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, __, 29 },
+ { 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, __, 42, __, 43 },
+ { 44, __, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, __, 55, 56, 57 },
+ { 58, 59, 60, __, __, __, 61, __, __, __, 62, 63, 64, 65, 66, 67 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {30, 0}, {45, 0}, {60, 0}, {75, 0}, { 90, 0}, {105, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {202, 0}, {224, 0},
+ {4,16}, {22,16}, {37,16}, {52,16}, {67,16}, {82,16}, { 97,16}, {112,16}, {127,16}, {142,16}, {157,16}, {172,16}, {187,16}, {205,16}, {224,16},
+ {6,32}, {26,32}, {41,32}, {56,32}, {71,32}, {86,32}, {101,32}, {116,32}, {131,32}, {146,32}, {161,32}, {175,32}, {200,32}, {224,32},
+ {9,48}, {34,48}, {49,48}, {64,48}, {78,48}, { 93,48}, {108,48}, {123,48}, {138,48}, {153,48}, {168,48}, {189,48}, {209,48}, {224,48},
+ {2,64}, {21,64}, {39,64}, { 95,64}, {149,64}, {164,64}, {179,64}, {194,64}, {209,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k7_max/ansi/rgb/rules.mk b/keyboards/keychron/k7_max/ansi/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k7_max/ansi/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k7_max/ansi/white/config.h b/keyboards/keychron/k7_max/ansi/white/config.h
new file mode 100644
index 0000000000..33f7eb0832
--- /dev/null
+++ b/keyboards/keychron/k7_max/ansi/white/config.h
@@ -0,0 +1,50 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 68
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 30
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 16, 17, 18 }
+# define P24G_INDICATION_LED_MATRIX_INDEX 19
+# define LOW_BAT_IND_INDEX \
+ { 61 }
+
+# define LED_MATRIX_VAL_STEP 16
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k7_max/ansi/white/keyboard.json b/keyboards/keychron/k7_max/ansi/white/keyboard.json
new file mode 100644
index 0000000000..211aa6d92a
--- /dev/null
+++ b/keyboards/keychron/k7_max/ansi/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A73",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k7_max/ansi/white/keymaps/default/keymap.c b/keyboards/keychron/k7_max/ansi/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..d1b7115e16
--- /dev/null
+++ b/keyboards/keychron/k7_max/ansi/white/keymaps/default/keymap.c
@@ -0,0 +1,72 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_ansi_68(
+ KC_ESC, 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_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_HOME,
+ 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_PGUP,
+ 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_PGDN,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN1),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_BASE] = LAYOUT_ansi_68(
+ KC_ESC, 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_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_HOME,
+ 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_PGUP,
+ 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_PGDN,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN1),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN1] = LAYOUT_ansi_68(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_FN1] = LAYOUT_ansi_68(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[FN2] = LAYOUT_ansi_68(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k7_max/ansi/white/rules.mk b/keyboards/keychron/k7_max/ansi/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k7_max/ansi/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k7_max/ansi/white/white.c b/keyboards/keychron/k7_max/ansi/white/white.c
new file mode 100644
index 0000000000..b1390176f5
--- /dev/null
+++ b/keyboards/keychron/k7_max/ansi/white/white.c
@@ -0,0 +1,128 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA16},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA7},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, __, 29 },
+ { 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, __, 42, __, 43 },
+ { 44, __, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, __, 55, 56, 57 },
+ { 58, 59, 60, __, __, __, 61, __, __, __, 62, 63, 64, 65, 66, 67 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {30, 0}, {45, 0}, {60, 0}, {75, 0}, { 90, 0}, {105, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {202, 0}, {224, 0},
+ {4,16}, {22,16}, {37,16}, {52,16}, {67,16}, {82,16}, { 97,16}, {112,16}, {127,16}, {142,16}, {157,16}, {172,16}, {187,16}, {205,16}, {224,16},
+ {6,32}, {26,32}, {41,32}, {56,32}, {71,32}, {86,32}, {101,32}, {116,32}, {131,32}, {146,32}, {161,32}, {175,32}, {200,32}, {224,32},
+ {9,48}, {34,48}, {49,48}, {64,48}, {78,48}, { 93,48}, {108,48}, {123,48}, {138,48}, {153,48}, {168,48}, {189,48}, {209,48}, {224,48},
+ {2,64}, {21,64}, {39,64}, { 95,64}, {149,64}, {164,64}, {179,64}, {194,64}, {209,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k7_max/board.h b/keyboards/keychron/k7_max/board.h
new file mode 100644
index 0000000000..b2c7a8f271
--- /dev/null
+++ b/keyboards/keychron/k7_max/board.h
@@ -0,0 +1,225 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
diff --git a/keyboards/keychron/k7_max/config.h b/keyboards/keychron/k7_max/config.h
new file mode 100644
index 0000000000..d78633d6db
--- /dev/null
+++ b/keyboards/keychron/k7_max/config.h
@@ -0,0 +1,72 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define BAT_LEVEL_LED_LIST \
+ { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_3 MO(4)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/k7_max/halconf.h b/keyboards/keychron/k7_max/halconf.h
new file mode 100644
index 0000000000..4b823aa657
--- /dev/null
+++ b/keyboards/keychron/k7_max/halconf.h
@@ -0,0 +1,28 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/k7_max/info.json b/keyboards/keychron/k7_max/info.json
new file mode 100644
index 0000000000..fb9fa181ef
--- /dev/null
+++ b/keyboards/keychron/k7_max/info.json
@@ -0,0 +1,277 @@
+{
+ "keyboard_name": "Keychron K7 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey": true,
+ "mousekey": true,
+ "dip_switch": true,
+ "nkro": true,
+ "raw": true,
+ "send_string": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch": {
+ "pins": ["B14"]
+ },
+ "indicators": {
+ "caps_lock": "A13",
+ "on_state": 1
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "dynamic_keymap": {
+ "layer_count": 5
+ },
+ "layouts": {
+ "LAYOUT_ansi_68": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6, "y": 0},
+ {"matrix": [0, 7], "x": 7, "y": 0},
+ {"matrix": [0, 8], "x": 8, "y": 0},
+ {"matrix": [0, 9], "x": 9, "y": 0},
+ {"matrix": [0, 10], "x": 10, "y": 0},
+ {"matrix": [0, 11], "x": 11, "y": 0},
+ {"matrix": [0, 12], "x": 12, "y": 0},
+ {"matrix": [0, 13], "x": 13, "y": 0, "w": 2},
+ {"matrix": [0, 15], "x": 15, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
+ {"matrix": [1, 1], "x": 1.5, "y": 1},
+ {"matrix": [1, 2], "x": 2.5, "y": 1},
+ {"matrix": [1, 3], "x": 3.5, "y": 1},
+ {"matrix": [1, 4], "x": 4.5, "y": 1},
+ {"matrix": [1, 5], "x": 5.5, "y": 1},
+ {"matrix": [1, 6], "x": 6.5, "y": 1},
+ {"matrix": [1, 7], "x": 7.5, "y": 1},
+ {"matrix": [1, 8], "x": 8.5, "y": 1},
+ {"matrix": [1, 9], "x": 9.5, "y": 1},
+ {"matrix": [1, 10], "x": 10.5, "y": 1},
+ {"matrix": [1, 11], "x": 11.5, "y": 1},
+ {"matrix": [1, 12], "x": 12.5, "y": 1},
+ {"matrix": [1, 13], "x": 13.5, "y": 1, "w": 1.5},
+ {"matrix": [1, 15], "x": 15, "y": 1},
+
+ {"matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
+ {"matrix": [2, 1], "x": 1.75, "y": 2},
+ {"matrix": [2, 2], "x": 2.75, "y": 2},
+ {"matrix": [2, 3], "x": 3.75, "y": 2},
+ {"matrix": [2, 4], "x": 4.75, "y": 2},
+ {"matrix": [2, 5], "x": 5.75, "y": 2},
+ {"matrix": [2, 6], "x": 6.75, "y": 2},
+ {"matrix": [2, 7], "x": 7.75, "y": 2},
+ {"matrix": [2, 8], "x": 8.75, "y": 2},
+ {"matrix": [2, 9], "x": 9.75, "y": 2},
+ {"matrix": [2, 10], "x": 10.75, "y": 2},
+ {"matrix": [2, 11], "x": 11.75, "y": 2},
+ {"matrix": [2, 13], "x": 12.75, "y": 2, "w": 2.25},
+ {"matrix": [2, 15], "x": 15, "y": 2},
+
+ {"matrix": [3, 0], "x": 0, "y": 3, "w": 2.25},
+ {"matrix": [3, 2], "x": 2.25, "y": 3},
+ {"matrix": [3, 3], "x": 3.25, "y": 3},
+ {"matrix": [3, 4], "x": 4.25, "y": 3},
+ {"matrix": [3, 5], "x": 5.25, "y": 3},
+ {"matrix": [3, 6], "x": 6.25, "y": 3},
+ {"matrix": [3, 7], "x": 7.25, "y": 3},
+ {"matrix": [3, 8], "x": 8.25, "y": 3},
+ {"matrix": [3, 9], "x": 9.25, "y": 3},
+ {"matrix": [3, 10], "x": 10.25, "y": 3},
+ {"matrix": [3, 11], "x": 11.25, "y": 3},
+ {"matrix": [3, 13], "x": 12.25, "y": 3, "w": 1.75},
+ {"matrix": [3, 14], "x": 14, "y": 3},
+ {"matrix": [3, 15], "x": 15, "y": 3},
+
+ {"matrix": [4, 0], "x": 0, "y": 4, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4, "w": 1.25},
+ {"matrix": [4, 2], "x": 2.5, "y": 4, "w": 1.25},
+ {"matrix": [4, 6], "x": 3.75, "y": 4, "w": 6.25},
+ {"matrix": [4, 10], "x": 10, "y": 4},
+ {"matrix": [4, 11], "x": 11, "y": 4},
+ {"matrix": [4, 12], "x": 12, "y": 4},
+ {"matrix": [4, 13], "x": 13, "y": 4},
+ {"matrix": [4, 14], "x": 14, "y": 4},
+ {"matrix": [4, 15], "x": 15, "y": 4}
+ ]
+ },
+ "LAYOUT_iso_69": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6, "y": 0},
+ {"matrix": [0, 7], "x": 7, "y": 0},
+ {"matrix": [0, 8], "x": 8, "y": 0},
+ {"matrix": [0, 9], "x": 9, "y": 0},
+ {"matrix": [0, 10], "x": 10, "y": 0},
+ {"matrix": [0, 11], "x": 11, "y": 0},
+ {"matrix": [0, 12], "x": 12, "y": 0},
+ {"matrix": [0, 13], "x": 13, "y": 0, "w": 2},
+ {"matrix": [0, 15], "x": 15, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
+ {"matrix": [1, 1], "x": 1.5, "y": 1},
+ {"matrix": [1, 2], "x": 2.5, "y": 1},
+ {"matrix": [1, 3], "x": 3.5, "y": 1},
+ {"matrix": [1, 4], "x": 4.5, "y": 1},
+ {"matrix": [1, 5], "x": 5.5, "y": 1},
+ {"matrix": [1, 6], "x": 6.5, "y": 1},
+ {"matrix": [1, 7], "x": 7.5, "y": 1},
+ {"matrix": [1, 8], "x": 8.5, "y": 1},
+ {"matrix": [1, 9], "x": 9.5, "y": 1},
+ {"matrix": [1, 10], "x": 10.5, "y": 1},
+ {"matrix": [1, 11], "x": 11.5, "y": 1},
+ {"matrix": [1, 12], "x": 12.5, "y": 1},
+ {"matrix": [1, 15], "x": 15, "y": 1},
+
+ {"matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
+ {"matrix": [2, 1], "x": 1.75, "y": 2},
+ {"matrix": [2, 2], "x": 2.75, "y": 2},
+ {"matrix": [2, 3], "x": 3.75, "y": 2},
+ {"matrix": [2, 4], "x": 4.75, "y": 2},
+ {"matrix": [2, 5], "x": 5.75, "y": 2},
+ {"matrix": [2, 6], "x": 6.75, "y": 2},
+ {"matrix": [2, 7], "x": 7.75, "y": 2},
+ {"matrix": [2, 8], "x": 8.75, "y": 2},
+ {"matrix": [2, 9], "x": 9.75, "y": 2},
+ {"matrix": [2, 10], "x": 10.75, "y": 2},
+ {"matrix": [2, 11], "x": 11.75, "y": 2},
+ {"matrix": [2, 13], "x": 12.75, "y": 2},
+ {"matrix": [1, 13], "x": 13.75, "y": 1, "w": 1.25, "h": 2},
+ {"matrix": [2, 15], "x": 15, "y": 2},
+
+ {"matrix": [3, 0], "x": 0, "y": 3, "w": 1.25},
+ {"matrix": [3, 1], "x": 1.25, "y": 3},
+ {"matrix": [3, 2], "x": 2.25, "y": 3},
+ {"matrix": [3, 3], "x": 3.25, "y": 3},
+ {"matrix": [3, 4], "x": 4.25, "y": 3},
+ {"matrix": [3, 5], "x": 5.25, "y": 3},
+ {"matrix": [3, 6], "x": 6.25, "y": 3},
+ {"matrix": [3, 7], "x": 7.25, "y": 3},
+ {"matrix": [3, 8], "x": 8.25, "y": 3},
+ {"matrix": [3, 9], "x": 9.25, "y": 3},
+ {"matrix": [3, 10], "x": 10.25, "y": 3},
+ {"matrix": [3, 11], "x": 11.25, "y": 3},
+ {"matrix": [3, 13], "x": 12.25, "y": 3, "w": 1.75},
+ {"matrix": [3, 14], "x": 14, "y": 3},
+ {"matrix": [3, 15], "x": 15, "y": 3},
+
+ {"matrix": [4, 0], "x": 0, "y": 4, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4, "w": 1.25},
+ {"matrix": [4, 2], "x": 2.5, "y": 4, "w": 1.25},
+ {"matrix": [4, 6], "x": 3.75, "y": 4, "w": 6.25},
+ {"matrix": [4, 10], "x": 10, "y": 4},
+ {"matrix": [4, 11], "x": 11, "y": 4},
+ {"matrix": [4, 12], "x": 12, "y": 4},
+ {"matrix": [4, 13], "x": 13, "y": 4},
+ {"matrix": [4, 14], "x": 14, "y": 4},
+ {"matrix": [4, 15], "x": 15, "y": 4}
+ ]
+ },
+ "LAYOUT_jis_71": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6, "y": 0},
+ {"matrix": [0, 7], "x": 7, "y": 0},
+ {"matrix": [0, 8], "x": 8, "y": 0},
+ {"matrix": [0, 9], "x": 9, "y": 0},
+ {"matrix": [0, 10], "x": 10, "y": 0},
+ {"matrix": [0, 11], "x": 11, "y": 0},
+ {"matrix": [0, 12], "x": 12, "y": 0},
+ {"matrix": [0, 13], "x": 13, "y": 0},
+ {"matrix": [0, 14], "x": 14, "y": 0},
+ {"matrix": [0, 15], "x": 15, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
+ {"matrix": [1, 1], "x": 1.5, "y": 1},
+ {"matrix": [1, 2], "x": 2.5, "y": 1},
+ {"matrix": [1, 3], "x": 3.5, "y": 1},
+ {"matrix": [1, 4], "x": 4.5, "y": 1},
+ {"matrix": [1, 5], "x": 5.5, "y": 1},
+ {"matrix": [1, 6], "x": 6.5, "y": 1},
+ {"matrix": [1, 7], "x": 7.5, "y": 1},
+ {"matrix": [1, 8], "x": 8.5, "y": 1},
+ {"matrix": [1, 9], "x": 9.5, "y": 1},
+ {"matrix": [1, 10], "x": 10.5, "y": 1},
+ {"matrix": [1, 11], "x": 11.5, "y": 1},
+ {"matrix": [1, 12], "x": 12.5, "y": 1},
+ {"matrix": [1, 15], "x": 15, "y": 1},
+
+ {"matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
+ {"matrix": [2, 1], "x": 1.75, "y": 2},
+ {"matrix": [2, 2], "x": 2.75, "y": 2},
+ {"matrix": [2, 3], "x": 3.75, "y": 2},
+ {"matrix": [2, 4], "x": 4.75, "y": 2},
+ {"matrix": [2, 5], "x": 5.75, "y": 2},
+ {"matrix": [2, 6], "x": 6.75, "y": 2},
+ {"matrix": [2, 7], "x": 7.75, "y": 2},
+ {"matrix": [2, 8], "x": 8.75, "y": 2},
+ {"matrix": [2, 9], "x": 9.75, "y": 2},
+ {"matrix": [2, 10], "x": 10.75, "y": 2},
+ {"matrix": [2, 11], "x": 11.75, "y": 2},
+ {"matrix": [2, 13], "x": 12.75, "y": 2},
+ {"matrix": [1, 13], "x": 13.75, "y": 1, "w": 1.25, "h": 2},
+ {"matrix": [2, 15], "x": 15, "y": 2},
+
+ {"matrix": [3, 0], "x": 0, "y": 3, "w": 2.25},
+ {"matrix": [3, 2], "x": 2.25, "y": 3},
+ {"matrix": [3, 3], "x": 3.25, "y": 3},
+ {"matrix": [3, 4], "x": 4.25, "y": 3},
+ {"matrix": [3, 5], "x": 5.25, "y": 3},
+ {"matrix": [3, 6], "x": 6.25, "y": 3},
+ {"matrix": [3, 7], "x": 7.25, "y": 3},
+ {"matrix": [3, 8], "x": 8.25, "y": 3},
+ {"matrix": [3, 9], "x": 9.25, "y": 3},
+ {"matrix": [3, 10], "x": 10.25, "y": 3},
+ {"matrix": [3, 11], "x": 11.25, "y": 3},
+ {"matrix": [3, 12], "x": 12.25, "y": 3},
+ {"matrix": [3, 13], "x": 13.25, "y": 3, "w": 1.75},
+ {"matrix": [3, 15], "x": 15, "y": 3},
+
+ {"matrix": [4, 0], "x": 0, "y": 4},
+ {"matrix": [4, 1], "x": 1, "y": 4},
+ {"matrix": [4, 2], "x": 2, "y": 4},
+ {"matrix": [4, 3], "x": 3, "y": 4},
+ {"matrix": [4, 6], "x": 4, "y": 4, "w": 5},
+ {"matrix": [4, 9], "x": 9, "y": 4},
+ {"matrix": [4, 10], "x": 10, "y": 4},
+ {"matrix": [4, 11], "x": 11, "y": 4},
+ {"matrix": [4, 12], "x": 12, "y": 4},
+ {"matrix": [4, 13], "x": 13, "y": 4},
+ {"matrix": [4, 14], "x": 14, "y": 4},
+ {"matrix": [4, 15], "x": 15, "y": 4}
+ ]
+ }
+ }
+
+}
diff --git a/keyboards/keychron/k7_max/iso/rgb/config.h b/keyboards/keychron/k7_max/iso/rgb/config.h
new file mode 100644
index 0000000000..c6bf9c6cc9
--- /dev/null
+++ b/keyboards/keychron/k7_max/iso/rgb/config.h
@@ -0,0 +1,52 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 69
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 30
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 16, 17, 18 }
+# define P24G_INDICATION_LED_MATRIX_INDEX 19
+# define LOW_BAT_IND_INDEX \
+ { 62 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/k7_max/iso/rgb/keyboard.json b/keyboards/keychron/k7_max/iso/rgb/keyboard.json
new file mode 100644
index 0000000000..314f6be806
--- /dev/null
+++ b/keyboards/keychron/k7_max/iso/rgb/keyboard.json
@@ -0,0 +1,37 @@
+{
+ "usb": {
+ "pid": "0x0A71",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
+
diff --git a/keyboards/keychron/k7_max/iso/rgb/keymaps/default/keymap.c b/keyboards/keychron/k7_max/iso/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..79db340131
--- /dev/null
+++ b/keyboards/keychron/k7_max/iso/rgb/keymaps/default/keymap.c
@@ -0,0 +1,72 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_iso_69(
+ KC_ESC, 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_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_HOME,
+ 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_PGUP,
+ 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_PGDN,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN1),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_BASE] = LAYOUT_iso_69(
+ KC_ESC, 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_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_HOME,
+ 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_PGUP,
+ 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_PGDN,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN1),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN1] = LAYOUT_iso_69(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_FN1] = LAYOUT_iso_69(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[FN2] = LAYOUT_iso_69(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k7_max/iso/rgb/rgb.c b/keyboards/keychron/k7_max/iso/rgb/rgb.c
new file mode 100644
index 0000000000..a58519ecd0
--- /dev/null
+++ b/keyboards/keychron/k7_max/iso/rgb/rgb.c
@@ -0,0 +1,131 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA2, CB1_CA2, CB2_CA2},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, __, 29 },
+ { 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, __, 42, __, 43 },
+ { 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, __, 56, 57, 58 },
+ { 59, 60, 61, __, __, __, 62, __, __, __, 63, 64, 65, 66, 67, 68 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {30, 0}, {45, 0}, {60, 0}, {75, 0}, { 90, 0}, {105, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {202, 0}, {224, 0},
+ {4,16}, {22,16}, {37,16}, {52,16}, {67,16}, {82,16}, { 97,16}, {112,16}, {127,16}, {142,16}, {157,16}, {172,16}, {187,16}, {207,24}, {224,16},
+ {6,32}, {26,32}, {41,32}, {56,32}, {71,32}, {86,32}, {101,32}, {116,32}, {131,32}, {146,32}, {161,32}, {175,32}, {190,32}, {224,32},
+ {2,48}, {19,48}, {34,48}, {49,48}, {64,48}, {78,48}, { 93,48}, {108,48}, {123,48}, {138,48}, {153,48}, {168,48}, {189,48}, {209,48}, {224,48},
+ {2,64}, {21,64}, {39,64}, { 95,64}, {149,64}, {164,64}, {179,64}, {194,64}, {209,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k7_max/iso/rgb/rules.mk b/keyboards/keychron/k7_max/iso/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k7_max/iso/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k7_max/iso/white/config.h b/keyboards/keychron/k7_max/iso/white/config.h
new file mode 100644
index 0000000000..ab76e9d543
--- /dev/null
+++ b/keyboards/keychron/k7_max/iso/white/config.h
@@ -0,0 +1,50 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 69
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 30
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 16, 17, 18 }
+# define P24G_INDICATION_LED_MATRIX_INDEX 19
+# define LOW_BAT_IND_INDEX \
+ { 62 }
+
+# define LED_MATRIX_VAL_STEP 16
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k7_max/iso/white/keyboard.json b/keyboards/keychron/k7_max/iso/white/keyboard.json
new file mode 100644
index 0000000000..0ce26cd49a
--- /dev/null
+++ b/keyboards/keychron/k7_max/iso/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A74",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k7_max/iso/white/keymaps/default/keymap.c b/keyboards/keychron/k7_max/iso/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..aff9efbcc1
--- /dev/null
+++ b/keyboards/keychron/k7_max/iso/white/keymaps/default/keymap.c
@@ -0,0 +1,72 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_iso_69(
+ KC_ESC, 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_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_HOME,
+ 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_PGUP,
+ 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_PGDN,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN1),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_BASE] = LAYOUT_iso_69(
+ KC_ESC, 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_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_HOME,
+ 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_PGUP,
+ 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_PGDN,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN1),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN1] = LAYOUT_iso_69(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, BL_DOWN, _______, _______, _______, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_FN1] = LAYOUT_iso_69(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, BL_DOWN, _______, _______, _______, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[FN2] = LAYOUT_iso_69(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k7_max/iso/white/rules.mk b/keyboards/keychron/k7_max/iso/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k7_max/iso/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k7_max/iso/white/white.c b/keyboards/keychron/k7_max/iso/white/white.c
new file mode 100644
index 0000000000..00ef60b028
--- /dev/null
+++ b/keyboards/keychron/k7_max/iso/white/white.c
@@ -0,0 +1,129 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA16},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA2},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA13},
+ {0, CB2_CA14},
+ {0, CB2_CA16},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA7},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, __, 29 },
+ { 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, __, 42, __, 43 },
+ { 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, __, 56, 57, 58 },
+ { 59, 60, 61, __, __, __, 62, __, __, __, 63, 64, 65, 66, 67, 68 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {30, 0}, {45, 0}, {60, 0}, {75, 0}, { 90, 0}, {105, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {202, 0}, {224, 0},
+ {4,16}, {22,16}, {37,16}, {52,16}, {67,16}, {82,16}, { 97,16}, {112,16}, {127,16}, {142,16}, {157,16}, {172,16}, {187,16}, {207,24}, {224,16},
+ {6,32}, {26,32}, {41,32}, {56,32}, {71,32}, {86,32}, {101,32}, {116,32}, {131,32}, {146,32}, {161,32}, {175,32}, {190,32}, {224,32},
+ {2,48}, {19,48}, {34,48}, {49,48}, {64,48}, {78,48}, { 93,48}, {108,48}, {123,48}, {138,48}, {153,48}, {168,48}, {189,48}, {209,48}, {224,48},
+ {2,64}, {21,64}, {39,64}, { 95,64}, {149,64}, {164,64}, {179,64}, {194,64}, {209,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k7_max/jis/rgb/config.h b/keyboards/keychron/k7_max/jis/rgb/config.h
new file mode 100644
index 0000000000..3a821e2f4e
--- /dev/null
+++ b/keyboards/keychron/k7_max/jis/rgb/config.h
@@ -0,0 +1,50 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 71
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14, 0x14 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 31
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define LOW_BAT_IND_INDEX \
+ { 63 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+#endif
diff --git a/keyboards/keychron/k7_max/jis/rgb/keyboard.json b/keyboards/keychron/k7_max/jis/rgb/keyboard.json
new file mode 100644
index 0000000000..6f61123b36
--- /dev/null
+++ b/keyboards/keychron/k7_max/jis/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A72",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k7_max/jis/rgb/keymaps/default/keymap.c b/keyboards/keychron/k7_max/jis/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..777754a3ad
--- /dev/null
+++ b/keyboards/keychron/k7_max/jis/rgb/keymaps/default/keymap.c
@@ -0,0 +1,72 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN,
+ WIN_FN,
+ FN2
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_jis_71(
+ KC_ESC, 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_INT3, KC_BSPC, KC_DEL,
+ 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_HOME,
+ 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_BSLS, KC_ENT, KC_PGUP,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_UP, KC_PGDN,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD,MO(MAC_FN),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_BASE] = LAYOUT_jis_71(
+ KC_ESC, 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_INT3, KC_BSPC, KC_DEL,
+ 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_HOME,
+ 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_BSLS, KC_ENT, KC_PGUP,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_UP, KC_PGDN,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, MO(WIN_FN),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN] = LAYOUT_jis_71(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_FN] = LAYOUT_jis_71(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[FN2] = LAYOUT_jis_71(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k7_max/jis/rgb/rgb.c b/keyboards/keychron/k7_max/jis/rgb/rgb.c
new file mode 100644
index 0000000000..aa5e31533c
--- /dev/null
+++ b/keyboards/keychron/k7_max/jis/rgb/rgb.c
@@ -0,0 +1,134 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB6_CA1, CB4_CA1, CB5_CA1},
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA15, CB4_CA15, CB5_CA15},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA9, CB1_CA9, CB2_CA9},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA13, CB1_CA13, CB2_CA13},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA4, CB4_CA4, CB5_CA4},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA10, CB4_CA10, CB5_CA10},
+ {1, CB6_CA11, CB4_CA11, CB5_CA11},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, __, 43, __, 44 },
+ { 45, __, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __, 58 },
+ { 59, 60, 61, 62, __, __, 63, __, __, 64, 65, 66, 67, 68, 69, 70 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {30, 0}, {45, 0}, {60, 0}, {75, 0}, { 90, 0}, {105, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209, 0}, {224, 0},
+ {4,16}, {22,16}, {37,16}, {52,16}, {67,16}, {82,16}, { 97,16}, {112,16}, {127,16}, {142,16}, {157,16}, {172,16}, {187,16}, {205,24}, {224,16},
+ {7,32}, {26,32}, {41,32}, {56,32}, {71,32}, {86,32}, {101,32}, {116,32}, {131,32}, {146,32}, {161,32}, {175,32}, {200,32}, {224,32},
+ {8,48}, {34,48}, {49,48}, {64,48}, {78,48}, { 93,48}, {108,48}, {123,48}, {138,48}, {153,48}, {168,48}, {183,48}, {201,48}, {224,48},
+ {0,64}, {15,64}, {30,64}, {45,64}, { 90,64}, {134,64}, {149,64}, {164,64}, {179,64}, {194,64}, {209,64}, {224,64}
+
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/k7_max/jis/rgb/rules.mk b/keyboards/keychron/k7_max/jis/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k7_max/jis/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k7_max/jis/white/config.h b/keyboards/keychron/k7_max/jis/white/config.h
new file mode 100644
index 0000000000..944cec7621
--- /dev/null
+++ b/keyboards/keychron/k7_max/jis/white/config.h
@@ -0,0 +1,50 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 71
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Use first 6 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_6_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A, 0x2A }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+/* Indications */
+# define DIM_CAPS_LOCK
+# define CAPS_LOCK_INDEX 31
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define LOW_BAT_IND_INDEX \
+ { 63 }
+
+# define LED_MATRIX_VAL_STEP 16
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k7_max/jis/white/keyboard.json b/keyboards/keychron/k7_max/jis/white/keyboard.json
new file mode 100644
index 0000000000..e8d0f82367
--- /dev/null
+++ b/keyboards/keychron/k7_max/jis/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A75",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k7_max/jis/white/keymaps/default/keymap.c b/keyboards/keychron/k7_max/jis/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..09e6b8d720
--- /dev/null
+++ b/keyboards/keychron/k7_max/jis/white/keymaps/default/keymap.c
@@ -0,0 +1,72 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+[MAC_BASE] = LAYOUT_jis_71(
+ KC_ESC, 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_INT3, KC_BSPC, KC_DEL,
+ 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_HOME,
+ 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_BSLS, KC_ENT, KC_PGUP,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_UP, KC_PGDN,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD,MO(MAC_FN1),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+[WIN_BASE] = LAYOUT_jis_71(
+ KC_ESC, 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_INT3, KC_BSPC, KC_DEL,
+ 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_HOME,
+ 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_BSLS, KC_ENT, KC_PGUP,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_UP, KC_PGDN,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, MO(WIN_FN1),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+[MAC_FN1] = LAYOUT_jis_71(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, NK_TOGG, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[WIN_FN1] = LAYOUT_jis_71(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, NK_TOGG, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+[FN2] = LAYOUT_jis_71(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, KC_RSFT, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k7_max/jis/white/rules.mk b/keyboards/keychron/k7_max/jis/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k7_max/jis/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k7_max/jis/white/white.c b/keyboards/keychron/k7_max/jis/white/white.c
new file mode 100644
index 0000000000..765a0b1877
--- /dev/null
+++ b/keyboards/keychron/k7_max/jis/white/white.c
@@ -0,0 +1,132 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB5_CA1},
+ {0, CB5_CA2},
+ {0, CB5_CA3},
+ {0, CB5_CA4},
+ {0, CB5_CA5},
+ {0, CB5_CA6},
+ {0, CB5_CA7},
+ {0, CB5_CA8},
+ {0, CB5_CA9},
+ {0, CB5_CA10},
+ {0, CB5_CA11},
+ {0, CB5_CA12},
+ {0, CB5_CA13},
+ {0, CB5_CA14},
+ {0, CB5_CA15},
+ {0, CB5_CA16},
+
+ {0, CB4_CA1},
+ {0, CB4_CA2},
+ {0, CB4_CA3},
+ {0, CB4_CA4},
+ {0, CB4_CA5},
+ {0, CB4_CA6},
+ {0, CB4_CA7},
+ {0, CB4_CA8},
+ {0, CB4_CA9},
+ {0, CB4_CA10},
+ {0, CB4_CA11},
+ {0, CB4_CA12},
+ {0, CB4_CA13},
+ {0, CB4_CA14},
+ {0, CB4_CA16},
+
+ {0, CB3_CA1},
+ {0, CB3_CA2},
+ {0, CB3_CA3},
+ {0, CB3_CA4},
+ {0, CB3_CA5},
+ {0, CB3_CA6},
+ {0, CB3_CA7},
+ {0, CB3_CA8},
+ {0, CB3_CA9},
+ {0, CB3_CA10},
+ {0, CB3_CA11},
+ {0, CB3_CA12},
+ {0, CB3_CA14},
+ {0, CB3_CA16},
+
+ {0, CB2_CA1},
+ {0, CB2_CA3},
+ {0, CB2_CA4},
+ {0, CB2_CA5},
+ {0, CB2_CA6},
+ {0, CB2_CA7},
+ {0, CB2_CA8},
+ {0, CB2_CA9},
+ {0, CB2_CA10},
+ {0, CB2_CA11},
+ {0, CB2_CA12},
+ {0, CB2_CA14},
+ {0, CB2_CA15},
+ {0, CB2_CA16},
+
+ {0, CB1_CA1},
+ {0, CB1_CA2},
+ {0, CB1_CA3},
+ {0, CB1_CA4},
+ {0, CB1_CA7},
+ {0, CB1_CA10},
+ {0, CB1_CA11},
+ {0, CB1_CA12},
+ {0, CB1_CA13},
+ {0, CB1_CA14},
+ {0, CB1_CA15},
+ {0, CB1_CA16},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, __, 43, __, 44 },
+ { 45, __, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, __, 56, 57, 58 },
+ { 59, 60, 61, 62, __, __, 63, __, __, 64, 65, 66, 67, 68, 69, 70 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {30, 0}, {45, 0}, {60, 0}, {75, 0}, { 90, 0}, {105, 0}, {119, 0}, {134, 0}, {149, 0}, {164, 0}, {179, 0}, {194, 0}, {209, 0}, {224, 0},
+ {4,16}, {22,16}, {37,16}, {52,16}, {67,16}, {82,16}, { 97,16}, {112,16}, {127,16}, {142,16}, {157,16}, {172,16}, {187,16}, {205,24}, {224,16},
+ {7,32}, {26,32}, {41,32}, {56,32}, {71,32}, {86,32}, {101,32}, {116,32}, {131,32}, {146,32}, {161,32}, {175,32}, {200,32}, {224,32},
+ {8,48}, {34,48}, {49,48}, {64,48}, {78,48}, { 93,48}, {108,48}, {123,48}, {138,48}, {153,48}, {168,48}, {183,48}, {201,48}, {224,48},
+ {0,64}, {15,64}, {30,64}, {45,64}, { 90,64}, {134,64}, {149,64}, {164,64}, {179,64}, {194,64}, {209,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+
+};
+#endif
diff --git a/keyboards/keychron/k7_max/k7_max.c b/keyboards/keychron/k7_max/k7_max.c
new file mode 100644
index 0000000000..a00122b083
--- /dev/null
+++ b/keyboards/keychron/k7_max/k7_max.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "transport.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 1));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+
+ } else {
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/k7_max/mcuconf.h b/keyboards/keychron/k7_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/k7_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/k7_max/readme.md b/keyboards/keychron/k7_max/readme.md
new file mode 100644
index 0000000000..fbed911474
--- /dev/null
+++ b/keyboards/keychron/k7_max/readme.md
@@ -0,0 +1,31 @@
+# Keychron K7 Max
+
+
+
+A customizable 65% low profile keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron K7 Max
+* Hardware Availability: [Keychron K7 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-k7-ultra-slim-wireless-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/k7_max/ansi/rgb:default
+ make keychron/k7_max/ansi/white:default
+ make keychron/k7_max/iso/rgb:default
+ make keychron/k7_max/iso/white:default
+ make keychron/k7_max/jis/rgb:default
+ make keychron/k7_max/jis/white:default
+
+Flashing example for this keyboard:
+
+ make keychron/k7_max/ansi/rgb:default:flash
+ make keychron/k7_max/ansi/white:default:flash
+ make keychron/k7_max/iso/rgb:default:flash
+ make keychron/k7_max/iso/white:default:flash
+ make keychron/k7_max/jis/rgb:default:flash
+ make keychron/k7_max/jis/white:default:flash
+
+**Reset Key**: Disconnect the USB cable, toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar, then connect the USB cable.
+
+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).
diff --git a/keyboards/keychron/k7_max/rules.mk b/keyboards/keychron/k7_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/k7_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/k7_max/via_json/k7_max_ansi_rgb_v1.0.json b/keyboards/keychron/k7_max/via_json/k7_max_ansi_rgb_v1.0.json
new file mode 100644
index 0000000000..bfcde4d09f
--- /dev/null
+++ b/keyboards/keychron/k7_max/via_json/k7_max_ansi_rgb_v1.0.json
@@ -0,0 +1,240 @@
+{
+ "name": "Keychron K7 Max ANSI RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A70",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ {
+ "c": "#cccccc"
+ },
+ "3, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "w": 1.25
+ },
+ "4, 1",
+ {
+ "w": 1.25
+ },
+ "4, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "4, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "c": "#cccccc"
+ },
+ "4, 13",
+ "4, 14",
+ "4, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k7_max/via_json/k7_max_ansi_white_v1.0.json b/keyboards/keychron/k7_max/via_json/k7_max_ansi_white_v1.0.json
new file mode 100644
index 0000000000..70de6397ba
--- /dev/null
+++ b/keyboards/keychron/k7_max/via_json/k7_max_ansi_white_v1.0.json
@@ -0,0 +1,179 @@
+{
+ "name": "Keychron K7 Max White ANSI",
+ "vendorId": "0x3434",
+ "productId": "0x0A73",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ {
+ "c": "#cccccc"
+ },
+ "3, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "w": 1.25
+ },
+ "4, 1",
+ {
+ "w": 1.25
+ },
+ "4, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "4, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "c": "#cccccc"
+ },
+ "4, 13",
+ "4, 14",
+ "4, 15"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/k7_max/via_json/k7_max_iso_rgb_v1.0.json b/keyboards/keychron/k7_max/via_json/k7_max_iso_rgb_v1.0.json
new file mode 100644
index 0000000000..9c76d2dc1e
--- /dev/null
+++ b/keyboards/keychron/k7_max/via_json/k7_max_iso_rgb_v1.0.json
@@ -0,0 +1,245 @@
+{
+ "name": "Keychron K7 Max ISO RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A71",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "1, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ {
+ "c": "#cccccc"
+ },
+ "3, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "w": 1.25
+ },
+ "4, 1",
+ {
+ "w": 1.25
+ },
+ "4, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "4, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "c": "#cccccc"
+ },
+ "4, 13",
+ "4, 14",
+ "4, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k7_max/via_json/k7_max_iso_white_v1.0.json b/keyboards/keychron/k7_max/via_json/k7_max_iso_white_v1.0.json
new file mode 100644
index 0000000000..c9082c6dc1
--- /dev/null
+++ b/keyboards/keychron/k7_max/via_json/k7_max_iso_white_v1.0.json
@@ -0,0 +1,184 @@
+{
+ "name": "Keychron K7 Max ISO White",
+ "vendorId": "0x3434",
+ "productId": "0x0A74",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "1, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ {
+ "c": "#cccccc"
+ },
+ "3, 14",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "w": 1.25
+ },
+ "4, 1",
+ {
+ "w": 1.25
+ },
+ "4, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "4, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "c": "#cccccc"
+ },
+ "4, 13",
+ "4, 14",
+ "4, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k7_max/via_json/k7_max_jis_rgb_v1.0.json b/keyboards/keychron/k7_max/via_json/k7_max_jis_rgb_v1.0.json
new file mode 100644
index 0000000000..31ff8c3965
--- /dev/null
+++ b/keyboards/keychron/k7_max/via_json/k7_max_jis_rgb_v1.0.json
@@ -0,0 +1,237 @@
+{
+ "name": "Keychron K7 Max JIS RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A72",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "x": 0.25,
+ "c": "#777777",
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1
+ },
+ "1, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 13",
+ {
+ "x":1.25,
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 12",
+ {
+ "c": "#cccccc",
+ "w": 1.75
+ },
+ "3, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ "4, 1",
+ "4, 2",
+ "4, 3",
+ {
+ "w": 5,
+ "c": "#cccccc"
+ },
+ "4, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "c": "#cccccc"
+ },
+ "4, 13",
+ "4, 14",
+ "4, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k7_max/via_json/k7_max_jis_white_v1.0.json b/keyboards/keychron/k7_max/via_json/k7_max_jis_white_v1.0.json
new file mode 100644
index 0000000000..9caf6707fc
--- /dev/null
+++ b/keyboards/keychron/k7_max/via_json/k7_max_jis_white_v1.0.json
@@ -0,0 +1,176 @@
+{
+ "name": "Keychron K7 Max JIS White",
+ "vendorId": "0x3434",
+ "productId": "0x0A75",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ "0, 14",
+ "0, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "x": 0.25,
+ "c": "#777777",
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1
+ },
+ "1, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 13",
+ {
+ "x":1.25,
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 12",
+ {
+ "c": "#cccccc",
+ "w": 1.75
+ },
+ "3, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ "4, 1",
+ "4, 2",
+ "4, 3",
+ {
+ "w": 5,
+ "c": "#cccccc"
+ },
+ "4, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "c": "#cccccc"
+ },
+ "4, 13",
+ "4, 14",
+ "4, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/k8_max/ansi/rgb/config.h b/keyboards/keychron/k8_max/ansi/rgb/config.h
new file mode 100644
index 0000000000..a17005bbf0
--- /dev/null
+++ b/keyboards/keychron/k8_max/ansi/rgb/config.h
@@ -0,0 +1,51 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 87
+# define DRIVER_CS_PINS \
+ { A8, C9 }
+
+# ifdef LK_WIRELESS_ENABLE
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+# endif
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+#endif
diff --git a/keyboards/keychron/k8_max/ansi/rgb/keyboard.json b/keyboards/keychron/k8_max/ansi/rgb/keyboard.json
new file mode 100644
index 0000000000..b90f0fe944
--- /dev/null
+++ b/keyboards/keychron/k8_max/ansi/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A80",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k8_max/ansi/rgb/keymaps/default/keymap.c b/keyboards/keychron/k8_max/ansi/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..3e0afc9160
--- /dev/null
+++ b/keyboards/keychron/k8_max/ansi/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_87(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_87(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_87(
+ 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_CTANA, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_87(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k8_max/ansi/rgb/rgb.c b/keyboards/keychron/k8_max/ansi/rgb/rgb.c
new file mode 100644
index 0000000000..4249b267fe
--- /dev/null
+++ b/keyboards/keychron/k8_max/ansi/rgb/rgb.c
@@ -0,0 +1,153 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t PROGMEM g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to RGB Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, __, __, __ },
+ { 63, __, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, 74, __, 75, __ },
+ { 76, 77, 78, __, __, __, 79, __, __, __, 80, 81, 82, 83, 84, 85, 86 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {25, 0}, {38, 0}, {51, 0}, {64, 0}, {84, 0}, { 97, 0}, {110, 0}, {123, 0}, {142, 0}, {155, 0}, {168, 0}, {181, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {12,14}, {25,14}, {38,14}, {51,14}, {64,14}, {77,14}, { 90,14}, {103,14}, {116,14}, {129,14}, {142,14}, {155,14}, {175,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {19,26}, {32,26}, {45,26}, {58,26}, {71,26}, {84,26}, { 97,26}, {110,26}, {123,26}, {136,26}, {149,26}, {162,26}, {178,26}, {198,26}, {211,26}, {224,26},
+ {4,39}, {22,39}, {35,39}, {48,39}, {61,39}, {74,39}, {87,39}, {100,39}, {113,39}, {126,39}, {139,39}, {152,39}, {173,39},
+ {8,51}, {29,51}, {42,51}, {55,51}, {68,51}, {81,51}, { 94,51}, {107,51}, {120,51}, {132,51}, {145,51}, {170,51}, {211,51},
+ {1,64}, {17,64}, {34,64}, {82,64}, {131,64}, {147,64}, {163,64}, {180,64}, {198,64}, {211,64}, {224,64}
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/k8_max/ansi/rgb/rules.mk b/keyboards/keychron/k8_max/ansi/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k8_max/ansi/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k8_max/ansi/white/config.h b/keyboards/keychron/k8_max/ansi/white/config.h
new file mode 100644
index 0000000000..e530bf2d31
--- /dev/null
+++ b/keyboards/keychron/k8_max/ansi/white/config.h
@@ -0,0 +1,53 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 87
+# define DRIVER_CS_PINS \
+ { C9 }
+
+# define LED_MATRIX_VAL_STEP 16
+
+# ifdef LK_WIRELESS_ENABLE
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+# endif
+
+/* Use first 8 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_8_CHANNEL
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k8_max/ansi/white/keyboard.json b/keyboards/keychron/k8_max/ansi/white/keyboard.json
new file mode 100644
index 0000000000..868834f4e2
--- /dev/null
+++ b/keyboards/keychron/k8_max/ansi/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A83",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k8_max/ansi/white/keymaps/default/keymap.c b/keyboards/keychron/k8_max/ansi/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..f7fba5f862
--- /dev/null
+++ b/keyboards/keychron/k8_max/ansi/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_87(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, BL_STEP,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_87(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_87(
+ 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_CTANA, BL_STEP,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_87(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k8_max/ansi/white/rules.mk b/keyboards/keychron/k8_max/ansi/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k8_max/ansi/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k8_max/ansi/white/white.c b/keyboards/keychron/k8_max/ansi/white/white.c
new file mode 100644
index 0000000000..f89be14426
--- /dev/null
+++ b/keyboards/keychron/k8_max/ansi/white/white.c
@@ -0,0 +1,152 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA16},
+ {0, CB1_CA14},
+ {0, CB1_CA13},
+ {0, CB1_CA12},
+ {0, CB1_CA11},
+ {0, CB1_CA10},
+ {0, CB1_CA9},
+ {0, CB1_CA8},
+ {0, CB1_CA7},
+ {0, CB1_CA6},
+ {0, CB1_CA5},
+ {0, CB1_CA4},
+ {0, CB1_CA3},
+ {0, CB1_CA2},
+ {0, CB1_CA1},
+ {0, CB4_CA2},
+
+ {0, CB2_CA16},
+ {0, CB2_CA15},
+ {0, CB2_CA14},
+ {0, CB2_CA13},
+ {0, CB2_CA12},
+ {0, CB2_CA11},
+ {0, CB2_CA10},
+ {0, CB2_CA9},
+ {0, CB2_CA8},
+ {0, CB2_CA7},
+ {0, CB2_CA6},
+ {0, CB2_CA5},
+ {0, CB2_CA4},
+ {0, CB2_CA3},
+ {0, CB2_CA2},
+ {0, CB2_CA1},
+ {0, CB5_CA2},
+
+ {0, CB3_CA16},
+ {0, CB3_CA15},
+ {0, CB3_CA14},
+ {0, CB3_CA13},
+ {0, CB3_CA12},
+ {0, CB3_CA11},
+ {0, CB3_CA10},
+ {0, CB3_CA9},
+ {0, CB3_CA8},
+ {0, CB3_CA7},
+ {0, CB3_CA6},
+ {0, CB3_CA5},
+ {0, CB3_CA4},
+ {0, CB3_CA3},
+ {0, CB3_CA2},
+ {0, CB3_CA1},
+ {0, CB4_CA1},
+
+ {0, CB4_CA16},
+ {0, CB4_CA15},
+ {0, CB4_CA14},
+ {0, CB4_CA13},
+ {0, CB4_CA12},
+ {0, CB4_CA11},
+ {0, CB4_CA10},
+ {0, CB4_CA9},
+ {0, CB4_CA8},
+ {0, CB4_CA7},
+ {0, CB4_CA6},
+ {0, CB4_CA5},
+ {0, CB4_CA3},
+
+ {0, CB5_CA16},
+ {0, CB5_CA14},
+ {0, CB5_CA13},
+ {0, CB5_CA12},
+ {0, CB5_CA11},
+ {0, CB5_CA10},
+ {0, CB5_CA9},
+ {0, CB5_CA8},
+ {0, CB5_CA7},
+ {0, CB5_CA6},
+ {0, CB5_CA5},
+ {0, CB5_CA3},
+ {0, CB5_CA1},
+
+ {0, CB6_CA16},
+ {0, CB6_CA15},
+ {0, CB6_CA14},
+ {0, CB6_CA10},
+ {0, CB6_CA6},
+ {0, CB6_CA5},
+ {0, CB6_CA4},
+ {0, CB6_CA3},
+ {0, CB6_CA2},
+ {0, CB6_CA1},
+ {0, CB4_CA4},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, __, __, __ },
+ { 63, __, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, 74, __, 75, __ },
+ { 76, 77, 78, __, __, __, 79, __, __, __, 80, 81, 82, 83, 84, 85, 86 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {25, 0}, {38, 0}, {51, 0}, {64, 0}, {84, 0}, { 97, 0}, {110, 0}, {123, 0}, {142, 0}, {155, 0}, {168, 0}, {181, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {12,14}, {25,14}, {38,14}, {51,14}, {64,14}, {77,14}, { 90,14}, {103,14}, {116,14}, {129,14}, {142,14}, {155,14}, {175,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {19,26}, {32,26}, {45,26}, {58,26}, {71,26}, {84,26}, { 97,26}, {110,26}, {123,26}, {136,26}, {149,26}, {162,26}, {178,26}, {198,26}, {211,26}, {224,26},
+ {4,39}, {22,39}, {35,39}, {48,39}, {61,39}, {74,39}, {87,39}, {100,39}, {113,39}, {126,39}, {139,39}, {152,39}, {173,39},
+ {8,51}, {29,51}, {42,51}, {55,51}, {68,51}, {81,51}, { 94,51}, {107,51}, {120,51}, {132,51}, {145,51}, {170,51}, {211,51},
+ {1,64}, {17,64}, {34,64}, {82,64}, {131,64}, {147,64}, {163,64}, {180,64}, {198,64}, {211,64}, {224,64}
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/k8_max/board.h b/keyboards/keychron/k8_max/board.h
new file mode 100644
index 0000000000..27d5ae5bf4
--- /dev/null
+++ b/keyboards/keychron/k8_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLDOWN(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLDOWN(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/k8_max/config.h b/keyboards/keychron/k8_max/config.h
new file mode 100644
index 0000000000..c42fb16862
--- /dev/null
+++ b/keyboards/keychron/k8_max/config.h
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A9
+# define BT_MODE_SELECT_PIN A10
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN C5
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+# define BT_INDICATION_LED_PIN_LIST \
+ { B15, B15, B15 }
+# define BT_INDICATION_LED_ON_STATE 0
+
+# define P24G_HOST_DEVICES_COUNT 1
+# define P24G_INDICATION_LED_PIN_LIST \
+ { B14 }
+
+# if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/k8_max/halconf.h b/keyboards/keychron/k8_max/halconf.h
new file mode 100644
index 0000000000..4b823aa657
--- /dev/null
+++ b/keyboards/keychron/k8_max/halconf.h
@@ -0,0 +1,28 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/k8_max/info.json b/keyboards/keychron/k8_max/info.json
new file mode 100644
index 0000000000..0470760048
--- /dev/null
+++ b/keyboards/keychron/k8_max/info.json
@@ -0,0 +1,337 @@
+{
+ "keyboard_name": "Keychron K8 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "Keychron",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey": true,
+ "mousekey": true,
+ "dip_switch": true,
+ "nkro": true,
+ "raw": true,
+ "sendstring": true
+ },
+ "matrix_pins": {
+ "cols": ["C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch" :{
+ "pins": ["B12"]
+ },
+ "dynamic_keymap": {
+ "layer_count": 4
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "indicators": {
+ "caps_lock": "B10",
+ "on_state": 1
+ },
+ "layouts": {
+ "LAYOUT_ansi_87": {
+ "layout": [
+ {"matrix":[0, 0], "x":0, "y":0},
+ {"matrix":[0, 2], "x":2, "y":0},
+ {"matrix":[0, 3], "x":3, "y":0},
+ {"matrix":[0, 4], "x":4, "y":0},
+ {"matrix":[0, 5], "x":5, "y":0},
+ {"matrix":[0, 6], "x":6.5, "y":0},
+ {"matrix":[0, 7], "x":7.5, "y":0},
+ {"matrix":[0, 8], "x":8.5, "y":0},
+ {"matrix":[0, 9], "x":9.5, "y":0},
+ {"matrix":[0,10], "x":11, "y":0},
+ {"matrix":[0,11], "x":12, "y":0},
+ {"matrix":[0,12], "x":13, "y":0},
+ {"matrix":[0,13], "x":14, "y":0},
+ {"matrix":[0,14], "x":15.25, "y":0},
+ {"matrix":[0,15], "x":16.25, "y":0},
+ {"matrix":[0,16], "x":17.25, "y":0},
+
+ {"matrix":[1, 0], "x":0, "y":1.25},
+ {"matrix":[1, 1], "x":1, "y":1.25},
+ {"matrix":[1, 2], "x":2, "y":1.25},
+ {"matrix":[1, 3], "x":3, "y":1.25},
+ {"matrix":[1, 4], "x":4, "y":1.25},
+ {"matrix":[1, 5], "x":5, "y":1.25},
+ {"matrix":[1, 6], "x":6, "y":1.25},
+ {"matrix":[1, 7], "x":7, "y":1.25},
+ {"matrix":[1, 8], "x":8, "y":1.25},
+ {"matrix":[1, 9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[1,13], "x":13, "y":1.25, "w":2},
+ {"matrix":[1,14], "x":15.25, "y":1.25},
+ {"matrix":[1,15], "x":16.25, "y":1.25},
+ {"matrix":[1,16], "x":17.25, "y":1.25},
+
+ {"matrix":[2, 0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2, 1], "x":1.5, "y":2.25},
+ {"matrix":[2, 2], "x":2.5, "y":2.25},
+ {"matrix":[2, 3], "x":3.5, "y":2.25},
+ {"matrix":[2, 4], "x":4.5, "y":2.25},
+ {"matrix":[2, 5], "x":5.5, "y":2.25},
+ {"matrix":[2, 6], "x":6.5, "y":2.25},
+ {"matrix":[2, 7], "x":7.5, "y":2.25},
+ {"matrix":[2, 8], "x":8.5, "y":2.25},
+ {"matrix":[2, 9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,13], "x":13.5, "y":2.25, "w":1.5},
+ {"matrix":[2,14], "x":15.25, "y":2.25},
+ {"matrix":[2,15], "x":16.25, "y":2.25},
+ {"matrix":[2,16], "x":17.25, "y":2.25},
+
+ {"matrix":[3, 0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3, 1], "x":1.75, "y":3.25},
+ {"matrix":[3, 2], "x":2.75, "y":3.25},
+ {"matrix":[3, 3], "x":3.75, "y":3.25},
+ {"matrix":[3, 4], "x":4.75, "y":3.25},
+ {"matrix":[3, 5], "x":5.75, "y":3.25},
+ {"matrix":[3, 6], "x":6.75, "y":3.25},
+ {"matrix":[3, 7], "x":7.75, "y":3.25},
+ {"matrix":[3, 8], "x":8.75, "y":3.25},
+ {"matrix":[3, 9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,13], "x":12.75, "y":3.25, "w":2.25},
+
+ {"matrix":[4, 0], "x":0, "y":4.25, "w":2.25},
+ {"matrix":[4, 2], "x":2.25, "y":4.25},
+ {"matrix":[4, 3], "x":3.25, "y":4.25},
+ {"matrix":[4, 4], "x":4.25, "y":4.25},
+ {"matrix":[4, 5], "x":5.25, "y":4.25},
+ {"matrix":[4, 6], "x":6.25, "y":4.25},
+ {"matrix":[4, 7], "x":7.25, "y":4.25},
+ {"matrix":[4, 8], "x":8.25, "y":4.25},
+ {"matrix":[4, 9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25, "y":4.25},
+ {"matrix":[4,11], "x":11.25, "y":4.25},
+ {"matrix":[4,13], "x":12.25, "y":4.25, "w":2.75},
+ {"matrix":[4,15], "x":16.25, "y":4.25},
+
+ {"matrix":[5, 0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5, 1], "x":1.25, "y":5.25, "w":1.25},
+ {"matrix":[5, 2], "x":2.5, "y":5.25, "w":1.25},
+ {"matrix":[5, 6], "x":3.75, "y":5.25, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5.25, "w":1.25},
+ {"matrix":[5,11], "x":11.25, "y":5.25, "w":1.25},
+ {"matrix":[5,12], "x":12.5, "y":5.25, "w":1.25},
+ {"matrix":[5,13], "x":13.75, "y":5.25, "w":1.25},
+ {"matrix":[5,14], "x":15.25, "y":5.25},
+ {"matrix":[5,15], "x":16.25, "y":5.25},
+ {"matrix":[5,16], "x":17.25, "y":5.25}
+ ]
+ },
+ "LAYOUT_iso_88": {
+ "layout": [
+ {"matrix":[0, 0], "x":0, "y":0},
+ {"matrix":[0, 2], "x":2, "y":0},
+ {"matrix":[0, 3], "x":3, "y":0},
+ {"matrix":[0, 4], "x":4, "y":0},
+ {"matrix":[0, 5], "x":5, "y":0},
+ {"matrix":[0, 6], "x":6.5, "y":0},
+ {"matrix":[0, 7], "x":7.5, "y":0},
+ {"matrix":[0, 8], "x":8.5, "y":0},
+ {"matrix":[0, 9], "x":9.5, "y":0},
+ {"matrix":[0,10], "x":11, "y":0},
+ {"matrix":[0,11], "x":12, "y":0},
+ {"matrix":[0,12], "x":13, "y":0},
+ {"matrix":[0,13], "x":14, "y":0},
+ {"matrix":[0,14], "x":15.25, "y":0},
+ {"matrix":[0,15], "x":16.25, "y":0},
+ {"matrix":[0,16], "x":17.25, "y":0},
+
+ {"matrix":[1, 0], "x":0, "y":1.25},
+ {"matrix":[1, 1], "x":1, "y":1.25},
+ {"matrix":[1, 2], "x":2, "y":1.25},
+ {"matrix":[1, 3], "x":3, "y":1.25},
+ {"matrix":[1, 4], "x":4, "y":1.25},
+ {"matrix":[1, 5], "x":5, "y":1.25},
+ {"matrix":[1, 6], "x":6, "y":1.25},
+ {"matrix":[1, 7], "x":7, "y":1.25},
+ {"matrix":[1, 8], "x":8, "y":1.25},
+ {"matrix":[1, 9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[1,13], "x":13, "y":1.25, "w":2},
+ {"matrix":[1,14], "x":15.25, "y":1.25},
+ {"matrix":[1,15], "x":16.25, "y":1.25},
+ {"matrix":[1,16], "x":17.25, "y":1.25},
+
+ {"matrix":[2, 0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2, 1], "x":1.5, "y":2.25},
+ {"matrix":[2, 2], "x":2.5, "y":2.25},
+ {"matrix":[2, 3], "x":3.5, "y":2.25},
+ {"matrix":[2, 4], "x":4.5, "y":2.25},
+ {"matrix":[2, 5], "x":5.5, "y":2.25},
+ {"matrix":[2, 6], "x":6.5, "y":2.25},
+ {"matrix":[2, 7], "x":7.5, "y":2.25},
+ {"matrix":[2, 8], "x":8.5, "y":2.25},
+ {"matrix":[2, 9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,14], "x":15.25, "y":2.25},
+ {"matrix":[2,15], "x":16.25, "y":2.25},
+ {"matrix":[2,16], "x":17.25, "y":2.25},
+
+ {"matrix":[3, 0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3, 1], "x":1.75, "y":3.25},
+ {"matrix":[3, 2], "x":2.75, "y":3.25},
+ {"matrix":[3, 3], "x":3.75, "y":3.25},
+ {"matrix":[3, 4], "x":4.75, "y":3.25},
+ {"matrix":[3, 5], "x":5.75, "y":3.25},
+ {"matrix":[3, 6], "x":6.75, "y":3.25},
+ {"matrix":[3, 7], "x":7.75, "y":3.25},
+ {"matrix":[3, 8], "x":8.75, "y":3.25},
+ {"matrix":[3, 9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,13], "x":12.75, "y":3.25},
+ {"matrix":[2,13], "x":13.75, "y":2.25, "w":1.25, "h":2},
+
+ {"matrix":[4, 0], "x":0, "y":4.25, "w":1.25},
+ {"matrix":[4, 1], "x":1.25, "y":4.25},
+ {"matrix":[4, 2], "x":2.25, "y":4.25},
+ {"matrix":[4, 3], "x":3.25, "y":4.25},
+ {"matrix":[4, 4], "x":4.25, "y":4.25},
+ {"matrix":[4, 5], "x":5.25, "y":4.25},
+ {"matrix":[4, 6], "x":6.25, "y":4.25},
+ {"matrix":[4, 7], "x":7.25, "y":4.25},
+ {"matrix":[4, 8], "x":8.25, "y":4.25},
+ {"matrix":[4, 9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25, "y":4.25},
+ {"matrix":[4,11], "x":11.25, "y":4.25},
+ {"matrix":[4,13], "x":12.25, "y":4.25, "w":2.75},
+ {"matrix":[4,15], "x":16.25, "y":4.25},
+
+ {"matrix":[5, 0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5, 1], "x":1.25, "y":5.25, "w":1.25},
+ {"matrix":[5, 2], "x":2.5, "y":5.25, "w":1.25},
+ {"matrix":[5, 6], "x":3.75, "y":5.25, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5.25, "w":1.25},
+ {"matrix":[5,11], "x":11.25, "y":5.25, "w":1.25},
+ {"matrix":[5,12], "x":12.5, "y":5.25, "w":1.25},
+ {"matrix":[5,13], "x":13.75, "y":5.25, "w":1.25},
+ {"matrix":[5,14], "x":15.25, "y":5.25},
+ {"matrix":[5,15], "x":16.25, "y":5.25},
+ {"matrix":[5,16], "x":17.25, "y":5.25}
+ ]
+ },
+ "LAYOUT_jis_91": {
+ "layout": [
+ {"matrix":[0, 0], "x":0, "y":0},
+ {"matrix":[0, 2], "x":2, "y":0},
+ {"matrix":[0, 3], "x":3, "y":0},
+ {"matrix":[0, 4], "x":4, "y":0},
+ {"matrix":[0, 5], "x":5, "y":0},
+ {"matrix":[0, 6], "x":6.5, "y":0},
+ {"matrix":[0, 7], "x":7.5, "y":0},
+ {"matrix":[0, 8], "x":8.5, "y":0},
+ {"matrix":[0, 9], "x":9.5, "y":0},
+ {"matrix":[0,10], "x":11, "y":0},
+ {"matrix":[0,11], "x":12, "y":0},
+ {"matrix":[0,12], "x":13, "y":0},
+ {"matrix":[0,13], "x":14, "y":0},
+ {"matrix":[0,14], "x":15.25, "y":0},
+ {"matrix":[0,15], "x":16.25, "y":0},
+ {"matrix":[0,16], "x":17.25, "y":0},
+
+ {"matrix":[1, 0], "x":0, "y":1.25},
+ {"matrix":[1, 1], "x":1, "y":1.25},
+ {"matrix":[1, 2], "x":2, "y":1.25},
+ {"matrix":[1, 3], "x":3, "y":1.25},
+ {"matrix":[1, 4], "x":4, "y":1.25},
+ {"matrix":[1, 5], "x":5, "y":1.25},
+ {"matrix":[1, 6], "x":6, "y":1.25},
+ {"matrix":[1, 7], "x":7, "y":1.25},
+ {"matrix":[1, 8], "x":8, "y":1.25},
+ {"matrix":[1, 9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[0, 1], "x":13, "y":1.25},
+ {"matrix":[1,13], "x":14, "y":1.25},
+ {"matrix":[1,14], "x":15.25, "y":1.25},
+ {"matrix":[1,15], "x":16.25, "y":1.25},
+ {"matrix":[1,16], "x":17.25, "y":1.25},
+
+ {"matrix":[2, 0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2, 1], "x":1.5, "y":2.25},
+ {"matrix":[2, 2], "x":2.5, "y":2.25},
+ {"matrix":[2, 3], "x":3.5, "y":2.25},
+ {"matrix":[2, 4], "x":4.5, "y":2.25},
+ {"matrix":[2, 5], "x":5.5, "y":2.25},
+ {"matrix":[2, 6], "x":6.5, "y":2.25},
+ {"matrix":[2, 7], "x":7.5, "y":2.25},
+ {"matrix":[2, 8], "x":8.5, "y":2.25},
+ {"matrix":[2, 9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,14], "x":15.25, "y":2.25},
+ {"matrix":[2,15], "x":16.25, "y":2.25},
+ {"matrix":[2,16], "x":17.25, "y":2.25},
+
+ {"matrix":[3, 0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3, 1], "x":1.75, "y":3.25},
+ {"matrix":[3, 2], "x":2.75, "y":3.25},
+ {"matrix":[3, 3], "x":3.75, "y":3.25},
+ {"matrix":[3, 4], "x":4.75, "y":3.25},
+ {"matrix":[3, 5], "x":5.75, "y":3.25},
+ {"matrix":[3, 6], "x":6.75, "y":3.25},
+ {"matrix":[3, 7], "x":7.75, "y":3.25},
+ {"matrix":[3, 8], "x":8.75, "y":3.25},
+ {"matrix":[3, 9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,13], "x":12.75, "y":3.25},
+ {"matrix":[2,13], "x":13.75, "y":2.25, "w": 1.25,"h": 2},
+
+ {"matrix":[4, 0], "x":0, "y":4.25, "w":2.25},
+ {"matrix":[4, 2], "x":2.25, "y":4.25},
+ {"matrix":[4, 3], "x":3.25, "y":4.25},
+ {"matrix":[4, 4], "x":4.25, "y":4.25},
+ {"matrix":[4, 5], "x":5.25, "y":4.25},
+ {"matrix":[4, 6], "x":6.25, "y":4.25},
+ {"matrix":[4, 7], "x":7.25, "y":4.25},
+ {"matrix":[4, 8], "x":8.25, "y":4.25},
+ {"matrix":[4, 9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25, "y":4.25},
+ {"matrix":[4,11], "x":11.25, "y":4.25},
+ {"matrix":[4,12], "x":12.25, "y":4.25},
+ {"matrix":[4,13], "x":13.25, "y":4.25, "w":1.75},
+ {"matrix":[4,15], "x":16.25, "y":4.25},
+
+ {"matrix":[5, 0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5, 1], "x":1.25, "y":5.25},
+ {"matrix":[5, 2], "x":2.25, "y":5.25, "w":1.25},
+ {"matrix":[5, 3], "x":3.5, "y":5.25},
+ {"matrix":[5, 6], "x":4.5, "y":5.25, "w":4.5},
+ {"matrix":[5, 9], "x":9, "y":5.25},
+ {"matrix":[5,10], "x":10, "y":5.25, "w":1.25},
+ {"matrix":[5,11], "x":11.25, "y":5.25, "w":1.25},
+ {"matrix":[5,12], "x":12.5, "y":5.25, "w":1.25},
+ {"matrix":[5,13], "x":13.75, "y":5.25, "w":1.25},
+ {"matrix":[5,14], "x":15.25, "y":5.25},
+ {"matrix":[5,15], "x":16.25, "y":5.25},
+ {"matrix":[5,16], "x":17.25, "y":5.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/k8_max/iso/rgb/config.h b/keyboards/keychron/k8_max/iso/rgb/config.h
new file mode 100644
index 0000000000..3b95db052e
--- /dev/null
+++ b/keyboards/keychron/k8_max/iso/rgb/config.h
@@ -0,0 +1,54 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 88
+# define DRIVER_CS_PINS \
+ { A8, C9 }
+
+#ifdef LK_WIRELESS_ENABLE
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+#endif
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+#endif
+
+
diff --git a/keyboards/keychron/k8_max/iso/rgb/keyboard.json b/keyboards/keychron/k8_max/iso/rgb/keyboard.json
new file mode 100644
index 0000000000..2750b18ed7
--- /dev/null
+++ b/keyboards/keychron/k8_max/iso/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A81",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k8_max/iso/rgb/keymaps/default/keymap.c b/keyboards/keychron/k8_max/iso/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..15c710d8e0
--- /dev/null
+++ b/keyboards/keychron/k8_max/iso/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_88(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_88(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_88(
+ 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_CTANA, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_88(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k8_max/iso/rgb/rgb.c b/keyboards/keychron/k8_max/iso/rgb/rgb.c
new file mode 100644
index 0000000000..1604e2a99e
--- /dev/null
+++ b/keyboards/keychron/k8_max/iso/rgb/rgb.c
@@ -0,0 +1,155 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t PROGMEM g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to RGB Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, __, __, __ },
+ { 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, __, 75, __, 76, __ },
+ { 77, 78, 79, __, __, __, 80, __, __, __, 81, 82, 83, 84, 85, 86, 87 },
+ },
+ {
+ // RGB Index to Physical Position
+ {0, 0}, {25, 0}, {38, 0}, {51, 0}, {64, 0}, {84, 0}, {97, 0}, {110, 0}, {123, 0}, {142, 0}, {155, 0}, {168, 0}, {179, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {12,14}, {25,14}, {38,14}, {51,14}, {64,14}, {77,14}, {90,14}, {103,14}, {116,14}, {129,14}, {142,14}, {155,14}, {175,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {19,26}, {32,26}, {45,26}, {58,26}, {71,26}, {84,26}, {97,26}, {110,26}, {123,26}, {136,26}, {149,26}, {162,26}, {178,32}, {198,26}, {211,26}, {224,26},
+ {4,39}, {22,39}, {35,39}, {48,39}, {61,39}, {74,39}, {87,39}, {100,39}, {113,39}, {126,39}, {139,39}, {152,39}, {165,39},
+ {1,51}, {15,39}, {29,51}, {42,51}, {55,51}, {68,51}, {81,51}, {94,51}, {107,51}, {120,51}, {132,51}, {145,51}, {171,51}, {211,51},
+ {1,64}, {17,64}, {34,64}, {82,64}, {131,64}, {147,64}, {163,64}, {179,64}, {198,64}, {211,64}, {224,64}
+ },
+ {
+ // RGB Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/k8_max/iso/rgb/rules.mk b/keyboards/keychron/k8_max/iso/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k8_max/iso/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k8_max/iso/white/config.h b/keyboards/keychron/k8_max/iso/white/config.h
new file mode 100644
index 0000000000..9db0a44713
--- /dev/null
+++ b/keyboards/keychron/k8_max/iso/white/config.h
@@ -0,0 +1,53 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 88
+# define DRIVER_CS_PINS \
+ { C9 }
+
+# define LED_MATRIX_VAL_STEP 16
+
+# ifdef LK_WIRELESS_ENABLE
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+# endif
+
+/* Use first 8 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_8_CHANNEL
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k8_max/iso/white/keyboard.json b/keyboards/keychron/k8_max/iso/white/keyboard.json
new file mode 100644
index 0000000000..692469a47b
--- /dev/null
+++ b/keyboards/keychron/k8_max/iso/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A84",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k8_max/iso/white/keymaps/default/keymap.c b/keyboards/keychron/k8_max/iso/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..2f729d73a4
--- /dev/null
+++ b/keyboards/keychron/k8_max/iso/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_88(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, BL_STEP,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_88(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_88(
+ 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_CTANA, BL_STEP,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_88(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k8_max/iso/white/rules.mk b/keyboards/keychron/k8_max/iso/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k8_max/iso/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k8_max/iso/white/white.c b/keyboards/keychron/k8_max/iso/white/white.c
new file mode 100644
index 0000000000..a9a4f82810
--- /dev/null
+++ b/keyboards/keychron/k8_max/iso/white/white.c
@@ -0,0 +1,153 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA16},
+ {0, CB1_CA14},
+ {0, CB1_CA13},
+ {0, CB1_CA12},
+ {0, CB1_CA11},
+ {0, CB1_CA10},
+ {0, CB1_CA9},
+ {0, CB1_CA8},
+ {0, CB1_CA7},
+ {0, CB1_CA6},
+ {0, CB1_CA5},
+ {0, CB1_CA4},
+ {0, CB1_CA3},
+ {0, CB1_CA2},
+ {0, CB1_CA1},
+ {0, CB4_CA2},
+
+ {0, CB2_CA16},
+ {0, CB2_CA15},
+ {0, CB2_CA14},
+ {0, CB2_CA13},
+ {0, CB2_CA12},
+ {0, CB2_CA11},
+ {0, CB2_CA10},
+ {0, CB2_CA9},
+ {0, CB2_CA8},
+ {0, CB2_CA7},
+ {0, CB2_CA6},
+ {0, CB2_CA5},
+ {0, CB2_CA4},
+ {0, CB2_CA3},
+ {0, CB2_CA2},
+ {0, CB2_CA1},
+ {0, CB5_CA2},
+
+ {0, CB3_CA16},
+ {0, CB3_CA15},
+ {0, CB3_CA14},
+ {0, CB3_CA13},
+ {0, CB3_CA12},
+ {0, CB3_CA11},
+ {0, CB3_CA10},
+ {0, CB3_CA9},
+ {0, CB3_CA8},
+ {0, CB3_CA7},
+ {0, CB3_CA6},
+ {0, CB3_CA5},
+ {0, CB3_CA4},
+ {0, CB3_CA3},
+ {0, CB3_CA2},
+ {0, CB3_CA1},
+ {0, CB4_CA1},
+
+ {0, CB4_CA16},
+ {0, CB4_CA15},
+ {0, CB4_CA14},
+ {0, CB4_CA13},
+ {0, CB4_CA12},
+ {0, CB4_CA11},
+ {0, CB4_CA10},
+ {0, CB4_CA9},
+ {0, CB4_CA8},
+ {0, CB4_CA7},
+ {0, CB4_CA6},
+ {0, CB4_CA5},
+ {0, CB4_CA3},
+
+ {0, CB5_CA16},
+ {0, CB5_CA15},
+ {0, CB5_CA14},
+ {0, CB5_CA13},
+ {0, CB5_CA12},
+ {0, CB5_CA11},
+ {0, CB5_CA10},
+ {0, CB5_CA9},
+ {0, CB5_CA8},
+ {0, CB5_CA7},
+ {0, CB5_CA6},
+ {0, CB5_CA5},
+ {0, CB5_CA3},
+ {0, CB5_CA1},
+
+ {0, CB6_CA16},
+ {0, CB6_CA15},
+ {0, CB6_CA14},
+ {0, CB6_CA10},
+ {0, CB6_CA6},
+ {0, CB6_CA5},
+ {0, CB6_CA4},
+ {0, CB6_CA3},
+ {0, CB6_CA2},
+ {0, CB6_CA1},
+ {0, CB4_CA4},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, __, __, __ },
+ { 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, __, 75, __, 76, __ },
+ { 77, 78, 79, __, __, __, 80, __, __, __, 81, 82, 83, 84, 85, 86, 87 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {25, 0}, {38, 0}, {51, 0}, {64, 0}, {84, 0}, { 97, 0}, {110, 0}, {123, 0}, {142, 0}, {156, 0}, {168, 0}, {180, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {12,14}, {25,14}, {38,14}, {51,14}, {64,14}, {77,14}, { 90,14}, {103,14}, {116,14}, {129,14}, {142,14}, {156,14}, {175,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {19,26}, {32,26}, {45,26}, {58,26}, {71,26}, {84,26}, { 97,26}, {110,26}, {123,26}, {136,26}, {149,26}, {162,26}, {178,26}, {198,26}, {211,26}, {224,26},
+ {4,39}, {22,39}, {35,39}, {48,39}, {61,39}, {74,39}, {87,39}, {100,39}, {113,39}, {126,39}, {139,39}, {152,39}, {165,39},
+ {1,51}, {14,51}, {29,51}, {42,51}, {55,51}, {68,51}, {81,51}, {94,51}, {107,51}, {120,51}, {132,51}, {145,51}, {172,51}, {211,51},
+ {1,64}, {17,64}, {34,64}, {82,64}, {131,64}, {147,64}, {164,64}, {180,64}, {198,64}, {211,64}, {224,64}
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/k8_max/jis/rgb/config.h b/keyboards/keychron/k8_max/jis/rgb/config.h
new file mode 100644
index 0000000000..f71841fdc1
--- /dev/null
+++ b/keyboards/keychron/k8_max/jis/rgb/config.h
@@ -0,0 +1,52 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 91
+# define DRIVER_CS_PINS \
+ { A8, C9 }
+
+# ifdef LK_WIRELESS_ENABLE
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 18, 19, 20 }
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 21
+
+# define BAT_LEVEL_LED_LIST \
+ { 18, 19, 20, 21, 22, 23, 24, 25, 26, 27 }
+# endif
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30, 0x30 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+#endif
diff --git a/keyboards/keychron/k8_max/jis/rgb/keyboard.json b/keyboards/keychron/k8_max/jis/rgb/keyboard.json
new file mode 100644
index 0000000000..c9e9f7fdb9
--- /dev/null
+++ b/keyboards/keychron/k8_max/jis/rgb/keyboard.json
@@ -0,0 +1,36 @@
+{
+ "usb": {
+ "pid": "0x0A82",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "rgb_matrix": true
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k8_max/jis/rgb/keymaps/default/keymap.c b/keyboards/keychron/k8_max/jis/rgb/keymaps/default/keymap.c
new file mode 100644
index 0000000000..6c9549273b
--- /dev/null
+++ b/keyboards/keychron/k8_max/jis/rgb/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_jis_91(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, RGB_MOD,
+ 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_INT3, KC_BSPC, KC_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_BSLS, KC_ENT,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_jis_91(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_jis_91(
+ 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_CTANA, RGB_MOD,
+ 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_INT3, KC_BSPC, KC_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_BSLS, KC_ENT,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_jis_91(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k8_max/jis/rgb/rgb.c b/keyboards/keychron/k8_max/jis/rgb/rgb.c
new file mode 100644
index 0000000000..7ee022e623
--- /dev/null
+++ b/keyboards/keychron/k8_max/jis/rgb/rgb.c
@@ -0,0 +1,159 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t PROGMEM g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to RGB Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16 },
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33 },
+ { 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50 },
+ { 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, __, 63, __, __, __ },
+ { 64, __, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, __, 77, __ },
+ { 78, 79, 80, 81, __, __, 82, __, __, 83, 84, 85, 86, 87, 88, 89, 90 },
+ },
+ {
+ // RGB Index to Physical Position
+ {0, 0}, {168,14},{25, 0}, {38, 0}, {51, 0}, {64, 0}, {84, 0}, { 97, 0}, {110, 0}, {123, 0}, {142, 0}, {156, 0}, {168, 0}, {180, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {12,14}, {25,14}, {38,14}, {51,14}, {64,14}, {77,14}, { 90,14}, {103,14}, {116,14}, {129,14}, {142,14}, {156,14}, {180,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {19,26}, {32,26}, {45,26}, {58,26}, {71,26}, {84,26}, { 97,26}, {110,26}, {123,26}, {136,26}, {149,26}, {162,26}, {178,32}, {198,26}, {211,26}, {224,26},
+ {4,39}, {22,39}, {35,39}, {48,39}, {61,39}, {74,39}, {87,39}, {100,39}, {113,39}, {126,39}, {139,39}, {152,39}, {165,39},
+ {8,51}, {29,51}, {42,51}, {55,51}, {68,51}, {81,51}, { 94,51}, {107,51}, {120,51}, {132,51}, {145,51}, {158,51}, {172,51}, {211,51},
+ {1,64}, {16,64}, {31,64}, {45,64}, {82,64}, {116,64}, {131,64}, {147,64}, {164,64}, {180,64}, {198,64}, {211,64}, {224,64}
+ },
+ {
+ // RGB Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+
+
+#endif
diff --git a/keyboards/keychron/k8_max/jis/rgb/rules.mk b/keyboards/keychron/k8_max/jis/rgb/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k8_max/jis/rgb/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k8_max/jis/white/config.h b/keyboards/keychron/k8_max/jis/white/config.h
new file mode 100644
index 0000000000..d13067bbf2
--- /dev/null
+++ b/keyboards/keychron/k8_max/jis/white/config.h
@@ -0,0 +1,53 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef LED_MATRIX_ENABLE
+/* LED matrix driver configuration */
+# define LED_MATRIX_LED_COUNT 91
+# define DRIVER_CS_PINS \
+ { C9 }
+
+# define LED_MATRIX_VAL_STEP 16
+
+# ifdef LK_WIRELESS_ENABLE
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 18, 19, 20 }
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 21
+
+# define BAT_LEVEL_LED_LIST \
+ { 18, 19, 20, 21, 22, 23, 24, 25, 26, 27 }
+# endif
+
+/* Use first 8 channels of LED driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_8_CHANNEL
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60, 0x60 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define LED_MATRIX_TIMEOUT LED_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define LED_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define LED_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define LED_MATRIX_BRIGHTNESS_TURN_OFF_VAL 48
+
+# define LED_MATRIX_KEYPRESSES
+#endif
diff --git a/keyboards/keychron/k8_max/jis/white/keyboard.json b/keyboards/keychron/k8_max/jis/white/keyboard.json
new file mode 100644
index 0000000000..60f2835184
--- /dev/null
+++ b/keyboards/keychron/k8_max/jis/white/keyboard.json
@@ -0,0 +1,30 @@
+{
+ "usb": {
+ "pid": "0x0A85",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "led_matrix": true
+ },
+ "led_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "none": true,
+ "solid": true,
+ "breathing": true,
+ "band_pinwheel": true,
+ "band_spiral": true,
+ "cycle_left_right": true,
+ "cycle_up_down": true,
+ "cycle_out_in": true,
+ "dual_beacon": true,
+ "solid_reactive_simple": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_multinexus": true,
+ "solid_splash": true,
+ "wave_left_right": true,
+ "wave_up_down": true
+ }
+ }
+}
diff --git a/keyboards/keychron/k8_max/jis/white/keymaps/default/keymap.c b/keyboards/keychron/k8_max/jis/white/keymaps/default/keymap.c
new file mode 100644
index 0000000000..d4dd2bea2f
--- /dev/null
+++ b/keyboards/keychron/k8_max/jis/white/keymaps/default/keymap.c
@@ -0,0 +1,67 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_jis_91(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_SNAP, KC_SIRI, BL_STEP,
+ 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_INT3, KC_BSPC, KC_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_BSLS, KC_ENT,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD, KC_ROPTN,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_jis_91(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_jis_91(
+ 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_CTANA, BL_STEP,
+ 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_INT3, KC_BSPC, KC_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_BSLS, KC_ENT,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, KC_RGUI, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_jis_91(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, BL_DOWN, BL_UP, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, BL_TOGG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ BL_TOGG, BL_STEP, BL_UP, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, BL_DOWN, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/k8_max/jis/white/rules.mk b/keyboards/keychron/k8_max/jis/white/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/k8_max/jis/white/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/k8_max/jis/white/white.c b/keyboards/keychron/k8_max/jis/white/white.c
new file mode 100644
index 0000000000..ff690f7c0a
--- /dev/null
+++ b/keyboards/keychron/k8_max/jis/white/white.c
@@ -0,0 +1,156 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+#ifdef LED_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[LED_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | LED address
+ * | | */
+ {0, CB1_CA16},
+ {0, CB1_CA15},
+ {0, CB1_CA14},
+ {0, CB1_CA13},
+ {0, CB1_CA12},
+ {0, CB1_CA11},
+ {0, CB1_CA10},
+ {0, CB1_CA9},
+ {0, CB1_CA8},
+ {0, CB1_CA7},
+ {0, CB1_CA6},
+ {0, CB1_CA5},
+ {0, CB1_CA4},
+ {0, CB1_CA3},
+ {0, CB1_CA2},
+ {0, CB1_CA1},
+ {0, CB4_CA4},
+
+ {0, CB2_CA16},
+ {0, CB2_CA15},
+ {0, CB2_CA14},
+ {0, CB2_CA13},
+ {0, CB2_CA12},
+ {0, CB2_CA11},
+ {0, CB2_CA10},
+ {0, CB2_CA9},
+ {0, CB2_CA8},
+ {0, CB2_CA7},
+ {0, CB2_CA6},
+ {0, CB2_CA5},
+ {0, CB2_CA4},
+ {0, CB2_CA3},
+ {0, CB2_CA2},
+ {0, CB2_CA1},
+ {0, CB4_CA1},
+
+ {0, CB3_CA16},
+ {0, CB3_CA15},
+ {0, CB3_CA14},
+ {0, CB3_CA13},
+ {0, CB3_CA12},
+ {0, CB3_CA11},
+ {0, CB3_CA10},
+ {0, CB3_CA9},
+ {0, CB3_CA8},
+ {0, CB3_CA7},
+ {0, CB3_CA6},
+ {0, CB3_CA5},
+ {0, CB3_CA4},
+ {0, CB3_CA3},
+ {0, CB3_CA2},
+ {0, CB3_CA1},
+ {0, CB4_CA2},
+
+ {0, CB4_CA16},
+ {0, CB4_CA15},
+ {0, CB4_CA14},
+ {0, CB4_CA13},
+ {0, CB4_CA12},
+ {0, CB4_CA11},
+ {0, CB4_CA10},
+ {0, CB4_CA9},
+ {0, CB4_CA8},
+ {0, CB4_CA7},
+ {0, CB4_CA6},
+ {0, CB4_CA5},
+ {0, CB4_CA3},
+
+ {0, CB5_CA16},
+ {0, CB5_CA14},
+ {0, CB5_CA13},
+ {0, CB5_CA12},
+ {0, CB5_CA11},
+ {0, CB5_CA10},
+ {0, CB5_CA9},
+ {0, CB5_CA8},
+ {0, CB5_CA7},
+ {0, CB5_CA6},
+ {0, CB5_CA5},
+ {0, CB5_CA4},
+ {0, CB5_CA3},
+ {0, CB5_CA1},
+
+ {0, CB6_CA16},
+ {0, CB6_CA15},
+ {0, CB6_CA14},
+ {0, CB6_CA13},
+ {0, CB6_CA10},
+ {0, CB6_CA7},
+ {0, CB6_CA6},
+ {0, CB6_CA5},
+ {0, CB6_CA4},
+ {0, CB6_CA3},
+ {0, CB6_CA2},
+ {0, CB6_CA1},
+ {0, CB5_CA2},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16 },
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33 },
+ { 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50 },
+ { 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, __, 63, __, __, __ },
+ { 64, __, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, __, 77, __ },
+ { 78, 79, 80, 81, __, __, 82, __, __, 83, 84, 85, 86, 87, 88, 89, 90 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {168,14},{25, 0}, {38, 0}, {51, 0}, {64, 0}, {84, 0}, { 97, 0}, {110, 0}, {123, 0}, {142, 0}, {156, 0}, {168, 0}, {180, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,14}, {12,14}, {25,14}, {38,14}, {51,14}, {64,14}, {77,14}, { 90,14}, {103,14}, {116,14}, {129,14}, {142,14}, {156,14}, {180,14}, {198,14}, {211,14}, {224,14},
+ {3,26}, {19,26}, {32,26}, {45,26}, {58,26}, {71,26}, {84,26}, { 97,26}, {110,26}, {123,26}, {136,26}, {149,26}, {162,26}, {178,32}, {198,26}, {211,26}, {224,26},
+ {4,39}, {22,39}, {35,39}, {48,39}, {61,39}, {74,39}, {87,39}, {100,39}, {113,39}, {126,39}, {139,39}, {152,39}, {165,39},
+ {8,51}, {29,51}, {42,51}, {55,51}, {68,51}, {81,51}, {94,51}, {107,51}, {120,51}, {132,51}, {145,51}, {158,51}, {172,51}, {211,51},
+ {1,64}, {16,64}, {31,64}, {45,64}, {82,64}, {116,64}, {131,64}, {147,64}, {164,64}, {180,64}, {198,64}, {211,64}, {224,64}
+ },
+ {
+ // LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/k8_max/k8_max.c b/keyboards/keychron/k8_max/k8_max.c
new file mode 100644
index 0000000000..7019d5b837
--- /dev/null
+++ b/keyboards/keychron/k8_max/k8_max.c
@@ -0,0 +1,94 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "transport.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#if defined(LK_WIRELESS_ENABLE)
+pin_t bt_led_pins[] = BT_INDICATION_LED_PIN_LIST;
+pin_t p24g_led_pins[] = P24G_INDICATION_LED_PIN_LIST;
+#endif
+
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 2 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+ power_on_indicator_timer = timer_read32();
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+ if (!host_keyboard_led_state().caps_lock) gpio_write_pin(LED_CAPS_LOCK_PIN, !LED_PIN_ON_STATE);
+#if defined(LK_WIRELESS_ENABLE)
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+ for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(bt_led_pins[i], !BT_INDICATION_LED_ON_STATE);
+ for (uint8_t i = 0; i < sizeof(p24g_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(p24g_led_pins[i], !BT_INDICATION_LED_ON_STATE);
+#endif
+ } else {
+ gpio_write_pin(LED_CAPS_LOCK_PIN, LED_PIN_ON_STATE);
+#if defined(LK_WIRELESS_ENABLE)
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+ if (get_transport() != TRANSPORT_P2P4)
+ for (uint8_t i = 0; i < sizeof(bt_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(bt_led_pins[i], BT_INDICATION_LED_ON_STATE);
+ if (get_transport() != TRANSPORT_BLUETOOTH)
+ for (uint8_t i = 0; i < sizeof(p24g_led_pins) / sizeof(pin_t); i++)
+ gpio_write_pin(p24g_led_pins[i], BT_INDICATION_LED_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/k8_max/mcuconf.h b/keyboards/keychron/k8_max/mcuconf.h
new file mode 100644
index 0000000000..a616c82cdf
--- /dev/null
+++ b/keyboards/keychron/k8_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 @ lokher (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/k8_max/readme.md b/keyboards/keychron/k8_max/readme.md
new file mode 100644
index 0000000000..ffa8a05eb6
--- /dev/null
+++ b/keyboards/keychron/k8_max/readme.md
@@ -0,0 +1,31 @@
+# Keychron K8 Max
+
+
+
+A customizable 87 keys TKL keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron K8 Max
+* Hardware Availability: [Keychron K8 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-k8-max-qmk-wireless-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/k8_max/ansi/rgb:default
+ make keychron/k8_max/ansi/white:default
+ make keychron/k8_max/iso/rgb:default
+ make keychron/k8_max/iso/white:default
+ make keychron/k8_max/jisi/rgb:default
+ make keychron/k8_max/jis/white:default
+
+Flashing example for this keyboard:
+
+ make keychron/k8_max/ansi/rgb:default:flash
+ make keychron/k8_max/ansi/white:default:flash
+ make keychron/k8_max/iso/rgb:default:flash
+ make keychron/k8_max/iso/white:default:flash
+ make keychron/k8_max/jisi/rgb:default:flash
+ make keychron/k8_max/jis/white:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/k8_max/rules.mk b/keyboards/keychron/k8_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/k8_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/k8_max/via_json/k8_max_ansi_rgb.json b/keyboards/keychron/k8_max/via_json/k8_max_ansi_rgb.json
new file mode 100644
index 0000000000..80705df072
--- /dev/null
+++ b/keyboards/keychron/k8_max/via_json/k8_max_ansi_rgb.json
@@ -0,0 +1,290 @@
+{
+ "name": "Keychron K8 Max ANSI RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A80",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ "0,4",
+ "0,5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ "0,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,14",
+ "0,15",
+ "0,16"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,13",
+ {
+ "x": 0.25
+ },
+ "1,14",
+ "1,15",
+ "1,16"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,13",
+ {
+ "x": 0.25
+ },
+ "2,14",
+ "2,15",
+ "2,16"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,13"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 2.75
+ },
+ "4,13",
+ {
+ "x": 1.25,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,10",
+ {
+ "w": 1.25
+ },
+ "5,11",
+ {
+ "w": 1.25
+ },
+ "5,12",
+ {
+ "w": 1.25
+ },
+ "5,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,14",
+ "5,15",
+ "5,16"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k8_max/via_json/k8_max_ansi_white.json b/keyboards/keychron/k8_max/via_json/k8_max_ansi_white.json
new file mode 100644
index 0000000000..f1db7a75e4
--- /dev/null
+++ b/keyboards/keychron/k8_max/via_json/k8_max_ansi_white.json
@@ -0,0 +1,229 @@
+{
+ "name": "Keychron K8 Max ANSI White",
+ "vendorId": "0x3434",
+ "productId": "0x0A83",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ "0,4",
+ "0,5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ "0,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,14",
+ "0,15",
+ "0,16"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,13",
+ {
+ "x": 0.25
+ },
+ "1,14",
+ "1,15",
+ "1,16"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,13",
+ {
+ "x": 0.25
+ },
+ "2,14",
+ "2,15",
+ "2,16"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,13"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 2.75
+ },
+ "4,13",
+ {
+ "x": 1.25,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,10",
+ {
+ "w": 1.25
+ },
+ "5,11",
+ {
+ "w": 1.25
+ },
+ "5,12",
+ {
+ "w": 1.25
+ },
+ "5,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,14",
+ "5,15",
+ "5,16"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k8_max/via_json/k8_max_iso_rgb.json b/keyboards/keychron/k8_max/via_json/k8_max_iso_rgb.json
new file mode 100644
index 0000000000..a00452b8fc
--- /dev/null
+++ b/keyboards/keychron/k8_max/via_json/k8_max_iso_rgb.json
@@ -0,0 +1,292 @@
+{
+ "name": "Keychron K8 Max ISO RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A81",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ "0,4",
+ "0,5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ "0,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,14",
+ "0,15",
+ "0,16"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,13",
+ {
+ "x": 0.25
+ },
+ "1,14",
+ "1,15",
+ "1,16"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,13",
+ {
+ "x": 0.25
+ },
+ "2,14",
+ "2,15",
+ "2,16"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,1",
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 2.75
+ },
+ "4,13",
+ {
+ "x": 1.25,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,10",
+ {
+ "w": 1.25
+ },
+ "5,11",
+ {
+ "w": 1.25
+ },
+ "5,12",
+ {
+ "w": 1.25
+ },
+ "5,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,14",
+ "5,15",
+ "5,16"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k8_max/via_json/k8_max_iso_white.json b/keyboards/keychron/k8_max/via_json/k8_max_iso_white.json
new file mode 100644
index 0000000000..ef147553da
--- /dev/null
+++ b/keyboards/keychron/k8_max/via_json/k8_max_iso_white.json
@@ -0,0 +1,231 @@
+{
+ "name": "Keychron K8 Max ISO White",
+ "vendorId": "0x3434",
+ "productId": "0x0A84",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ "0,4",
+ "0,5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ "0,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,14",
+ "0,15",
+ "0,16"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,13",
+ {
+ "x": 0.25
+ },
+ "1,14",
+ "1,15",
+ "1,16"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,13",
+ {
+ "x": 0.25
+ },
+ "2,14",
+ "2,15",
+ "2,16"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,1",
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 2.75
+ },
+ "4,13",
+ {
+ "x": 1.25,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,10",
+ {
+ "w": 1.25
+ },
+ "5,11",
+ {
+ "w": 1.25
+ },
+ "5,12",
+ {
+ "w": 1.25
+ },
+ "5,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,14",
+ "5,15",
+ "5,16"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k8_max/via_json/k8_max_jis_rgb.json b/keyboards/keychron/k8_max/via_json/k8_max_jis_rgb.json
new file mode 100644
index 0000000000..04e26aeb8b
--- /dev/null
+++ b/keyboards/keychron/k8_max/via_json/k8_max_jis_rgb.json
@@ -0,0 +1,291 @@
+{
+ "name": "Keychron K8 Max JIS RGB",
+ "vendorId": "0x3434",
+ "productId": "0x0A82",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ "0,4",
+ "0,5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ "0,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,14",
+ "0,15",
+ "0,16"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ "0,1",
+ "1,13",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "1,14",
+ "1,15",
+ "1,16"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,13",
+ {
+ "x": 0.25
+ },
+ "2,14",
+ "2,15",
+ "2,16"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,13",
+ {
+ "x": 1.25,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ "5,3",
+ {
+ "c": "#cccccc",
+ "w": 4.5
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,9",
+ {
+ "w": 1.25
+ },
+ "5,10",
+ {
+ "w": 1.25
+ },
+ "5,11",
+ {
+ "w": 1.25
+ },
+ "5,12",
+ {
+ "w": 1.25
+ },
+ "5,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,14",
+ "5,15",
+ "5,16"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/k8_max/via_json/k8_max_jis_white.json b/keyboards/keychron/k8_max/via_json/k8_max_jis_white.json
new file mode 100644
index 0000000000..937ba1e448
--- /dev/null
+++ b/keyboards/keychron/k8_max/via_json/k8_max_jis_white.json
@@ -0,0 +1,230 @@
+{
+ "name": "Keychron K8 Max JIS White",
+ "vendorId": "0x3434",
+ "productId": "0x0A85",
+ "keycodes": ["qmk_lighting"],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ "0,4",
+ "0,5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11",
+ "0,12",
+ "0,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,14",
+ "0,15",
+ "0,16"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ "0,1",
+ "1,13",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "1,14",
+ "1,15",
+ "1,16"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,13",
+ {
+ "x": 0.25
+ },
+ "2,14",
+ "2,15",
+ "2,16"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,13"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,13",
+ {
+ "x": 1.25,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ "5,3",
+ {
+ "c": "#cccccc",
+ "w": 4.5
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,9",
+ {
+ "w": 1.25
+ },
+ "5,10",
+ {
+ "w": 1.25
+ },
+ "5,11",
+ {
+ "w": 1.25
+ },
+ "5,12",
+ {
+ "w": 1.25
+ },
+ "5,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5,14",
+ "5,15",
+ "5,16"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/q0_max/board.h b/keyboards/keychron/q0_max/board.h
new file mode 100644
index 0000000000..006a2998bb
--- /dev/null
+++ b/keyboards/keychron/q0_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT & PIN_PUPDR_PULLUP to avoid FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q0_max/config.h b/keyboards/keychron/q0_max/config.h
new file mode 100644
index 0000000000..26041e68fa
--- /dev/null
+++ b/keyboards/keychron/q0_max/config.h
@@ -0,0 +1,80 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN A2
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B0
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B1
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN C11
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 3
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 0, 1, 2 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_BL_TRIG_KEY KC_PMNS
+
+#define BL_CYCLE_KEY KC_MPLY
+#define FN_Z_KEY RGB_SAD
+#define FN_J_KEY RGB_HUD
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q0_max/encoder/config.h b/keyboards/keychron/q0_max/encoder/config.h
new file mode 100644
index 0000000000..0bf58f5da7
--- /dev/null
+++ b/keyboards/keychron/q0_max/encoder/config.h
@@ -0,0 +1,44 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 26
+# define DRIVER_CS_PINS \
+ { A3 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x9A, 0x9A, 0x9A, 0x9A, 0x9A, 0x9A, 0x9A, 0x9A, 0x9A, 0x9A, 0x9A, 0x9A }
+
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define NUM_LOCK_INDEX 5
+# define LOW_BAT_IND_INDEX \
+ { 24 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+#endif
diff --git a/keyboards/keychron/q0_max/encoder/encoder.c b/keyboards/keychron/q0_max/encoder/encoder.c
new file mode 100644
index 0000000000..dc61f22c54
--- /dev/null
+++ b/keyboards/keychron/q0_max/encoder/encoder.c
@@ -0,0 +1,94 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3 },
+ { 4, 5, 6, 7, 8 },
+ { 9, 10, 11, 12, 13 },
+ { 14, 15, 16, 17, __ },
+ { 18, 19, 20, 21, 22 },
+ { 23, 24, __, 25, __ }
+
+ },
+ {
+ // LED Index to Physical Position
+ {102, 0},{117, 0}, {132, 0}, {147, 0},
+ {87,15}, {102,15},{117,15}, {132,15}, {147,15},
+ {87,26}, {102,26},{117,26}, {132,26}, {147,32},
+ {87,38}, {102,38},{117,38}, {132,38},
+ {87,49}, {102,49},{117,49}, {132,49}, {147,55},
+ {87,61}, {110,61}, {132,61},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1,
+ 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1,
+ 1, 1, 1, 1,
+ 1, 1, 1, 1, 1,
+ 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/q0_max/encoder/keyboard.json b/keyboards/keychron/q0_max/encoder/keyboard.json
new file mode 100644
index 0000000000..6b2747e73b
--- /dev/null
+++ b/keyboards/keychron/q0_max/encoder/keyboard.json
@@ -0,0 +1,44 @@
+{
+ "usb": {
+ "pid": "0x0800",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_tenkey_27": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1.25, "y": 1.25},
+ {"matrix": [1, 2], "x": 2.25, "y": 1.25},
+ {"matrix": [1, 3], "x": 3.25, "y": 1.25},
+ {"matrix": [1, 4], "x": 4.25, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25},
+ {"matrix": [2, 1], "x": 1.25, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.25, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.25, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.25, "y": 2.25, "h": 2},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25},
+ {"matrix": [3, 1], "x": 1.25, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.25, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25,"h": 2},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25},
+ {"matrix": [5, 1], "x": 1.25,"y": 5.25, "w": 2},
+ {"matrix": [5, 3], "x": 3.25,"y": 5.25},
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q0_max/encoder/keymaps/default/keymap.c b/keyboards/keychron/q0_max/encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..ec9c04eb62
--- /dev/null
+++ b/keyboards/keychron/q0_max/encoder/keymaps/default/keymap.c
@@ -0,0 +1,76 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ BASE,
+ FN,
+ L2,
+ L3,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [BASE] = LAYOUT_tenkey_27(
+ KC_MUTE, KC_ESC, KC_DEL, KC_TAB, KC_BSPC,
+ MC_1, KC_NUM, KC_PSLS,KC_PAST,KC_PMNS,
+ MC_2, KC_P7, KC_P8, KC_P9, KC_PPLS,
+ MC_3, KC_P4, KC_P5, KC_P6,
+ MC_4, KC_P1, KC_P2, KC_P3, KC_PENT,
+ MO(FN), KC_P0, KC_PDOT ),
+
+ [FN] = LAYOUT_tenkey_27(
+ RGB_TOG, BT_HST1, BT_HST2, BT_HST3, P2P4G,
+ _______, RGB_MOD, RGB_VAI, RGB_HUI, _______,
+ _______, RGB_RMOD,RGB_VAD, RGB_HUD, _______,
+ _______, RGB_SAI, RGB_SPI, KC_MPRV,
+ _______, RGB_SAD, RGB_SPD, KC_MPLY, _______,
+ _______, RGB_TOG, KC_MNXT ),
+
+ [L2] = LAYOUT_tenkey_27(
+ _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______,
+ _______, _______, _______, _______,
+ _______, _______, _______, _______, _______,
+ _______, _______, _______ ),
+
+ [L3] = LAYOUT_tenkey_27(
+ _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______,
+ _______, _______, _______, _______,
+ _______, _______, _______, _______, _______,
+ _______, _______, _______ )
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [L2] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [L3] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q0_max/encoder/rules.mk b/keyboards/keychron/q0_max/encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q0_max/encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q0_max/halconf.h b/keyboards/keychron/q0_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/q0_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q0_max/info.json b/keyboards/keychron/q0_max/info.json
new file mode 100644
index 0000000000..dc8a885ce4
--- /dev/null
+++ b/keyboards/keychron/q0_max/info.json
@@ -0,0 +1,77 @@
+{
+ "keyboard_name": "Keychron Q0 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "Joe",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : false,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "sendstring" : true
+ },
+ "matrix_pins": {
+ "cols": ["B15", "C6", "C7", "C8", "C9"],
+ "rows": ["B6", "B5", "B4", "B3", "D2", "C12"]
+ },
+ "diode_direction": "ROW2COL",
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B13",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "bootmagic": {
+ "matrix": [0, 1]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q0_max/mcuconf.h b/keyboards/keychron/q0_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/q0_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q0_max/q0_max.c b/keyboards/keychron/q0_max/q0_max.c
new file mode 100644
index 0000000000..f72b8441c5
--- /dev/null
+++ b/keyboards/keychron/q0_max/q0_max.c
@@ -0,0 +1,50 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q0_max/readme.md b/keyboards/keychron/q0_max/readme.md
new file mode 100644
index 0000000000..a20fac3462
--- /dev/null
+++ b/keyboards/keychron/q0_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron Q0 Max
+
+
+
+A customizable number keypad.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q0 Max
+* Hardware Availability: [Keychron Q0 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q0-max-qmk-custom-number-pad)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q0_max/encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q0_max/encoder:default:flash
+
+**Reset Key**: Disconnect the USB cable, toggle mode switch to "Cable", hold down the *O* key or reset button underneath *0*, then connect the USB cable.
+
+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).
diff --git a/keyboards/keychron/q0_max/rules.mk b/keyboards/keychron/q0_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q0_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q0_max/via_json/q0_max_encoder.json b/keyboards/keychron/q0_max/via_json/q0_max_encoder.json
new file mode 100644
index 0000000000..f225749ef5
--- /dev/null
+++ b/keyboards/keychron/q0_max/via_json/q0_max_encoder.json
@@ -0,0 +1,137 @@
+{
+ "name": "Keychron Q0 Max Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0800",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "matrix": {"rows": 6, "cols": 5},
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control, availabe in macOS", "shortName": "MCtrl"},
+ {"name": "Launch pad", "title": "Launch pad, availabe in macOS", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"}
+ ],
+ "layouts": {
+ "keymap":[
+ [
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {"x": 0.25},
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4"
+ ],
+ [
+ {"y": 0.25},
+ "1,0",
+ {"x": 0.25},
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4"
+ ],
+ [
+ "2,0",
+ {"x": 0.25},
+ "2,1",
+ "2,2",
+ "2,3",
+ {"h": 2},
+ "2,4"
+ ],
+ [
+ "3,0",
+ {"x": 0.25},
+ "3,1",
+ "3,2",
+ "3,3"
+ ],
+ [
+ "4,0",
+ {"x": 0.25},
+ "4,1",
+ "4,2",
+ "4,3",
+ {"h": 2},
+ "4,4"
+ ],
+ [
+ "5,0",
+ {"x": 0.25, "w": 2},
+ "5,1",
+ "5,3"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q10_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/q10_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..183825f8bb
--- /dev/null
+++ b/keyboards/keychron/q10_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,156 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA15, CB4_CA15, CB5_CA15},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {0, CB12_CA1, CB10_CA1, CB11_CA1},
+ {0, CB12_CA2, CB10_CA2, CB11_CA2},
+ {0, CB12_CA3, CB10_CA3, CB11_CA3},
+ {0, CB12_CA4, CB10_CA4, CB11_CA4},
+ {0, CB12_CA5, CB10_CA5, CB11_CA5},
+ {0, CB12_CA6, CB10_CA6, CB11_CA6},
+ {0, CB12_CA7, CB10_CA7, CB11_CA7},
+ {0, CB12_CA8, CB10_CA8, CB11_CA8},
+ {0, CB12_CA9, CB10_CA9, CB11_CA9},
+ {0, CB12_CA10, CB10_CA10, CB11_CA10},
+ {0, CB12_CA11, CB10_CA11, CB11_CA11},
+ {0, CB12_CA12, CB10_CA12, CB11_CA12},
+ {0, CB12_CA13, CB10_CA13, CB11_CA13},
+ {0, CB12_CA14, CB10_CA14, CB11_CA14},
+ {0, CB12_CA15, CB10_CA15, CB11_CA15},
+ {0, CB12_CA16, CB10_CA16, CB11_CA16},
+
+ {0, CB3_CA1, CB1_CA1, CB2_CA1},
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA14, CB1_CA14, CB2_CA14},
+ {0, CB3_CA15, CB1_CA15, CB2_CA15},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA13, CB1_CA13, CB2_CA13},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA2, CB1_CA2, CB2_CA2},
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB9_CA15, CB7_CA15, CB8_CA15},
+ {1, CB9_CA13, CB7_CA13, CB8_CA13},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA9, CB4_CA9, CB5_CA9},
+ {1, CB6_CA8, CB4_CA8, CB5_CA8},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46 },
+ { 47, 48, 49, 50, 51, 52, 53, __, 54, 55, 56, 57, 58, 59, 60, 61 },
+ { 62, 63, __, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76 },
+ { 77, 78, 79, 80, 81, __, __, 82, 83, 84, 85, __, __, 86, 87, 88 },
+ },
+ {
+ // LED Index to Physical Position
+ {19, 0}, {34, 0}, {46, 0}, {59, 1}, {71, 3}, {86, 6}, { 98, 8}, {121, 8}, {133, 6}, {147, 3}, {159, 1}, {173, 0}, {185, 0}, {203, 0}, {220, 0},
+ {5,14}, {24,14}, {36,14}, {48,13}, {61,15}, {73,17}, {85,20}, { 97,22}, {116,22}, {128,20}, {140,17}, {152,15}, {165,13}, {177,14}, {195,14}, {220,14},
+ {4,24}, {24,24}, {40,24}, {53,24}, {65,27}, {77,29}, {89,31}, {113,33}, {125,31}, {137,29}, {149,26}, {161,24}, {174,24}, {186,24}, {201,24}, {222,24},
+ {2,34}, {23,34}, {40,34}, {53,35}, {65,37}, {77,39}, {89,42}, {118,42}, {130,40}, {142,38}, {154,36}, {167,34}, {179,34}, {199,34}, {224,35},
+ {0,45}, {24,45}, {44,45}, {57,46}, {69,48}, {81,51}, { 93,53}, {112,54}, {124,52}, {136,50}, {148,48}, {160,46}, {173,45}, {190,45}, {210,47},
+ {0,55}, {18,55}, {33,55}, {56,57}, {77,61}, { 96,64}, {125,63}, {147,58}, {159,56}, {198,58}, {210,58}, {222,58}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/q10_max/ansi_encoder/config.h b/keyboards/keychron/q10_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..8641ee6f55
--- /dev/null
+++ b/keyboards/keychron/q10_max/ansi_encoder/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 89
+# define DRIVER_CS_PINS \
+ { B8, B10 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x32, 0x32, 0x32, 0x32, 0x32, 0x32, 0x32, 0x32, 0x32, 0x32, 0x32, 0x32 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 48
+# define LOW_BAT_IND_INDEX \
+ { 81, 83 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q10_max/ansi_encoder/keyboard.json b/keyboards/keychron/q10_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..ab173b0fbb
--- /dev/null
+++ b/keyboards/keychron/q10_max/ansi_encoder/keyboard.json
@@ -0,0 +1,107 @@
+{
+ "usb": {
+ "pid": "0x08A0",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_90": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.5, "y": 0},
+ {"matrix": [0, 2], "x": 2.75, "y": 0},
+ {"matrix": [0, 3], "x": 3.75, "y": 0},
+ {"matrix": [0, 4], "x": 4.75, "y": 0},
+ {"matrix": [0, 5], "x": 5.75, "y": 0.25},
+ {"matrix": [0, 6], "x": 7, "y": 0.5},
+ {"matrix": [0, 7], "x": 8, "y": 0.75},
+ {"matrix": [0, 8], "x": 9.75, "y": 0.75},
+ {"matrix": [0, 9], "x": 10.75, "y": 0.5},
+ {"matrix": [0, 10], "x": 12, "y": 0.25},
+ {"matrix": [0, 11], "x": 13, "y": 0},
+ {"matrix": [0, 12], "x": 14, "y": 0},
+ {"matrix": [0, 13], "x": 15, "y": 0},
+ {"matrix": [0, 14], "x": 16.5, "y": 0},
+ {"matrix": [0, 15], "x": 18, "y": 0},
+
+ {"matrix": [1, 0], "x": 0.5, "y": 1.25},
+ {"matrix": [1, 1], "x": 2, "y": 1.25},
+ {"matrix": [1, 2], "x": 3, "y": 1.25},
+ {"matrix": [1, 3], "x": 4, "y": 1.25},
+ {"matrix": [1, 4], "x": 5, "y": 1.5},
+ {"matrix": [1, 5], "x": 6, "y": 1.75},
+ {"matrix": [1, 6], "x": 7, "y": 2},
+ {"matrix": [1, 7], "x": 8, "y": 2},
+ {"matrix": [1, 8], "x": 9.5, "y": 2},
+ {"matrix": [1, 9], "x": 10.5, "y": 2},
+ {"matrix": [1, 10], "x": 11.5, "y": 1.75},
+ {"matrix": [1, 11], "x": 12.5, "y": 1.5},
+ {"matrix": [1, 12], "x": 13.5, "y": 1.25},
+ {"matrix": [1, 13], "x": 14.5, "y": 1.25},
+ {"matrix": [1, 14], "x": 15.5, "y": 1.25, "w": 2},
+ {"matrix": [1, 15], "x": 18, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0.25, "y": 2.25},
+ {"matrix": [2, 1], "x": 1.75, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 2], "x": 3.25, "y": 2.25},
+ {"matrix": [2, 3], "x": 4.25, "y": 2.25},
+ {"matrix": [2, 4], "x": 5.25, "y": 2.5},
+ {"matrix": [2, 5], "x": 6.25, "y": 2.75},
+ {"matrix": [2, 6], "x": 7.25, "y": 3},
+ {"matrix": [2, 7], "x": 9.25, "y": 3.25},
+ {"matrix": [2, 8], "x": 10.25, "y": 3},
+ {"matrix": [2, 9], "x": 11.25, "y": 2.75},
+ {"matrix": [2, 10], "x": 12.25, "y": 2.5},
+ {"matrix": [2, 11], "x": 13, "y": 2.25},
+ {"matrix": [2, 12], "x": 14.25, "y": 2.25},
+ {"matrix": [2, 13], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 14], "x": 16.25, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 15], "x": 18, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0.25, "y": 3.25},
+ {"matrix": [3, 1], "x": 1.5, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 2], "x": 3.25, "y": 3.25},
+ {"matrix": [3, 3], "x": 4.25, "y": 3.5},
+ {"matrix": [3, 4], "x": 5.25, "y": 3.5},
+ {"matrix": [3, 5], "x": 6.25, "y": 3.75},
+ {"matrix": [3, 6], "x": 7.25, "y": 4},
+ {"matrix": [3, 8], "x": 9.75, "y": 4},
+ {"matrix": [3, 9], "x": 10.5, "y": 4},
+ {"matrix": [3, 10], "x": 11.5, "y": 3.75},
+ {"matrix": [3, 11], "x": 12.5, "y": 3.5},
+ {"matrix": [3, 12], "x": 13.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 14.75, "y": 3.25},
+ {"matrix": [3, 14], "x": 15.75, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 15], "x": 18.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 3], "x": 3.5, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.75, "y": 4.5},
+ {"matrix": [4, 5], "x": 5.5, "y": 4.75},
+ {"matrix": [4, 6], "x": 6.5, "y": 4.75},
+ {"matrix": [4, 7], "x": 7.5, "y": 5},
+ {"matrix": [4, 8], "x": 9, "y": 5.25},
+ {"matrix": [4, 9], "x": 10, "y": 5},
+ {"matrix": [4, 10], "x": 11, "y": 4.75},
+ {"matrix": [4, 11], "x": 12, "y": 4.5},
+ {"matrix": [4, 12], "x": 13, "y": 4.5},
+ {"matrix": [4, 13], "x": 14, "y": 4.25},
+ {"matrix": [4, 14], "x": 15, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 15], "x": 17.25, "y": 4.5},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 3], "x": 4.5, "y": 5.5, "w": 1.25},
+ {"matrix": [5, 4], "x": 5.75, "y": 5.75, "w": 2.25},
+ {"matrix": [5, 7], "x": 7.75, "y": 6.25},
+ {"matrix": [5, 8], "x": 9.25, "y": 6, "w": 2.75},
+ {"matrix": [5, 9], "x": 12, "y": 5.75},
+ {"matrix": [5, 10], "x": 13, "y": 5.5},
+ {"matrix": [5, 13], "x": 16.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 17.25, "y": 5.5},
+ {"matrix": [5, 15], "x": 18.25, "y": 5.5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q10_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/q10_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..efe5c59111
--- /dev/null
+++ b/keyboards/keychron/q10_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_90(
+ KC_MUTE, KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN), KC_SPC, KC_RCMMD, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_90(
+ RGB_TOG, _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_90(
+ KC_MUTE, 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_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN), KC_SPC, KC_RALT, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_90(
+ RGB_TOG, _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)}
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q10_max/ansi_encoder/rules.mk b/keyboards/keychron/q10_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q10_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q10_max/board.h b/keyboards/keychron/q10_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/q10_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q10_max/config.h b/keyboards/keychron/q10_max/config.h
new file mode 100644
index 0000000000..a06ceb8836
--- /dev/null
+++ b/keyboards/keychron/q10_max/config.h
@@ -0,0 +1,79 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B9
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN C14
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+#define FN_BL_TRIG_KEY KC_END
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q10_max/halconf.h b/keyboards/keychron/q10_max/halconf.h
new file mode 100644
index 0000000000..a44392b3a4
--- /dev/null
+++ b/keyboards/keychron/q10_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 Keychron
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see .
+ */
+
+#pragma once
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q10_max/info.json b/keyboards/keychron/q10_max/info.json
new file mode 100644
index 0000000000..479623c13b
--- /dev/null
+++ b/keyboards/keychron/q10_max/info.json
@@ -0,0 +1,80 @@
+{
+ "keyboard_name": "Keychron Q10 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string": true
+ },
+ "matrix_pins": {
+ "cols": ["C7", "C8", "C9", "A8", "A15", "C10", "C11", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "bootmagic": {
+ "matrix": [0, 1]
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B14",
+ "pin_b": "B15"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["B7"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q10_max/iso_encoder/config.h b/keyboards/keychron/q10_max/iso_encoder/config.h
new file mode 100644
index 0000000000..26c6980a5e
--- /dev/null
+++ b/keyboards/keychron/q10_max/iso_encoder/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 90
+# define DRIVER_CS_PINS \
+ { B8, B10 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x32, 0x32, 0x32, 0x32, 0x32, 0x32, 0x32, 0x32, 0x32, 0x32, 0x32, 0x32 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 48
+# define LOW_BAT_IND_INDEX \
+ { 82, 84 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q10_max/iso_encoder/iso_encoder.c b/keyboards/keychron/q10_max/iso_encoder/iso_encoder.c
new file mode 100644
index 0000000000..6583245033
--- /dev/null
+++ b/keyboards/keychron/q10_max/iso_encoder/iso_encoder.c
@@ -0,0 +1,157 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB6_CA2, CB4_CA2, CB5_CA2},
+ {0, CB6_CA3, CB4_CA3, CB5_CA3},
+ {0, CB6_CA4, CB4_CA4, CB5_CA4},
+ {0, CB6_CA5, CB4_CA5, CB5_CA5},
+ {0, CB6_CA6, CB4_CA6, CB5_CA6},
+ {0, CB6_CA7, CB4_CA7, CB5_CA7},
+ {0, CB6_CA8, CB4_CA8, CB5_CA8},
+ {0, CB6_CA9, CB4_CA9, CB5_CA9},
+ {0, CB6_CA10, CB4_CA10, CB5_CA10},
+ {0, CB6_CA11, CB4_CA11, CB5_CA11},
+ {0, CB6_CA12, CB4_CA12, CB5_CA12},
+ {0, CB6_CA13, CB4_CA13, CB5_CA13},
+ {0, CB6_CA14, CB4_CA14, CB5_CA14},
+ {0, CB6_CA15, CB4_CA15, CB5_CA15},
+ {0, CB6_CA16, CB4_CA16, CB5_CA16},
+
+ {0, CB12_CA1, CB10_CA1, CB11_CA1},
+ {0, CB12_CA2, CB10_CA2, CB11_CA2},
+ {0, CB12_CA3, CB10_CA3, CB11_CA3},
+ {0, CB12_CA4, CB10_CA4, CB11_CA4},
+ {0, CB12_CA5, CB10_CA5, CB11_CA5},
+ {0, CB12_CA6, CB10_CA6, CB11_CA6},
+ {0, CB12_CA7, CB10_CA7, CB11_CA7},
+ {0, CB12_CA8, CB10_CA8, CB11_CA8},
+ {0, CB12_CA9, CB10_CA9, CB11_CA9},
+ {0, CB12_CA10, CB10_CA10, CB11_CA10},
+ {0, CB12_CA11, CB10_CA11, CB11_CA11},
+ {0, CB12_CA12, CB10_CA12, CB11_CA12},
+ {0, CB12_CA13, CB10_CA13, CB11_CA13},
+ {0, CB12_CA14, CB10_CA14, CB11_CA14},
+ {0, CB12_CA15, CB10_CA15, CB11_CA15},
+ {0, CB12_CA16, CB10_CA16, CB11_CA16},
+
+ {0, CB3_CA1, CB1_CA1, CB2_CA1},
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA14, CB1_CA14, CB2_CA14},
+ {0, CB3_CA15, CB1_CA15, CB2_CA15},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB3_CA16, CB1_CA16, CB2_CA16},
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA13, CB1_CA13, CB2_CA13},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA2, CB1_CA2, CB2_CA2},
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+
+ {1, CB9_CA16, CB7_CA16, CB8_CA16},
+ {1, CB9_CA15, CB7_CA15, CB8_CA15},
+ {1, CB9_CA14, CB7_CA14, CB8_CA14},
+ {1, CB9_CA13, CB7_CA13, CB8_CA13},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+
+ {1, CB6_CA16, CB4_CA16, CB5_CA16},
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA9, CB4_CA9, CB5_CA9},
+ {1, CB6_CA8, CB4_CA8, CB5_CA8},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46 },
+ { 47, 48, 49, 50, 51, 52, 53, __, 54, 55, 56, 57, 58, 59, 60, 61 },
+ { 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77 },
+ { 78, 79, 80, 81, 82, __, __, 83, 84, 85, 86, __, __, 87, 88, 89 },
+ },
+ {
+ // LED Index to Physical Position
+ {19, 0}, {34, 0}, {46, 0}, {59, 1}, {71, 3}, {86, 6}, { 98, 8}, {121, 8}, {133, 6}, {147, 3}, {159, 1}, {173, 0}, {185, 0}, {203, 0}, {220, 0},
+ {5,14}, {24,14}, {36,14}, {48,13}, {61,15}, {73,17}, {85,20}, { 97,22}, {116,22}, {128,20}, {140,17}, {152,15}, {165,13}, {177,14}, {195,14}, {220,14},
+ {4,24}, {24,24}, {40,24}, {53,24}, {65,27}, {77,29}, {89,31}, {113,33}, {125,31}, {137,29}, {149,26}, {161,24}, {174,24}, {186,24}, {201,24}, {222,24},
+ {2,34}, {23,34}, {40,34}, {53,35}, {65,37}, {77,39}, {89,42}, {118,42}, {130,40}, {142,38}, {154,36}, {167,34}, {179,34}, {199,34}, {224,35},
+ {0,45}, {20,45}, {31,45}, {44,45}, {57,46}, {69,48}, {81,51}, { 93,53}, {112,54}, {124,52}, {136,50}, {148,48}, {160,46}, {173,45}, {190,45}, {210,47},
+ {0,55}, {18,55}, {33,55}, {56,57}, {77,61}, { 96,64}, {125,63}, {147,58}, {159,56}, {198,58}, {210,58}, {222,58}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/q10_max/iso_encoder/keyboard.json b/keyboards/keychron/q10_max/iso_encoder/keyboard.json
new file mode 100644
index 0000000000..067dc6405a
--- /dev/null
+++ b/keyboards/keychron/q10_max/iso_encoder/keyboard.json
@@ -0,0 +1,108 @@
+{
+ "usb": {
+ "pid": "0x08A1",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_iso_91": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.5, "y": 0},
+ {"matrix": [0, 2], "x": 2.75, "y": 0},
+ {"matrix": [0, 3], "x": 3.75, "y": 0},
+ {"matrix": [0, 4], "x": 4.75, "y": 0},
+ {"matrix": [0, 5], "x": 5.75, "y": 0.25},
+ {"matrix": [0, 6], "x": 7, "y": 0.5},
+ {"matrix": [0, 7], "x": 8, "y": 0.75},
+ {"matrix": [0, 8], "x": 9.75, "y": 0.75},
+ {"matrix": [0, 9], "x": 10.75, "y": 0.5},
+ {"matrix": [0, 10], "x": 12, "y": 0.25},
+ {"matrix": [0, 11], "x": 13, "y": 0},
+ {"matrix": [0, 12], "x": 14, "y": 0},
+ {"matrix": [0, 13], "x": 15, "y": 0},
+ {"matrix": [0, 14], "x": 16.5, "y": 0},
+ {"matrix": [0, 15], "x": 18, "y": 0},
+
+ {"matrix": [1, 0], "x": 0.5, "y": 1.25},
+ {"matrix": [1, 1], "x": 2, "y": 1.25},
+ {"matrix": [1, 2], "x": 3, "y": 1.25},
+ {"matrix": [1, 3], "x": 4, "y": 1.25},
+ {"matrix": [1, 4], "x": 5, "y": 1.5},
+ {"matrix": [1, 5], "x": 6, "y": 1.75},
+ {"matrix": [1, 6], "x": 7, "y": 2},
+ {"matrix": [1, 7], "x": 8, "y": 2},
+ {"matrix": [1, 8], "x": 9.5, "y": 2},
+ {"matrix": [1, 9], "x": 10.5, "y": 2},
+ {"matrix": [1, 10], "x": 11.5, "y": 1.75},
+ {"matrix": [1, 11], "x": 12.5, "y": 1.5},
+ {"matrix": [1, 12], "x": 13.5, "y": 1.25},
+ {"matrix": [1, 13], "x": 14.5, "y": 1.25},
+ {"matrix": [1, 14], "x": 15.5, "y": 1.25, "w": 2},
+ {"matrix": [1, 15], "x": 18, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0.25, "y": 2.25},
+ {"matrix": [2, 1], "x": 1.75, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 2], "x": 3.25, "y": 2.25},
+ {"matrix": [2, 3], "x": 4.25, "y": 2.25},
+ {"matrix": [2, 4], "x": 5.25, "y": 2.5},
+ {"matrix": [2, 5], "x": 6.25, "y": 2.75},
+ {"matrix": [2, 6], "x": 7.25, "y": 3},
+ {"matrix": [2, 7], "x": 9.25, "y": 3.25},
+ {"matrix": [2, 8], "x": 10.25, "y": 3},
+ {"matrix": [2, 9], "x": 11.25, "y": 2.75},
+ {"matrix": [2, 10], "x": 12.25, "y": 2.5},
+ {"matrix": [2, 11], "x": 13, "y": 2.25},
+ {"matrix": [2, 12], "x": 14.25, "y": 2.25},
+ {"matrix": [2, 13], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 18, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0.25, "y": 3.25},
+ {"matrix": [3, 1], "x": 1.5, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 2], "x": 3.25, "y": 3.25},
+ {"matrix": [3, 3], "x": 4.25, "y": 3.5},
+ {"matrix": [3, 4], "x": 5.25, "y": 3.5},
+ {"matrix": [3, 5], "x": 6.25, "y": 3.75},
+ {"matrix": [3, 6], "x": 7.25, "y": 4},
+ {"matrix": [3, 8], "x": 9.75, "y": 4},
+ {"matrix": [3, 9], "x": 10.5, "y": 4},
+ {"matrix": [3, 10], "x": 11.5, "y": 3.75},
+ {"matrix": [3, 11], "x": 12.5, "y": 3.5},
+ {"matrix": [3, 12], "x": 13.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 14.75, "y": 3.25},
+ {"matrix": [3, 14], "x": 15.75, "y": 3.25},
+ {"matrix": [2, 14], "x": 16.75, "y": 2.25, "w": 1.5, "h": 2},
+ {"matrix": [3, 15], "x": 18.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 2], "x": 2.5, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.5, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.75, "y": 4.5},
+ {"matrix": [4, 5], "x": 5.5, "y": 4.75},
+ {"matrix": [4, 6], "x": 6.5, "y": 4.75},
+ {"matrix": [4, 7], "x": 7.5, "y": 5},
+ {"matrix": [4, 8], "x": 9, "y": 5.25},
+ {"matrix": [4, 9], "x": 10, "y": 5},
+ {"matrix": [4, 10], "x": 11, "y": 4.75},
+ {"matrix": [4, 11], "x": 12, "y": 4.5},
+ {"matrix": [4, 12], "x": 13, "y": 4.5},
+ {"matrix": [4, 13], "x": 14, "y": 4.25},
+ {"matrix": [4, 14], "x": 15, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 15], "x": 17.25, "y": 4.5},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 3], "x": 4.5, "y": 5.5, "w": 1.25},
+ {"matrix": [5, 4], "x": 5.75, "y": 5.75, "w": 2.25},
+ {"matrix": [5, 7], "x": 7.75, "y": 6.25},
+ {"matrix": [5, 8], "x": 9.25, "y": 6, "w": 2.75},
+ {"matrix": [5, 9], "x": 12, "y": 5.75},
+ {"matrix": [5, 10], "x": 13, "y": 5.5},
+ {"matrix": [5, 13], "x": 16.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 17.25, "y": 5.5},
+ {"matrix": [5, 15], "x": 18.25, "y": 5.5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q10_max/iso_encoder/keymaps/default/keymap.c b/keyboards/keychron/q10_max/iso_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..8b2ede195e
--- /dev/null
+++ b/keyboards/keychron/q10_max/iso_encoder/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_91(
+ KC_MUTE, KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_NUBS, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN), KC_SPC, KC_RCMMD, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_91(
+ RGB_TOG, _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_91(
+ KC_MUTE, 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_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_NUBS, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN), KC_SPC, KC_RALT, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_91(
+ RGB_TOG, _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)}
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q10_max/iso_encoder/rules.mk b/keyboards/keychron/q10_max/iso_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q10_max/iso_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q10_max/mcuconf.h b/keyboards/keychron/q10_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/q10_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q10_max/q10_max.c b/keyboards/keychron/q10_max/q10_max.c
new file mode 100644
index 0000000000..19e1c4b0cc
--- /dev/null
+++ b/keyboards/keychron/q10_max/q10_max.c
@@ -0,0 +1,61 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 2 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q10_max/readme.md b/keyboards/keychron/q10_max/readme.md
new file mode 100644
index 0000000000..d0981dbdf2
--- /dev/null
+++ b/keyboards/keychron/q10_max/readme.md
@@ -0,0 +1,23 @@
+# Keychron Q10 Max
+
+
+
+A customizable 75% ergonomic keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q10 Max
+* Hardware Availability: [Keychron Q10 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q10-max-alice-layout-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q10_max/ansi_encoder:default
+ make keychron/q10_max/iso_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q10_max/ansi_encoder:default:flash
+ make keychron/q10_max/iso_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q10_max/rules.mk b/keyboards/keychron/q10_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q10_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q10_max/via_json/q10_max_ansi_encoder.json b/keyboards/keychron/q10_max/via_json/q10_max_ansi_encoder.json
new file mode 100644
index 0000000000..977b994775
--- /dev/null
+++ b/keyboards/keychron/q10_max/via_json/q10_max_ansi_encoder.json
@@ -0,0 +1,406 @@
+{
+ "name": "Keychron Q10 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x08A0",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "x": 0.5
+ },
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.5,
+ "c": "#777777"
+ },
+ "0,1\nESC",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ {
+ "x": 9.35
+ },
+ "0,12",
+ "0,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,15"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 0.75,
+ "c": "#aaaaaa"
+ },
+ "1,0",
+ {
+ "x": 0.5
+ },
+ "1,1",
+ {
+ "c": "#cccccc"
+ },
+ "1,2",
+ "1,3",
+ {
+ "x": 8.65
+ },
+ "1,12",
+ "1,13",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,14",
+ {
+ "x": 0.6
+ },
+ "1,15"
+ ],
+ [
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "2,0",
+ {
+ "x": 0.5,
+ "w": 1.5
+ },
+ "2,1",
+ {
+ "c": "#cccccc"
+ },
+ "2,2",
+ {
+ "x": 9.9
+ },
+ "2,12",
+ "2,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "2,14",
+ {
+ "x": 0.5
+ },
+ "2,15"
+ ],
+ [
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "3,0",
+ {
+ "x": 0.5,
+ "w": 1.75
+ },
+ "3,1",
+ {
+ "c": "#cccccc"
+ },
+ "3,2",
+ {
+ "x": 9.6
+ },
+ "3,12",
+ "3,13",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,14",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "4,0",
+ {
+ "x": 0.5,
+ "w": 2.25
+ },
+ "4,1",
+ {
+ "c": "#cccccc"
+ },
+ "4,3",
+ {
+ "x": 9.95
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,14"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 17.7,
+ "c": "#cccccc"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "y": -0.25,
+ "c": "#aaaaaa"
+ },
+ "5,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.7,
+ "c": "#cccccc"
+ },
+ "5,13",
+ "5,14",
+ "5,15"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -7.05,
+ "x": 5.4,
+ "c": "#cccccc"
+ },
+ "0,4",
+ "0,5",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,6",
+ "0,7"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 5.55,
+ "c": "#cccccc"
+ },
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7"
+ ],
+ [
+ {
+ "x": 4.9
+ },
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6"
+ ],
+ [
+ {
+ "x": 5
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6"
+ ],
+ [
+ {
+ "x": 5.35
+ },
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7"
+ ],
+ [
+ {
+ "x": 5.35,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,3",
+ {
+ "w": 2.25
+ },
+ "5,4",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,7"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -4.25,
+ "x": 10.05
+ },
+ "0,8",
+ "0,9",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 9.4,
+ "c": "#cccccc"
+ },
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11"
+ ],
+ [
+ {
+ "x": 8.9
+ },
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11"
+ ],
+ [
+ {
+ "x": 9.4
+ },
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 8.85
+ },
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12"
+ ],
+ [
+ {
+ "x": 8.85,
+ "w": 2.55,
+ "c": "#aaaaaa"
+ },
+ "5,8",
+ "5,9",
+ "5,10"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q10_max/via_json/q10_max_iso_encoder.json b/keyboards/keychron/q10_max/via_json/q10_max_iso_encoder.json
new file mode 100644
index 0000000000..5d6e6edf27
--- /dev/null
+++ b/keyboards/keychron/q10_max/via_json/q10_max_iso_encoder.json
@@ -0,0 +1,399 @@
+{
+ "name": "Keychron Q10 Max ISO knob",
+ "vendorId": "0x3434",
+ "productId": "0x08A1",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.5,
+ "c": "#777777"
+ },
+ "0,1\nESC",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ {
+ "x": 9.35
+ },
+ "0,12",
+ "0,13",
+ {
+ "x": 0.45,
+ "c": "#aaaaaa"
+ },
+ "0,14",
+ {
+ "x": 0.45
+ },
+ "0,15"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 0.75
+ },
+ "1,0",
+ {
+ "x": 0.5
+ },
+ "1,1",
+ {
+ "c": "#cccccc"
+ },
+ "1,2",
+ "1,3",
+ {
+ "x": 8.65
+ },
+ "1,12",
+ "1,13",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,14",
+ {
+ "x": 0.6
+ },
+ "1,15"
+ ],
+ [
+ {
+ "x": 0.5
+ },
+ "2,0",
+ {
+ "x": 0.5,
+ "w": 1.5
+ },
+ "2,1",
+ {
+ "c": "#cccccc"
+ },
+ "2,2",
+ {
+ "x": 10.25
+ },
+ "2,12",
+ "2,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,14",
+ {
+ "x": 0.45
+ },
+ "2,15"
+ ],
+ [
+ {
+ "x": 0.25
+ },
+ "3,0",
+ {
+ "x": 0.5,
+ "w": 1.75
+ },
+ "3,1",
+ {
+ "c": "#cccccc"
+ },
+ "3,2",
+ {
+ "x": 9.5
+ },
+ "3,12",
+ "3,13",
+ "3,14",
+ {
+ "x": 1.9,
+ "c": "#aaaaaa"
+ },
+ "3,15"
+ ],
+ [
+ "4,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "4,1",
+ "4,2",
+ {
+ "c": "#cccccc"
+ },
+ "4,3",
+ {
+ "x": 9.75
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,14"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 17.5,
+ "c": "#777777"
+ },
+ "4,15"
+ ],
+ [
+ {
+ "y": -0.25,
+ "c": "#aaaaaa"
+ },
+ "5,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.5,
+ "c": "#777777"
+ },
+ "5,13",
+ "5,14",
+ "5,15"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -7.05,
+ "x": 5.4,
+ "c": "#cccccc"
+ },
+ "0,4",
+ "0,5",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,6",
+ "0,7"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 5.55,
+ "c": "#cccccc"
+ },
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7"
+ ],
+ [
+ {
+ "x": 4.9
+ },
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6"
+ ],
+ [
+ {
+ "x": 5
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6"
+ ],
+ [
+ {
+ "x": 5.35
+ },
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7"
+ ],
+ [
+ {
+ "x": 5.35,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,3",
+ {
+ "w": 2.25
+ },
+ "5,4",
+ "5,7"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -4.25,
+ "x": 10.05
+ },
+ "0,8",
+ "0,9",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 9.4
+ },
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11"
+ ],
+ [
+ {
+ "x": 8.9
+ },
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11"
+ ],
+ [
+ {
+ "x": 9.4
+ },
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 8.85
+ },
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12"
+ ],
+ [
+ {
+ "x": 8.85,
+ "c": "#aaaaaa",
+ "w": 2.55
+ },
+ "5,8",
+ "5,9",
+ "5,10"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q12_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/q12_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..83765f7114
--- /dev/null
+++ b/keyboards/keychron/q12_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,169 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+
+ {1, CB10_CA11, CB12_CA11, CB11_CA11},
+ {1, CB10_CA12, CB12_CA12, CB11_CA12},
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+
+ {1, CB10_CA13, CB12_CA13, CB11_CA13},
+ {1, CB10_CA14, CB12_CA14, CB11_CA14},
+ {1, CB10_CA15, CB12_CA15, CB11_CA15},
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+
+ {1, CB10_CA16, CB12_CA16, CB11_CA16},
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17 },
+ { 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36 },
+ { 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55 },
+ { 56, 57, 58, __, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, __ },
+ { 73, 74, 75, 76, 77, __, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, __ },
+ { __, 90, 91, __, 92, 93, 94, __, __, __, 95, __, __, 96, 97, 98, 99,100, 101},
+ },
+ {
+ // LED Index to Physical Position
+ {10, 0}, {20, 0}, {30, 0}, {47, 0}, {62, 0}, {73, 0}, {84, 0}, {95, 0}, {110,0}, {120, 0}, {131, 0}, {142, 0}, {155, 0}, {166, 0}, {177,0}, {190, 0}, {205,0}, {224,0},
+ {0,15}, {10,15}, {20,15}, {30,15}, {47,15}, {58,15}, {69,15}, {80,15}, {91,15}, {102,15},{113,15}, {124,15}, {135,15}, {146,15}, {157,15}, {168,15}, {179,15}, {200,15}, {224,15},
+ {0,26}, {10,26}, {20,26}, {30,32}, {49,26}, {64,26}, {75,26}, {86,26}, {97,26}, {108,26},{119,26}, {130,26}, {141,26}, {152,26}, {163,26}, {174,26}, {185,26}, {205,26}, {224,26},
+ {0,38}, {10,38}, {20,38}, {52,38}, {68,38}, {79,38}, {90,38}, {101,38},{112,38},{123,38}, {134,38}, {145,38}, {156,38}, {167,38}, {178,38}, {197,38}, {224,38},
+ {0,49}, {10,49}, {20,49}, {30,55}, {55,49}, {73,49}, {84,49}, {95,49}, {106,49},{117,49}, {128,49}, {139,49}, {151,49}, {162,49}, {173,49}, {190,49}, {210,51},
+ {5,61}, {20,61}, {48,61}, {62,61}, {79,61}, {117,61}, {159,61}, {170,64}, {182,61}, {198,63}, {210,63}, {224,63}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/q12_max/ansi_encoder/config.h b/keyboards/keychron/q12_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..17e20e5bf6
--- /dev/null
+++ b/keyboards/keychron/q12_max/ansi_encoder/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 102
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 59
+# define NUM_LOCK_INDEX 18
+# define LOW_BAT_IND_INDEX \
+ { 95 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q12_max/ansi_encoder/keyboard.json b/keyboards/keychron/q12_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..8613ba43b8
--- /dev/null
+++ b/keyboards/keychron/q12_max/ansi_encoder/keyboard.json
@@ -0,0 +1,120 @@
+{
+ "usb": {
+ "pid": "0x08C3",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_103": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15, "y": 0},
+ {"matrix": [0, 15], "x": 16, "y": 0},
+ {"matrix": [0, 16], "x": 17, "y": 0},
+ {"matrix": [0, 17], "x": 18.25, "y": 0},
+ {"matrix": [0, 18], "x": 19.5, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4.25, "y": 1.25},
+ {"matrix": [1, 5], "x": 5.25, "y": 1.25},
+ {"matrix": [1, 6], "x": 6.25, "y": 1.25},
+ {"matrix": [1, 7], "x": 7.25, "y": 1.25},
+ {"matrix": [1, 8], "x": 8.25, "y": 1.25},
+ {"matrix": [1, 9], "x": 9.25, "y": 1.25},
+ {"matrix": [1, 10], "x": 10.25, "y": 1.25},
+ {"matrix": [1, 11], "x": 11.25, "y": 1.25},
+ {"matrix": [1, 12], "x": 12.25, "y": 1.25},
+ {"matrix": [1, 13], "x": 13.25, "y": 1.25},
+ {"matrix": [1, 14], "x": 14.25, "y": 1.25},
+ {"matrix": [1, 15], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 16], "x": 16.25, "y": 1.25},
+ {"matrix": [1, 17], "x": 17.25, "y": 1.25, "w": 2},
+ {"matrix": [1, 18], "x": 19.5, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25},
+ {"matrix": [2, 1], "x": 1, "y": 2.25},
+ {"matrix": [2, 2], "x": 2, "y": 2.25},
+ {"matrix": [2, 3], "x": 3, "y": 2.25, "h": 2},
+ {"matrix": [2, 4], "x": 4.25, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 5], "x": 5.75, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.75, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.75, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.75, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.75, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.75, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.75, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.75, "y": 2.25},
+ {"matrix": [2, 13], "x": 13.75, "y": 2.25},
+ {"matrix": [2, 14], "x": 14.75, "y": 2.25},
+ {"matrix": [2, 15], "x": 15.75, "y": 1.25},
+ {"matrix": [2, 16], "x": 16.75, "y": 1.25},
+ {"matrix": [2, 17], "x": 17.75, "y": 1.25, "w": 1.5},
+ {"matrix": [2, 18], "x": 19.5, "y": 1.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25},
+ {"matrix": [3, 1], "x": 1, "y": 3.25},
+ {"matrix": [3, 2], "x": 2, "y": 3.25},
+ {"matrix": [3, 4], "x": 3.25, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 5], "x": 5, "y": 3.25},
+ {"matrix": [3, 6], "x": 6, "y": 3.25},
+ {"matrix": [3, 7], "x": 7, "y": 3.25},
+ {"matrix": [3, 8], "x": 8, "y": 3.25},
+ {"matrix": [3, 9], "x": 9, "y": 3.25},
+ {"matrix": [3, 10], "x": 10, "y": 3.25},
+ {"matrix": [3, 11], "x": 11, "y": 3.25},
+ {"matrix": [3, 12], "x": 12, "y": 3.25},
+ {"matrix": [3, 13], "x": 13, "y": 3.25},
+ {"matrix": [3, 14], "x": 14, "y": 3.25},
+ {"matrix": [3, 15], "x": 16, "y": 3.25},
+ {"matrix": [3, 16], "x": 17, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 17], "x": 19.5, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25},
+ {"matrix": [4, 1], "x": 1, "y": 4.25},
+ {"matrix": [4, 2], "x": 2, "y": 4.25},
+ {"matrix": [4, 3], "x": 3, "y": 4.25, "h": 2},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 6], "x": 6.5, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.5, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.5, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.5, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.5, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.5, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.5, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 13], "x": 13.5, "y": 4.5},
+ {"matrix": [4, 14], "x": 14.5, "y": 4.25},
+ {"matrix": [4, 15], "x": 15.5, "y": 4.25},
+ {"matrix": [4, 16], "x": 16.5, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 17], "x": 18.5, "y": 4.5},
+
+ {"matrix": [5, 1], "x": 0, "y": 5.25, "w": 2},
+ {"matrix": [5, 2], "x": 2, "y": 5.25},
+ {"matrix": [5, 4], "x": 4.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 5], "x": 5.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 6.75, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 10], "x": 8, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 13], "x": 14.25, "y": 5.25},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.25},
+ {"matrix": [5, 15], "x": 16.25, "y": 5.25},
+ {"matrix": [5, 16], "x": 17.5, "y": 5.5},
+ {"matrix": [5, 17], "x": 18.5, "y": 5.5},
+ {"matrix": [5, 18], "x": 19.5, "y": 5.5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q12_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/q12_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..f801ff3b32
--- /dev/null
+++ b/keyboards/keychron/q12_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,76 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_103(
+ KC_MUTE, KC_F14, KC_F15, KC_F16, KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, RGB_MOD,
+ KC_NUM, KC_PSLS, KC_PAST, KC_PMNS, 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_PGUP,
+ KC_P7, KC_P8, KC_P9, KC_PPLS, 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_PGDN,
+ KC_P4, KC_P5, KC_P6, 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_HOME,
+ KC_P1, KC_P2, KC_P3, KC_PENT, 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_P0, KC_PDOT, KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_103(
+ _______, _______, _______, _______, _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, RGB_TOG,
+ _______, _______, _______, _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+
+ [WIN_BASE] = LAYOUT_ansi_103(
+ KC_MUTE, _______, _______, _______, 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_DEL, RGB_MOD,
+ KC_NUM, KC_PSLS, KC_PAST, KC_PMNS, 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_PGUP,
+ KC_P7, KC_P8, KC_P9, KC_PPLS, 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_PGDN,
+ KC_P4, KC_P5, KC_P6, 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_HOME,
+ KC_P1, KC_P2, KC_P3, KC_PENT, 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_P0, KC_PDOT, KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_103(
+ _______, _______, _______, _______, _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, _______, _______, _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ )
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q12_max/ansi_encoder/rules.mk b/keyboards/keychron/q12_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q12_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q12_max/board.h b/keyboards/keychron/q12_max/board.h
new file mode 100644
index 0000000000..006a2998bb
--- /dev/null
+++ b/keyboards/keychron/q12_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT & PIN_PUPDR_PULLUP to avoid FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q12_max/config.h b/keyboards/keychron/q12_max/config.h
new file mode 100644
index 0000000000..3923f79fba
--- /dev/null
+++ b/keyboards/keychron/q12_max/config.h
@@ -0,0 +1,79 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 26
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 23, 24, 25 }
+# define BAT_LEVEL_LED_LIST \
+ { 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+#define FN_BL_TRIG_KEY KC_END
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q12_max/halconf.h b/keyboards/keychron/q12_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/q12_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q12_max/info.json b/keyboards/keychron/q12_max/info.json
new file mode 100644
index 0000000000..1a2711c51e
--- /dev/null
+++ b/keyboards/keychron/q12_max/info.json
@@ -0,0 +1,80 @@
+{
+ "keyboard_name": "Keychron Q12 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "Joe",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string": true
+ },
+ "matrix_pins": {
+ "cols": ["A1", "A2", "A3", "B10", "C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "bootmagic": {
+ "matrix": [0, 4]
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B14",
+ "pin_b": "B15"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["B12"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q12_max/mcuconf.h b/keyboards/keychron/q12_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/q12_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q12_max/q12_max.c b/keyboards/keychron/q12_max/q12_max.c
new file mode 100644
index 0000000000..5870790196
--- /dev/null
+++ b/keyboards/keychron/q12_max/q12_max.c
@@ -0,0 +1,61 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#include "keychron_common.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 2 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q12_max/readme.md b/keyboards/keychron/q12_max/readme.md
new file mode 100644
index 0000000000..e592666800
--- /dev/null
+++ b/keyboards/keychron/q12_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron Q12 Max
+
+
+
+A customizable 96% keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q12 Max
+* Hardware Availability: [Keychron Q12 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q12-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q12_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q12_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q12_max/rules.mk b/keyboards/keychron/q12_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q12_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q12_max/via_json/q12_max_ansi_knob.json b/keyboards/keychron/q12_max/via_json/q12_max_ansi_knob.json
new file mode 100644
index 0000000000..386d522bc0
--- /dev/null
+++ b/keyboards/keychron/q12_max/via_json/q12_max_ansi_knob.json
@@ -0,0 +1,337 @@
+{
+ "name": "Keychron Q12 MAX ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x08C3",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 19},
+ "layouts": {
+ "keymap":[
+ [
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ "0,1",
+ "0,2",
+ "0,3",
+ {
+ "x": 0.25,
+ "c": "#777777"
+ },
+ "0,4\nESC",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,9",
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,13",
+ "0,14",
+ "0,15",
+ "0,16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,17",
+ {
+ "x": 0.25
+ },
+ "0,18"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "1,0",
+ "1,1",
+ "1,2",
+ "1,3",
+ {
+ "x": 0.25
+ },
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ "1,13",
+ "1,14",
+ "1,15",
+ "1,16",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,17",
+ {
+ "x": 0.25
+ },
+ "1,18"
+ ],
+ [
+ {
+ "c": "#cccccc"
+ },
+ "2,0",
+ "2,1",
+ "2,2",
+ {
+ "h": 2
+ },
+ "2,3",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,4",
+ {
+ "c": "#cccccc"
+ },
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ "2,13",
+ "2,14",
+ "2,15",
+ "2,16",
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,17",
+ {
+ "x": 0.25
+ },
+ "2,18"
+ ],
+ [
+ {
+ "c": "#cccccc"
+ },
+ "3,0",
+ "3,1",
+ "3,2",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,4",
+ {
+ "c": "#cccccc"
+ },
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,12",
+ "3,13",
+ "3,14",
+ "3,15",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "3,17"
+ ],
+ [
+ {
+ "c": "#cccccc"
+ },
+ "4,0",
+ "4,1",
+ "4,2",
+ {
+ "h": 2
+ },
+ "4,3",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "4,4",
+ {
+ "c": "#cccccc"
+ },
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12",
+ "4,13",
+ "4,14",
+ "4,15",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,16"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 18.5,
+ "c": "#777777"
+ },
+ "4,17"
+ ],
+ [
+ {
+ "y": -0.25,
+ "c": "#cccccc",
+ "w": 2
+ },
+ "5,1",
+ "5,2",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,4",
+ {
+ "w": 1.25
+ },
+ "5,5",
+ {
+ "w": 1.25
+ },
+ "5,6",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,10",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,13",
+ "5,14",
+ "5,15"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 17.5,
+ "c": "#777777"
+ },
+ "5,16",
+ "5,17",
+ "5,18"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q13_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/q13_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..2d046bc722
--- /dev/null
+++ b/keyboards/keychron/q13_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,172 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB10_CA10, CB12_CA10, CB11_CA10},
+ {1, CB10_CA11, CB12_CA11, CB11_CA11},
+ {1, CB10_CA12, CB12_CA12, CB11_CA12},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA8, CB6_CA8, CB5_CA8},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB10_CA5, CB12_CA5, CB11_CA5},
+ {1, CB10_CA6, CB12_CA6, CB11_CA6},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, __, 14, 15, 16, 17 },
+ { 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, __, __, 33, 34, 35, 36 },
+ { 37, 38, 39, 40, 41, 42, 43, __, 44, 45, 46, 47, 48, 49, 50, 51, __, 52, 53, 54, 55 },
+ { 56, 57, 58, 59, 60, 61, 62, __, 63, 64, 65, 66, 67, 68, 69, __, __, 70, 71, 72, __ },
+ { 73, 74, __, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, __, 87, 88, 89, 90, 91 },
+ { 92, 93, 94, __, 95, __, 96, 97, __, 98, __, 99, 100, __, __, 101, 102, 103, 104, 105, __ },
+ },
+ {
+ // LED Index to Physical Position
+ {16, 0}, {29, 0}, {39, 0}, {51, 1}, {61, 3}, {74, 6}, {84, 8}, {103, 8}, {113, 6}, {126, 3}, {136, 1}, {148, 0}, {158, 0}, {175, 0}, {193, 0}, {203, 0}, {214, 0}, {224, 0},
+ {4,14}, {20,14}, {31,14}, {41,13}, {52,15}, {63,17}, {73,20}, {83,22}, { 99,22}, {109,20}, {119,17}, {130,15}, {141,13}, {151,14}, {167,14}, {193,14}, {203,14}, {214,14}, {224,14},
+ {3,24}, {21,24}, {34,24}, {45,24}, {55,27}, {66,29}, {76,31}, { 96,33}, {106,31}, {117,29}, {127,26}, {137,24}, {148,24}, {159,24}, {172,24}, {193,24}, {203,24}, {214,24}, {224,29},
+ {1,34}, {20,34}, {34,34}, {45,35}, {56,37}, {66,39}, {76,42}, {101,42}, {111,40}, {121,38}, {132,36}, {143,34}, {153,34}, {170,34}, {193,34}, {203,34}, {214,34},
+ {0,45}, {20,45}, {37,45}, {48,46}, {59,48}, {69,51}, {79,53}, { 95,54}, {106,52}, {116,50}, {126,48}, {136,46}, {148,45}, {162,45}, {179,47}, {193,45}, {203,45}, {214,45}, {224,50},
+ {0,55}, {15,55}, {28,55}, {48,57}, {66,61}, {82,64}, {107,63}, {126,58}, {136,56}, {169,58}, {179,58}, {190,58}, {203,55}, {214,55}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/q13_max/ansi_encoder/config.h b/keyboards/keychron/q13_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..c52617dfec
--- /dev/null
+++ b/keyboards/keychron/q13_max/ansi_encoder/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 106
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2E, 0x2E, 0x2E, 0x2E, 0x2E, 0x2E, 0x2E, 0x2E, 0x2E, 0x2E, 0x2E, 0x2E }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indication led */
+# define NUM_LOCK_INDEX 33
+# define CAPS_LOCK_INDEX 57
+# define LOW_BAT_IND_INDEX \
+ { 96, 98 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q13_max/ansi_encoder/keyboard.json b/keyboards/keychron/q13_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..409e0d87bb
--- /dev/null
+++ b/keyboards/keychron/q13_max/ansi_encoder/keyboard.json
@@ -0,0 +1,124 @@
+{
+ "usb": {
+ "pid": "0x08D0",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_107": {
+ "layout": [
+ {"matrix":[0,0], "x":0.5, "y":0.55},
+ {"matrix":[0,1], "x":2, "y":0.55},
+ {"matrix":[0,2], "x":3.25, "y":0.55},
+ {"matrix":[0,3], "x":4.25, "y":0.55},
+ {"matrix":[0,4], "x":5.4, "y":0},
+ {"matrix":[0,5], "x":6.4, "y":0},
+ {"matrix":[0,6], "x":7.65, "y":0},
+ {"matrix":[0,7], "x":8.65, "y":0},
+ {"matrix":[0,8], "x":10.05, "y":1.95},
+ {"matrix":[0,9], "x":11.05, "y":1.95},
+ {"matrix":[0,10], "x":12.3, "y":1.95},
+ {"matrix":[0,11], "x":13.3, "y":1.95},
+ {"matrix":[0,12], "x":14.6, "y":0.55},
+ {"matrix":[0,13], "x":15.6, "y":0.55},
+ {"matrix":[0,15], "x":17.05, "y":0.55},
+ {"matrix":[0,17], "x":18.75, "y":0.55},
+ {"matrix":[0,18], "x":19.75, "y":0.55},
+ {"matrix":[0,19], "x":20.75, "y":0.55},
+ {"matrix":[0,20], "x":21.75, "y":0.55},
+
+ {"matrix":[1,0], "x":0.75, "y":1.8},
+ {"matrix":[1,1], "x":2.25, "y":1.8},
+ {"matrix":[1,2], "x":3.25, "y":1.8},
+ {"matrix":[1,3], "x":4.25, "y":1.8},
+ {"matrix":[1,4], "x":5.55, "y":1.25},
+ {"matrix":[1,5], "x":6.55, "y":1.25},
+ {"matrix":[1,6], "x":7.55, "y":1.25},
+ {"matrix":[1,7], "x":8.55, "y":1.25},
+ {"matrix":[1,8], "x":9.4, "y":3.25},
+ {"matrix":[1,9], "x":10.4, "y":3.25},
+ {"matrix":[1,10], "x":11.4, "y":3.25},
+ {"matrix":[1,11], "x":12.4, "y":3.25},
+ {"matrix":[1,12], "x":13.9, "y":1.8},
+ {"matrix":[1,13], "x":14.9, "y":1.8},
+ {"matrix":[1,14], "x":15.9, "y":1.8, "w":2},
+ {"matrix":[1,17], "x":18.75, "y":1.8},
+ {"matrix":[1,18], "x":19.75, "y":1.8},
+ {"matrix":[1,19], "x":20.75, "y":1.8},
+ {"matrix":[1,20], "x":21.75, "y":1.8},
+
+ {"matrix":[2,0], "x":0.5, "y":2.8},
+ {"matrix":[2,1], "x":2, "y":2.8, "w":1.5},
+ {"matrix":[2,2], "x":3.5, "y":2.8},
+ {"matrix":[2,3], "x":4.9, "y":2.25},
+ {"matrix":[2,4], "x":5.9, "y":2.25},
+ {"matrix":[2,5], "x":6.9, "y":2.25},
+ {"matrix":[2,6], "x":7.9, "y":2.25},
+ {"matrix":[2,8], "x":8.9, "y":4.25},
+ {"matrix":[2,9], "x":9.9, "y":4.25},
+ {"matrix":[2,10], "x":10.9, "y":4.25},
+ {"matrix":[2,11], "x":11.9, "y":4.25},
+ {"matrix":[2,12], "x":12.9, "y":4.25},
+ {"matrix":[2,13], "x":14.4, "y":2.8},
+ {"matrix":[2,14], "x":15.4, "y":2.8},
+ {"matrix":[2,15], "x":16.4, "y":2.8, "w":1.75},
+ {"matrix":[2,17], "x":18.75, "y":2.8},
+ {"matrix":[2,18], "x":19.75, "y":2.8},
+ {"matrix":[2,19], "x":20.75, "y":2.8},
+ {"matrix":[2,20], "x":21.75, "y":2.8, "h":2},
+
+ {"matrix":[3,0], "x":0.25, "y":3.8},
+ {"matrix":[3,1], "x":1.75, "y":3.8, "w":1.75},
+ {"matrix":[3,2], "x":3.5, "y":3.8},
+ {"matrix":[3,3], "x":5, "y":3.25},
+ {"matrix":[3,4], "x":6, "y":3.25},
+ {"matrix":[3,5], "x":7, "y":3.25},
+ {"matrix":[3,6], "x":8, "y":3.25},
+ {"matrix":[3,8], "x":9.4, "y":5.25},
+ {"matrix":[3,9], "x":10.4, "y":5.25},
+ {"matrix":[3,10], "x":11.4, "y":5.25},
+ {"matrix":[3,11], "x":12.4, "y":5.25},
+ {"matrix":[3,12], "x":14, "y":3.8},
+ {"matrix":[3,13], "x":15, "y":3.8},
+ {"matrix":[3,14], "x":16, "y":3.8, "w":2.25},
+ {"matrix":[3,17], "x":18.75, "y":3.8},
+ {"matrix":[3,18], "x":19.75, "y":3.8},
+ {"matrix":[3,19], "x":20.75, "y":3.8},
+
+ {"matrix":[4,0], "x":0, "y":4.8},
+ {"matrix":[4,1], "x":1.5, "y":4.8, "w":2.25},
+ {"matrix":[4,3], "x":3.75, "y":4.8},
+ {"matrix":[4,4], "x":5.35, "y":4.25},
+ {"matrix":[4,5], "x":6.35, "y":4.25},
+ {"matrix":[4,6], "x":7.35, "y":4.25},
+ {"matrix":[4,7], "x":8.35, "y":4.25},
+ {"matrix":[4,8], "x":8.85, "y":6.25},
+ {"matrix":[4,9], "x":9.85, "y":6.25},
+ {"matrix":[4,10], "x":10.85, "y":6.25},
+ {"matrix":[4,11], "x":11.85, "y":6.25},
+ {"matrix":[4,12], "x":12.85, "y":6.25},
+ {"matrix":[4,13], "x":14.5, "y":4.8},
+ {"matrix":[4,14], "x":15.5, "y":4.8, "w":1.75},
+ {"matrix":[4,16], "x":17.5, "y":5.05},
+ {"matrix":[4,17], "x":18.75, "y":4.8},
+ {"matrix":[4,18], "x":19.75, "y":4.8},
+ {"matrix":[4,19], "x":20.75, "y":4.8},
+ {"matrix":[4,20], "x":21.75, "y":4.8, "h":2},
+
+ {"matrix":[5,0], "x":0, "y":5.8},
+ {"matrix":[5,1], "x":1.5, "y":5.8, "w":1.25},
+ {"matrix":[5,2], "x":2.75, "y":5.8, "w":1.25},
+ {"matrix":[5,4], "x":5.35, "y":5.25, "w":1.25},
+ {"matrix":[5,6], "x":6.6, "y":5.25, "w":2.25},
+ {"matrix":[5,7], "x":8.85, "y":5.25},
+ {"matrix":[5,9], "x":8.85, "y":7.25, "w":2.55},
+ {"matrix":[5,11], "x":11.4, "y":7.25},
+ {"matrix":[5,12], "x":12.4, "y":7.25},
+ {"matrix":[5,15], "x":16.5, "y":6.05},
+ {"matrix":[5,16], "x":17.5, "y":6.05},
+ {"matrix":[5,17], "x":18.5, "y":6.05},
+ {"matrix":[5,18], "x":19.75, "y":5.8},
+ {"matrix":[5,19], "x":20.75, "y":5.8}
+ ]
+ }
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/q13_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/q13_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..1943c32312
--- /dev/null
+++ b/keyboards/keychron/q13_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_107(
+ KC_MUTE, KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, KC_F13, KC_F14, KC_F15, KC_F16,
+ MC_1, 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_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ MC_2, 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_P7, KC_P8, KC_P9, KC_PPLS,
+ MC_3, 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_P4, KC_P5, KC_P6,
+ MC_4, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_P1, KC_P2, KC_P3, KC_PENT,
+ MC_5, KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN), KC_SPC, KC_RCMMD, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+
+ [MAC_FN] = LAYOUT_ansi_107(
+ RGB_TOG, _______, 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_INS, _______, _______, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+
+ [WIN_BASE] = LAYOUT_ansi_107(
+ KC_MUTE, 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_DEL, _______, _______, _______, _______,
+ MC_1, 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_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ MC_2, 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_P7, KC_P8, KC_P9, KC_PPLS,
+ MC_3, 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_P4, KC_P5, KC_P6,
+ MC_4, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP, KC_P1, KC_P2, KC_P3, KC_PENT,
+ MC_5, KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN), KC_SPC, KC_RALT, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+
+ [WIN_FN] = LAYOUT_ansi_107(
+ RGB_TOG, _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_INS, _______, _______, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)}
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q13_max/ansi_encoder/keymaps/default/rules.mk b/keyboards/keychron/q13_max/ansi_encoder/keymaps/default/rules.mk
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/keyboards/keychron/q13_max/ansi_encoder/rules.mk b/keyboards/keychron/q13_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q13_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q13_max/board.h b/keyboards/keychron/q13_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/q13_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q13_max/config.h b/keyboards/keychron/q13_max/config.h
new file mode 100644
index 0000000000..521cc2ed53
--- /dev/null
+++ b/keyboards/keychron/q13_max/config.h
@@ -0,0 +1,80 @@
+/* Copyright 2024 ~ 2025 @ Keychron(https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 23
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 20, 21, 22 }
+# define BAT_LEVEL_LED_LIST \
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+#define BL_TRIG_KEY KC_DEL
+#define FN_BL_TRIG_KEY KC_INS
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q13_max/halconf.h b/keyboards/keychron/q13_max/halconf.h
new file mode 100644
index 0000000000..f09c01a115
--- /dev/null
+++ b/keyboards/keychron/q13_max/halconf.h
@@ -0,0 +1,30 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+# define HAL_USE_SPI TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q13_max/info.json b/keyboards/keychron/q13_max/info.json
new file mode 100644
index 0000000000..3799661164
--- /dev/null
+++ b/keyboards/keychron/q13_max/info.json
@@ -0,0 +1,80 @@
+{
+ "keyboard_name": "Keychron Q13 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "C5", "B10", "C9"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "bootmagic": {
+ "matrix": [0, 1]
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["A8"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 4096,
+ "backing_size": 8192
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q13_max/mcuconf.h b/keyboards/keychron/q13_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/q13_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q13_max/q13_max.c b/keyboards/keychron/q13_max/q13_max.c
new file mode 100644
index 0000000000..19e1c4b0cc
--- /dev/null
+++ b/keyboards/keychron/q13_max/q13_max.c
@@ -0,0 +1,61 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 2 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q13_max/readme.md b/keyboards/keychron/q13_max/readme.md
new file mode 100644
index 0000000000..8e9aecf9d9
--- /dev/null
+++ b/keyboards/keychron/q13_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron Q13 Max
+
+
+
+A customizable 96% ergonomic keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q13 Max
+* Hardware Availability: [Keychron](https://www.keychron.com/products/keychron-q13-max-alice-layout-qmk-wireless-custom-mechanical-keyboard?srsltid=AfmBOoomwvC2Hj94-pEDTmB30fRi7coZ0ACjkLCG_cB6l-7q-nqHBxZ7)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q13_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q13_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q13_max/rules.mk b/keyboards/keychron/q13_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q13_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q13_max/via_json/q13_max_ansi_encoder.json b/keyboards/keychron/q13_max/via_json/q13_max_ansi_encoder.json
new file mode 100644
index 0000000000..aea9b02e42
--- /dev/null
+++ b/keyboards/keychron/q13_max/via_json/q13_max_ansi_encoder.json
@@ -0,0 +1,431 @@
+{
+ "name": "Keychron Q13 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x08D0",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 21},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "x": 0.5
+ },
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.5,
+ "c": "#777777"
+ },
+ "0,1\nESC",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ {
+ "x": 9.35
+ },
+ "0,12",
+ "0,13",
+ {
+ "x": 0.45,
+ "c": "#aaaaaa"
+ },
+ "0,15",
+ {
+ "x": 0.7,
+ "c": "#cccccc"
+ },
+ "0,17",
+ "0,18",
+ "0,19",
+ "0,20"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 0.75,
+ "c": "#aaaaaa"
+ },
+ "1,0",
+ {
+ "x": 0.5
+ },
+ "1,1",
+ {
+ "c": "#cccccc"
+ },
+ "1,2",
+ "1,3",
+ {
+ "x": 8.65
+ },
+ "1,12",
+ "1,13",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,14",
+ {
+ "x": 0.85,
+ "c": "#cccccc"
+ },
+ "1,17",
+ "1,18",
+ "1,19",
+ "1,20"
+ ],
+ [
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "2,0",
+ {
+ "x": 0.5,
+ "w": 1.5
+ },
+ "2,1",
+ {
+ "c": "#cccccc"
+ },
+ "2,2",
+ {
+ "x": 9.9
+ },
+ "2,13",
+ "2,14",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "2,15",
+ {
+ "x": 0.6,
+ "c": "#cccccc"
+ },
+ "2,17",
+ "2,18",
+ "2,19",
+ {
+ "h": 2
+ },
+ "2,20"
+ ],
+ [
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "3,0",
+ {
+ "x": 0.5,
+ "w": 1.75
+ },
+ "3,1",
+ {
+ "c": "#cccccc"
+ },
+ "3,2",
+ {
+ "x": 9.5
+ },
+ "3,12",
+ "3,13",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,14",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "3,17",
+ "3,18",
+ "3,19"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "4,0",
+ {
+ "x": 0.5,
+ "w": 2.25
+ },
+ "4,1",
+ {
+ "c": "#cccccc"
+ },
+ "4,3",
+ {
+ "x": 9.75
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,14",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "4,16",
+ {
+ "x": 0.25,
+ "y": -0.25
+ },
+ "4,17",
+ "4,18",
+ "4,19",
+ {
+ "h": 2
+ },
+ "4,20"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "5,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "x": 12.5,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "5,15",
+ "5,16",
+ "5,17",
+ {
+ "x": 0.25,
+ "y": -0.25
+ },
+ "5,18",
+ "5,19"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -6.8,
+ "x": 5.4,
+ "c": "#cccccc"
+ },
+ "0,4",
+ "0,5",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,6",
+ "0,7"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 5.55,
+ "c": "#cccccc"
+ },
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7"
+ ],
+ [
+ {
+ "x": 4.9
+ },
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6"
+ ],
+ [
+ {
+ "x": 5
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6"
+ ],
+ [
+ {
+ "x": 5.35
+ },
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7"
+ ],
+ [
+ {
+ "x": 5.35,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,4",
+ {
+ "w": 2.25
+ },
+ "5,6",
+ "5,7"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -4.25,
+ "x": 10.05
+ },
+ "0,8",
+ "0,9",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 9.4
+ },
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11"
+ ],
+ [
+ {
+ "x": 8.9
+ },
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12"
+ ],
+ [
+ {
+ "x": 9.4
+ },
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 8.85
+ },
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12"
+ ],
+ [
+ {
+ "x": 8.85,
+ "c": "#aaaaaa",
+ "w": 2.55
+ },
+ "5,9",
+ "5,11",
+ "5,12"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q14_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/q14_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..2980ad88d6
--- /dev/null
+++ b/keyboards/keychron/q14_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,171 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA8, CB6_CA8, CB5_CA8},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+ {1, CB10_CA5, CB12_CA5, CB11_CA5},
+ {1, CB10_CA6, CB12_CA6, CB11_CA6},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, __, __, 10, 11, 12, 13, 14, 15, 16, 17 },
+ { 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, __, 29, 30, 31, 32, 33, 34, 35, __, 36 },
+ { 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, __, 47, 48, 49, 50, 51, 52, 53, 54, __, 55 },
+ { 56, 57, 58, __, 59, 60, 61, 62, 63, 64, __, 65, 66, 67, 68, 69, 70, 71, __, __, 72 },
+ { 73, 74, 75, 76, 77, __, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, __, 90, __ },
+ { 91, __, 92, __, 93, 94, __, 95, __, 96, 97, __, 98, __, 99,100, __, __,101,102,103 },
+ },
+ {
+ // LED Index to Physical Position
+ {10, 0}, {20, 0}, {30, 0}, {47, 0}, {62, 0}, {73, 0}, {84, 1}, {95, 3}, {107,6}, {117, 8}, {135, 8}, {146, 6}, {158, 2}, {168, 1}, {180,0}, {191, 0}, {206,0}, {221,0},
+ {0,14}, {10,14}, {20,14}, {30,14}, {53,14}, {64,14}, {74,13}, {86,15}, {96,17}, {106,20},{116,22}, {131,22}, {141,20}, {152,17}, {162,15}, {173,13}, {184,14}, {200,14}, {221,14},
+ {0,24}, {10,24}, {20,24}, {30,29}, {53,24}, {66,24}, {78,24}, {88,24}, {99,24}, {109,24},{128,33}, {139,31}, {149,29}, {159,27}, {169,24}, {181,24}, {192,24}, {205,24}, {222,24},
+ {0,34}, {10,34}, {20,34}, {53,34}, {67,34}, {79,35}, {89,37}, {99,39}, {109,42},{133,43}, {143,40}, {154,38}, {164,36}, {176,35}, {186,35}, {203,35}, {224,35},
+ {0,45}, {10,45}, {20,45}, {30,50}, {53,45}, {70,45}, {82,46}, {92,48}, {102,51},{112,53},{128,54}, {138,52}, {148,50}, {158,48}, {169,46}, {180,45}, {195,45}, {212,47},
+ {5,55}, {20,55}, {48,55}, {61,55}, {81,57}, {99,61}, {115,64}, {139,63}, {158,59}, {168,56}, {202,58}, {212,58}, {223,58}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/q14_max/ansi_encoder/config.h b/keyboards/keychron/q14_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..b3d5a9931d
--- /dev/null
+++ b/keyboards/keychron/q14_max/ansi_encoder/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 104
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 59
+# define LOW_BAT_IND_INDEX \
+ { 96, 98 }
+# define NUM_LOCK_INDEX 18
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q14_max/ansi_encoder/keyboard.json b/keyboards/keychron/q14_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..71d8c9bb96
--- /dev/null
+++ b/keyboards/keychron/q14_max/ansi_encoder/keyboard.json
@@ -0,0 +1,122 @@
+{
+ "usb": {
+ "pid": "0x08E0",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_105_ansi": {
+ "layout": [
+ {"matrix":[0,0], "x":0, "y":0.8},
+ {"matrix":[0,1], "x":1, "y":0.8},
+ {"matrix":[0,2], "x":2, "y":0.8},
+ {"matrix":[0,3], "x":3, "y":0.8},
+ {"matrix":[0,4], "x":4.5, "y":0.8},
+ {"matrix":[0,5], "x":6, "y":0.8},
+ {"matrix":[0,6], "x":7, "y":0.8},
+ {"matrix":[0,7], "x":8.25, "y":0},
+ {"matrix":[0,8], "x":9.25, "y":0},
+ {"matrix":[0,9], "x":10.5, "y":0},
+ {"matrix":[0,10], "x":11.5, "y":0},
+ {"matrix":[0,13], "x":12.75, "y":2.6},
+ {"matrix":[0,14], "x":13.75, "y":2.6},
+ {"matrix":[0,15], "x":15, "y":2.6},
+ {"matrix":[0,16], "x":16, "y":2.6},
+ {"matrix":[0,17], "x":17.3, "y":0.8},
+ {"matrix":[0,18], "x":18.3, "y":0.8},
+ {"matrix":[0,19], "x":19.75, "y":0.8},
+ {"matrix":[0,20], "x":21.25, "y":0.8},
+
+ {"matrix":[1,0], "x":0, "y":2.3},
+ {"matrix":[1,1], "x":1, "y":2.3},
+ {"matrix":[1,2], "x":2, "y":2.3},
+ {"matrix":[1,3], "x":3, "y":2.3},
+ {"matrix":[1,4], "x":5.25, "y":2.3},
+ {"matrix":[1,5], "x":6.25, "y":2.3},
+ {"matrix":[1,6], "x":7.25, "y":2.1},
+ {"matrix":[1,7], "x":8.6, "y":1.35},
+ {"matrix":[1,8], "x":9.6, "y":1.35},
+ {"matrix":[1,9], "x":10.6, "y":1.35},
+ {"matrix":[1,10], "x":11.6, "y":1.35},
+ {"matrix":[1,12], "x":12.5, "y":4.0},
+ {"matrix":[1,13], "x":13.5, "y":4.0},
+ {"matrix":[1,14], "x":14.5, "y":4.0},
+ {"matrix":[1,15], "x":15.5, "y":4.0},
+ {"matrix":[1,16], "x":16.95, "y":2.2},
+ {"matrix":[1,17], "x":17.95, "y":2.1},
+ {"matrix":[1,18], "x":18.95, "y":2.2, "w":2},
+ {"matrix":[1,20], "x":21.35, "y":2.2},
+
+ {"matrix":[2,0], "x":0, "y":3.3},
+ {"matrix":[2,1], "x":1, "y":3.3},
+ {"matrix":[2,2], "x":2, "y":3.3},
+ {"matrix":[2,3], "x":3, "y":3.3, "h":2},
+ {"matrix":[2,4], "x":5, "y":3.3, "w":1.5},
+ {"matrix":[2,5], "x":6.5, "y":3.3},
+ {"matrix":[2,6], "x":8.13, "y":2.35},
+ {"matrix":[2,7], "x":9.13, "y":2.335},
+ {"matrix":[2,8], "x":10.13, "y":2.35},
+ {"matrix":[2,9], "x":11.13, "y":2.35},
+ {"matrix":[2,11], "x":12.1, "y":5.0},
+ {"matrix":[2,12], "x":13.1, "y":5.0},
+ {"matrix":[2,13], "x":14.1, "y":5.0},
+ {"matrix":[2,14], "x":15.1, "y":5.0},
+ {"matrix":[2,15], "x":16.1, "y":5.0},
+ {"matrix":[2,16], "x":17.65, "y":3.2},
+ {"matrix":[2,17], "x":18.65, "y":3.2},
+ {"matrix":[2,18], "x":19.65, "y":3.2, "w":1.5},
+ {"matrix":[2,20], "x":21.55, "y":3.2},
+
+ {"matrix":[3,0], "x":0, "y":4.3},
+ {"matrix":[3,1], "x":1, "y":4.3},
+ {"matrix":[3,2], "x":2, "y":4.3},
+ {"matrix":[3,4], "x":4.75, "y":4.3, "w":1.75},
+ {"matrix":[3,5], "x":6.5, "y":4.3},
+ {"matrix":[3,6], "x":8.3, "y":3.35},
+ {"matrix":[3,7], "x":9.3, "y":3.35},
+ {"matrix":[3,8], "x":10.3, "y":3.35},
+ {"matrix":[3,9], "x":11.3, "y":3.35},
+ {"matrix":[3,11], "x":12.45, "y":6.0},
+ {"matrix":[3,12], "x":13.45, "y":6.0},
+ {"matrix":[3,13], "x":14.45, "y":6.0},
+ {"matrix":[3,14], "x":15.45, "y":6.0},
+ {"matrix":[3,15], "x":17.1, "y":4.2},
+ {"matrix":[3,16], "x":18.1, "y":4.2},
+ {"matrix":[3,17], "x":19.1, "y":4.2, "w":2.25},
+ {"matrix":[3,20], "x":21.75, "y":4.2},
+
+ {"matrix":[4,0], "x":0, "y":5.3},
+ {"matrix":[4,1], "x":1, "y":5.3},
+ {"matrix":[4,2], "x":2, "y":5.3},
+ {"matrix":[4,3], "x":3, "y":5.3, "h":2},
+ {"matrix":[4,4], "x":4.5, "y":5.3, "w":2.25},
+ {"matrix":[4,6], "x":6.75, "y":5.3},
+ {"matrix":[4,7], "x":8.65, "y":4.35},
+ {"matrix":[4,8], "x":9.65, "y":4.35},
+ {"matrix":[4,9], "x":10.65, "y":4.35},
+ {"matrix":[4,10], "x":11.65, "y":4.35},
+ {"matrix":[4,11], "x":12, "y":7.0},
+ {"matrix":[4,12], "x":13, "y":7.0},
+ {"matrix":[4,13], "x":14, "y":7.0},
+ {"matrix":[4,14], "x":15, "y":7.0},
+ {"matrix":[4,15], "x":16, "y":7.0},
+ {"matrix":[4,16], "x":17.75, "y":5.2},
+ {"matrix":[4,17], "x":18.75, "y":5.2, "w":1.75},
+ {"matrix":[4,19], "x":20.75, "y":5.55},
+
+ {"matrix":[5,0], "x":0, "y":6.3, "w":2},
+ {"matrix":[5,2], "x":2, "y":6.3},
+ {"matrix":[5,4], "x":4.5, "y":6.3, "w":1.25},
+ {"matrix":[5,5], "x":5.75, "y":6.3, "w":1.25},
+ {"matrix":[5,7], "x":8.75, "y":5.35, "w":1.25},
+ {"matrix":[5,9], "x":10, "y":5.35, "w":2.25},
+ {"matrix":[5,10], "x":12.25, "y":5.35},
+ {"matrix":[5,12], "x":12.05, "y":8.0},
+ {"matrix":[5,14], "x":13.05, "y":8.0, "w":2.75},
+ {"matrix":[5,15], "x":15.8, "y":8.0},
+ {"matrix":[5,18], "x":19.75, "y":6.55},
+ {"matrix":[5,19], "x":20.75, "y":6.55},
+ {"matrix":[5,20], "x":21.75, "y":6.55}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q14_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/q14_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..f62ad1f0bc
--- /dev/null
+++ b/keyboards/keychron/q14_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,73 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers{
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_105_ansi(
+ KC_MUTE, KC_F13, KC_F14, KC_F15, KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, RGB_MOD,
+ KC_NUM, KC_PSLS, KC_PAST, KC_PMNS, 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_PGUP,
+ KC_P7, KC_P8, KC_P9, KC_PPLS, 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_PGDN,
+ KC_P4, KC_P5, KC_P6, 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_HOME,
+ KC_P1, KC_P2, KC_P3, KC_PENT, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_P0, KC_PDOT, KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN), KC_SPC, KC_RCMMD, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+ [MAC_FN] = LAYOUT_105_ansi(
+ RGB_TOG, _______, _______, _______, _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, RGB_TOG,
+ _______, _______, _______, _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+ [WIN_BASE] = LAYOUT_105_ansi(
+ KC_MUTE, _______, _______, _______, 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_DEL, RGB_MOD,
+ KC_NUM, KC_PSLS, KC_PAST, KC_PMNS, 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_PGUP,
+ KC_P7, KC_P8, KC_P9, KC_PPLS, 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_PGDN,
+ KC_P4, KC_P5, KC_P6, 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_HOME,
+ KC_P1, KC_P2, KC_P3, KC_PENT, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_P0, KC_PDOT, KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN), KC_SPC, KC_RALT, KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+ [WIN_FN] = LAYOUT_105_ansi(
+ RGB_TOG, _______, _______, _______, _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, _______, _______, _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q14_max/ansi_encoder/rules.mk b/keyboards/keychron/q14_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q14_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q14_max/board.h b/keyboards/keychron/q14_max/board.h
new file mode 100644
index 0000000000..006a2998bb
--- /dev/null
+++ b/keyboards/keychron/q14_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT & PIN_PUPDR_PULLUP to avoid FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q14_max/config.h b/keyboards/keychron/q14_max/config.h
new file mode 100644
index 0000000000..5a9b43ab60
--- /dev/null
+++ b/keyboards/keychron/q14_max/config.h
@@ -0,0 +1,79 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 26
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 23, 24, 25 }
+# define BAT_LEVEL_LED_LIST \
+ { 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+#define FN_BL_TRIG_KEY KC_END
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q14_max/halconf.h b/keyboards/keychron/q14_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/q14_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q14_max/info.json b/keyboards/keychron/q14_max/info.json
new file mode 100644
index 0000000000..a283451857
--- /dev/null
+++ b/keyboards/keychron/q14_max/info.json
@@ -0,0 +1,81 @@
+{
+ "keyboard_name": "Keychron Q14 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "Keychron",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "sendstring" : true,
+ "console": false
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "C5", "B10", "C9"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["A8"]
+ },
+ "bootmagic": {
+ "matrix": [0, 4]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2096,
+ "backing_size": 4192
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q14_max/mcuconf.h b/keyboards/keychron/q14_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/q14_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q14_max/q14_max.c b/keyboards/keychron/q14_max/q14_max.c
new file mode 100644
index 0000000000..19e1c4b0cc
--- /dev/null
+++ b/keyboards/keychron/q14_max/q14_max.c
@@ -0,0 +1,61 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 2 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q14_max/readme.md b/keyboards/keychron/q14_max/readme.md
new file mode 100644
index 0000000000..de63274a91
--- /dev/null
+++ b/keyboards/keychron/q14_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron Q14 Max
+
+
+
+A customizable 96% Alice layout wireless keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q14 Max
+* Hardware Availability: [Keychron Q14 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q14-max-alice-layout-qmk-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q14_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q14_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q14_max/rules.mk b/keyboards/keychron/q14_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q14_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q14_max/via_json/q14_max_ansi_encoder.json b/keyboards/keychron/q14_max/via_json/q14_max_ansi_encoder.json
new file mode 100644
index 0000000000..01d5e7dad6
--- /dev/null
+++ b/keyboards/keychron/q14_max/via_json/q14_max_ansi_encoder.json
@@ -0,0 +1,466 @@
+{
+ "name": "Keychron Q14 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x08E0",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 21},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "y": 0.8,
+ "c": "#aaaaaa"
+ },
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ {
+ "x": 0.5,
+ "c": "#777777"
+ },
+ "0,4\nESC",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0,5",
+ "0,6",
+ {
+ "x": 9.3
+ },
+ "0,17",
+ "0,18",
+ {
+ "x": 0.45,
+ "c": "#aaaaaa"
+ },
+ "0,19",
+ {
+ "x": 0.5
+ },
+ "0,20"
+ ],
+ [
+ {
+ "y": 0.3,
+ "x": 7.25,
+ "c": "#cccccc"
+ },
+ "1,6",
+ {
+ "x": 9.7
+ },
+ "1,16"
+ ],
+ [
+ {
+ "y": -0.9,
+ "x": 16.95
+ },
+ "1,17",
+ {
+ "x": 1,
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,18",
+ {
+ "x": 0.4
+ },
+ "1,20"
+ ],
+ [
+ {
+ "y": -0.9,
+ "c": "#cccccc"
+ },
+ "1,0",
+ "1,1",
+ "1,2",
+ "1,3",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "1,4",
+ {
+ "c": "#cccccc"
+ },
+ "1,5"
+ ],
+ [
+ {
+ "y": -0.1,
+ "x": 17.65
+ },
+ "2,16",
+ "2,17",
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,18",
+ {
+ "x": 0.4
+ },
+ "2,20"
+ ],
+ [
+ {
+ "y": -0.9,
+ "c": "#cccccc"
+ },
+ "2,0",
+ "2,1",
+ "2,2",
+ {
+ "h": 2
+ },
+ "2,3",
+ {
+ "x": 1,
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,4",
+ {
+ "c": "#cccccc"
+ },
+ "2,5"
+ ],
+ [
+ {
+ "y": -0.1,
+ "x": 17.1
+ },
+ "3,15",
+ "3,16",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,17",
+ {
+ "x": 0.4,
+ "c": "#aaaaaa"
+ },
+ "3,20"
+ ],
+ [
+ {
+ "y": -0.9,
+ "c": "#cccccc"
+ },
+ "3,0",
+ "3,1",
+ "3,2",
+ {
+ "x": 1.75,
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,4",
+ {
+ "c": "#cccccc"
+ },
+ "3,5"
+ ],
+ [
+ {
+ "y": -0.1,
+ "x": 17.75
+ },
+ "4,16",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,17"
+ ],
+ [
+ {
+ "y": -0.9,
+ "c": "#cccccc"
+ },
+ "4,0",
+ "4,1",
+ "4,2",
+ {
+ "h": 2
+ },
+ "4,3",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "4,4",
+ {
+ "c": "#cccccc"
+ },
+ "4,6"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 20.75,
+ "c": "#cccccc"
+ },
+ "4,19"
+ ],
+ [
+ {
+ "y": -0.25,
+ "c": "#cccccc",
+ "w": 2
+ },
+ "5,0",
+ "5,2",
+ {
+ "x": 1.5,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,4",
+ {
+ "w": 1.25
+ },
+ "5,5"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 19.75,
+ "c": "#cccccc"
+ },
+ "5,18",
+ "5,19",
+ "5,20"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -7.55,
+ "x": 8.25,
+ "c": "#cccccc"
+ },
+ "0,7",
+ "0,8",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,9",
+ "0,10"
+ ],
+ [
+ {
+ "y": 0.35,
+ "x": 8.6,
+ "c": "#cccccc"
+ },
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10"
+ ],
+ [
+ {
+ "y": -0.015,
+ "x": 9.13
+ },
+ "2,7"
+ ],
+ [
+ {
+ "y": -0.985,
+ "x": 8.13
+ },
+ "2,6",
+ {
+ "x": 1
+ },
+ "2,8",
+ "2,9"
+ ],
+ [
+ {
+ "x": 8.3
+ },
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9"
+ ],
+ [
+ {
+ "x": 8.65
+ },
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10"
+ ],
+ [
+ {
+ "x": 8.75,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,7",
+ {
+ "w": 2.25
+ },
+ "5,9",
+ "5,10"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -3.75,
+ "x": 12.75
+ },
+ "0,13",
+ "0,14",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,15",
+ "0,16"
+ ],
+ [
+ {
+ "y": 0.4,
+ "x": 12.5
+ },
+ "1,12",
+ "1,13",
+ "1,14",
+ "1,15"
+ ],
+ [
+ {
+ "x": 12.1
+ },
+ "2,11",
+ "2,12",
+ "2,13",
+ "2,14",
+ "2,15"
+ ],
+ [
+ {
+ "x": 12.45
+ },
+ "3,11",
+ "3,12",
+ "3,13",
+ "3,14"
+ ],
+ [
+ {
+ "x": 12
+ },
+ "4,11",
+ "4,12",
+ "4,13",
+ "4,14",
+ "4,15"
+ ],
+ [
+ {
+ "x": 12.05,
+ "w": 2.75,
+ "c": "#aaaaaa"
+ },
+ "5,12",
+ "5,14",
+ "5,15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q15_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/q15_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..6884ed5e85
--- /dev/null
+++ b/keyboards/keychron/q15_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,127 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, __ },
+ { 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25 },
+ { 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, __ },
+ { 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52 },
+ { 53, 54, 55, 56, 57, __, __, 58, __, 59, 60, 61, 62, 63 },
+ },
+ {
+ // LED Index to Physical Position
+ {17,0}, {34,0}, {51,0}, {68,0}, {84,0}, {102,0}, {119,0}, {136,0}, {153,0}, {170,0}, {187,0}, {204,0},
+ {0,16},{17,16},{34,16},{51,16},{68,16},{84,16},{102,16},{119,16},{136,16},{153,16},{170,16},{187,16},{204,16},{220,16},
+ {0,32},{17,32},{34,32},{51,32},{68,32},{84,32},{102,32},{119,32},{136,32},{153,32},{170,32},{187,32}, {212,32},
+ {0,48},{17,48},{34,48},{51,48},{68,48},{84,48},{102,48},{119,48},{136,48},{153,48},{170,48},{187,48},{204,48},{220,48},
+ {0,64},{17,64},{34,64},{51,64},{76,64}, {121,64}, {153,64},{170,64},{187,64},{204,64},{220,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/q15_max/ansi_encoder/config.h b/keyboards/keychron/q15_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..3bd2b5f330
--- /dev/null
+++ b/keyboards/keychron/q15_max/ansi_encoder/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 64
+# define DRIVER_CS_PINS \
+ { B8 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 26
+# define LOW_BAT_IND_INDEX \
+ { 57, 58 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q15_max/ansi_encoder/keyboard.json b/keyboards/keychron/q15_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..c5e5d5c22e
--- /dev/null
+++ b/keyboards/keychron/q15_max/ansi_encoder/keyboard.json
@@ -0,0 +1,82 @@
+{
+ "usb": {
+ "pid": "0x08F0",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_66": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6, "y": 0},
+ {"matrix": [0, 7], "x": 7, "y": 0},
+ {"matrix": [0, 8], "x": 8, "y": 0},
+ {"matrix": [0, 9], "x": 9, "y": 0},
+ {"matrix": [0, 10], "x": 10, "y": 0},
+ {"matrix": [0, 11], "x": 11, "y": 0},
+ {"matrix": [0, 12], "x": 12, "y": 0},
+ {"matrix": [0, 13], "x": 13, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1},
+ {"matrix": [1, 1], "x": 1, "y": 1},
+ {"matrix": [1, 2], "x": 2, "y": 1},
+ {"matrix": [1, 3], "x": 3, "y": 1},
+ {"matrix": [1, 4], "x": 4, "y": 1},
+ {"matrix": [1, 5], "x": 5, "y": 1},
+ {"matrix": [1, 6], "x": 6, "y": 1},
+ {"matrix": [1, 7], "x": 7, "y": 1},
+ {"matrix": [1, 8], "x": 8, "y": 1},
+ {"matrix": [1, 9], "x": 9, "y": 1},
+ {"matrix": [1, 10], "x": 10, "y": 1},
+ {"matrix": [1, 11], "x": 11, "y": 1},
+ {"matrix": [1, 12], "x": 12, "y": 1},
+ {"matrix": [1, 13], "x": 13, "y": 1},
+
+ {"matrix": [2, 0], "x": 0, "y": 2},
+ {"matrix": [2, 1], "x": 1, "y": 2},
+ {"matrix": [2, 2], "x": 2, "y": 2},
+ {"matrix": [2, 3], "x": 3, "y": 2},
+ {"matrix": [2, 4], "x": 4, "y": 2},
+ {"matrix": [2, 5], "x": 5, "y": 2},
+ {"matrix": [2, 6], "x": 6, "y": 2},
+ {"matrix": [2, 7], "x": 7, "y": 2},
+ {"matrix": [2, 8], "x": 8, "y": 2},
+ {"matrix": [2, 9], "x": 9, "y": 2},
+ {"matrix": [2, 10], "x": 10, "y": 2},
+ {"matrix": [2, 11], "x": 11, "y": 2},
+ {"matrix": [2, 12], "x": 12, "y": 2, "w": 2},
+
+ {"matrix": [3, 0], "x": 0, "y": 3},
+ {"matrix": [3, 1], "x": 1, "y": 3},
+ {"matrix": [3, 2], "x": 2, "y": 3},
+ {"matrix": [3, 3], "x": 3, "y": 3},
+ {"matrix": [3, 4], "x": 4, "y": 3},
+ {"matrix": [3, 5], "x": 5, "y": 3},
+ {"matrix": [3, 6], "x": 6, "y": 3},
+ {"matrix": [3, 7], "x": 7, "y": 3},
+ {"matrix": [3, 8], "x": 8, "y": 3},
+ {"matrix": [3, 9], "x": 9, "y": 3},
+ {"matrix": [3, 10], "x": 10, "y": 3},
+ {"matrix": [3, 11], "x": 11, "y": 3},
+ {"matrix": [3, 12], "x": 12, "y": 3},
+ {"matrix": [3, 13], "x": 13, "y": 3},
+
+ {"matrix": [4, 0], "x": 0, "y": 4},
+ {"matrix": [4, 1], "x": 1, "y": 4},
+ {"matrix": [4, 2], "x": 2, "y": 4},
+ {"matrix": [4, 3], "x": 3, "y": 4},
+ {"matrix": [4, 4], "x": 4, "y": 4, "w": 2.25},
+ {"matrix": [4, 7], "x": 6.25, "y": 4, "w": 2.75},
+ {"matrix": [4, 9], "x": 9, "y": 4},
+ {"matrix": [4, 10], "x": 10, "y": 4},
+ {"matrix": [4, 11], "x": 11, "y": 4},
+ {"matrix": [4, 12], "x": 12, "y": 4},
+ {"matrix": [4, 13], "x": 13, "y": 4},
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q15_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/q15_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..b992e93712
--- /dev/null
+++ b/keyboards/keychron/q15_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,82 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN,
+ WIN_FN,
+ COM_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_66(
+ KC_MUTE, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_MINS, KC_BSPC, KC_MUTE,
+ KC_ESC, 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_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_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_DEL,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, _______, KC_SPC, KC_SPC, MO(MAC_FN),MO(COM_FN),KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_BASE] = LAYOUT_ansi_66(
+ KC_MUTE, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_MINS, KC_BSPC, KC_MUTE,
+ KC_ESC, 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_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_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_DEL,
+ KC_LCTL, KC_LGUI, KC_LALT, _______, KC_SPC, KC_SPC, MO(WIN_FN),MO(COM_FN),KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_66(
+ RGB_TOG, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, RGB_TOG,
+ KC_GRV, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_FN] = LAYOUT_ansi_66(
+ RGB_TOG, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, RGB_TOG,
+ KC_GRV, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [COM_FN] = LAYOUT_ansi_66(
+ _______, 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_TILD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][2][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU),ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU),ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI),ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI),ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [COM_FN] = {ENCODER_CCW_CW(_______, _______),ENCODER_CCW_CW(_______, _______)},
+};
+
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q15_max/ansi_encoder/rules.mk b/keyboards/keychron/q15_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q15_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q15_max/board.h b/keyboards/keychron/q15_max/board.h
new file mode 100644
index 0000000000..006a2998bb
--- /dev/null
+++ b/keyboards/keychron/q15_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT & PIN_PUPDR_PULLUP to avoid FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q15_max/config.h b/keyboards/keychron/q15_max/config.h
new file mode 100644
index 0000000000..3cd0746add
--- /dev/null
+++ b/keyboards/keychron/q15_max/config.h
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN A3
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 16
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 13, 14, 15 }
+# define BAT_LEVEL_LED_LIST \
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(4)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q15_max/halconf.h b/keyboards/keychron/q15_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/q15_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q15_max/info.json b/keyboards/keychron/q15_max/info.json
new file mode 100644
index 0000000000..eaf9241792
--- /dev/null
+++ b/keyboards/keychron/q15_max/info.json
@@ -0,0 +1,87 @@
+{
+ "keyboard_name": "Keychron Q15 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "Keychron",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "sendstring" : true
+ },
+ "matrix_pins": {
+ "cols": ["B10", "B12", "B13", "B14", "B15", "C9", "A8", "A13", "A14", "A15", "C10", "C11", "C12", "C2"],
+ "rows": ["D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch" :{
+ "pins": ["C6"]
+ },
+ "dynamic_keymap": {
+ "layer_count": 5
+ },
+ "bootmagic": {
+ "matrix": [1, 0]
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "C7",
+ "pin_b": "C8"
+ },
+ {
+ "pin_a": "C14",
+ "pin_b": "C13"
+ }
+ ]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q15_max/mcuconf.h b/keyboards/keychron/q15_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/q15_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q15_max/q15_max.c b/keyboards/keychron/q15_max/q15_max.c
new file mode 100644
index 0000000000..b7aa2b1513
--- /dev/null
+++ b/keyboards/keychron/q15_max/q15_max.c
@@ -0,0 +1,61 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 1));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q15_max/readme.md b/keyboards/keychron/q15_max/readme.md
new file mode 100644
index 0000000000..7d09459148
--- /dev/null
+++ b/keyboards/keychron/q15_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron Q15 Max
+
+
+
+An Ortholinear keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q15 Max
+* Hardware Availability: [Keychron Q15 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q15-max-qmk-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q15_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q15_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q15_max/rules.mk b/keyboards/keychron/q15_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q15_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q15_max/via_json/q15_max_ansi_encoder.json b/keyboards/keychron/q15_max/via_json/q15_max_ansi_encoder.json
new file mode 100644
index 0000000000..641d328c7a
--- /dev/null
+++ b/keyboards/keychron/q15_max/via_json/q15_max_ansi_encoder.json
@@ -0,0 +1,223 @@
+{
+ "name": "Keychron Q15 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x08F0",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control, availabe in macOS", "shortName": "MCtrl"},
+ {"name": "Launch pad", "title": "Launch pad, availabe in macOS", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"},
+ {"name": "~", "title": "~", "shortName": "~"}
+ ],
+ "matrix": {"rows": 5, "cols": 14},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c":"#aaaaaa"
+ },
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "c":"#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ "0,10",
+ "0,11",
+ {
+ "c":"#aaaaaa"
+ },
+ "0,12",
+ "0,13\n\n\n\n\n\n\n\n\ne1",
+ {
+ "c":"#cccccc"
+ }
+ ],
+ [
+ {
+ "c":"#777777"
+ },
+ "1,0",
+ {
+ "c":"#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c":"#aaaaaa"
+ },
+ "1,13"
+ ],
+ [
+ "2,0",
+ {
+ "c":"#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ {
+ "c":"#777777",
+ "w": 2
+ },
+ "2,12"
+ ],
+ [
+ {
+ "c":"#aaaaaa"
+ },
+ "3,0",
+ {
+ "c":"#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ {
+ "c":"#aaaaaa"
+ },
+ "3,11",
+ {
+ "c":"#cccccc"
+ },
+ "3,12",
+ {
+ "c":"#aaaaaa"
+ },
+ "3,13"
+ ],
+ [
+ "4,0",
+ "4,1",
+ "4,2",
+ "4,3",
+ {
+ "c":"#cccccc",
+ "w": 2.25
+ },
+ "4,4",
+ {
+ "w": 2.75
+ },
+ "4,7",
+ {
+ "c":"#aaaaaa"
+ },
+ "4,9",
+ "4,10",
+ {
+ "c":"#cccccc"
+ },
+ "4,11",
+ "4,12",
+ "4,13"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q1_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/q1_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..6d46641509
--- /dev/null
+++ b/keyboards/keychron/q1_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,148 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43 },
+ { 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __ },
+ { 58, __, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, __, 69, 70 },
+ { 71, 72, 73, __, __, __, 74, __, __, 75, 76, 77, 78, 79, 80 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {18, 0}, {33, 0}, {48, 0}, {62, 0}, {81, 0}, {95, 0}, {110, 0}, {125, 0}, {143, 0}, {158, 0}, {172, 0}, {187, 0}, {205, 0},
+ {0,15}, {15,15}, {29,15}, {44,15}, {59,15}, {73,15}, {88,15}, {103,15}, {117,15}, {132,15}, {146,15}, {161,15}, {176,15}, {198,15}, {224,15},
+ {4,26}, {22,26}, {37,26}, {51,26}, {66,26}, {81,26}, {95,26}, {110,26}, {125,26}, {139,26}, {154,26}, {168,26}, {183,26}, {201,26}, {224,26},
+ {6,38}, {26,38}, {40,38}, {55,38}, {70,38}, {84,38}, {99,38}, {114,38}, {128,38}, {143,38}, {158,38}, {172,38}, {196,38}, {224,38},
+ {6,49}, {33,49}, {48,49}, {62,49}, {77,49}, {92,49}, {106,49}, {121,49}, {136,49}, {150,49}, {165,49}, {185,49}, {209,52},
+ {2,61}, {20,61}, {38,61}, {94,61}, {147,61}, {161,61}, {176,61}, {195,64}, {209,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/q1_max/ansi_encoder/config.h b/keyboards/keychron/q1_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..78577d2fe3
--- /dev/null
+++ b/keyboards/keychron/q1_max/ansi_encoder/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 81
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 44
+# define LOW_BAT_IND_INDEX \
+ { 74 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q1_max/ansi_encoder/keyboard.json b/keyboards/keychron/q1_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..48881c605b
--- /dev/null
+++ b/keyboards/keychron/q1_max/ansi_encoder/keyboard.json
@@ -0,0 +1,99 @@
+{
+ "usb": {
+ "pid": "0x0810",
+ "device_version": "1.0.2"
+ },
+ "layouts": {
+ "LAYOUT_ansi_82": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 13], "x": 13.5, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 13], "x": 15.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 12.25, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 14], "x": 14.25, "y": 4.5},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 9], "x": 10, "y": 5.25},
+ {"matrix": [5, 10], "x": 11, "y": 5.25},
+ {"matrix": [5, 11], "x": 12, "y": 5.25},
+ {"matrix": [5, 12], "x": 13.25, "y": 5.5},
+ {"matrix": [5, 13], "x": 14.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q1_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/q1_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..129989ea1b
--- /dev/null
+++ b/keyboards/keychron/q1_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_82(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, KC_MUTE,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_82(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_82(
+ 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_DEL, KC_MUTE,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_82(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q1_max/ansi_encoder/rules.mk b/keyboards/keychron/q1_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q1_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q1_max/board.h b/keyboards/keychron/q1_max/board.h
new file mode 100644
index 0000000000..dcf619eba2
--- /dev/null
+++ b/keyboards/keychron/q1_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT & PIN_PUPDR_PULLUP to avoid FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q1_max/config.h b/keyboards/keychron/q1_max/config.h
new file mode 100644
index 0000000000..3417fbff96
--- /dev/null
+++ b/keyboards/keychron/q1_max/config.h
@@ -0,0 +1,79 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 18
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 15, 16, 17 }
+# define BAT_LEVEL_LED_LIST \
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+#define FN_BL_TRIG_KEY KC_END
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q1_max/halconf.h b/keyboards/keychron/q1_max/halconf.h
new file mode 100644
index 0000000000..8c0d5caeb4
--- /dev/null
+++ b/keyboards/keychron/q1_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q1_max/info.json b/keyboards/keychron/q1_max/info.json
new file mode 100644
index 0000000000..06b955f9a6
--- /dev/null
+++ b/keyboards/keychron/q1_max/info.json
@@ -0,0 +1,77 @@
+{
+ "keyboard_name": "Keychron Q1 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string" : true
+ },
+ "matrix_pins": {
+ "cols": ["C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B14",
+ "pin_b": "B15"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["B12"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q1_max/iso_encoder/config.h b/keyboards/keychron/q1_max/iso_encoder/config.h
new file mode 100644
index 0000000000..f672169832
--- /dev/null
+++ b/keyboards/keychron/q1_max/iso_encoder/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 82
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 44
+# define LOW_BAT_IND_INDEX \
+ { 75 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q1_max/iso_encoder/iso_encoder.c b/keyboards/keychron/q1_max/iso_encoder/iso_encoder.c
new file mode 100644
index 0000000000..76de60f553
--- /dev/null
+++ b/keyboards/keychron/q1_max/iso_encoder/iso_encoder.c
@@ -0,0 +1,149 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43 },
+ { 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __ },
+ { 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, __, 70, 71 },
+ { 72, 73, 74, __, __, __, 75, __, __, 76, 77, 78, 79, 80, 81 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {18, 0}, {33, 0}, {48, 0}, {62, 0}, {81, 0}, {95, 0}, {110, 0}, {125, 0}, {143, 0}, {158, 0}, {172, 0}, {187, 0}, {205, 0},
+ {0,15}, {15,15}, {29,15}, {44,15}, {59,15}, {73,15}, {88,15}, {103,15}, {117,15}, {132,15}, {146,15}, {161,15}, {176,15}, {198,15}, {224,15},
+ {4,26}, {22,26}, {37,26}, {51,26}, {66,26}, {81,26}, {95,26}, {110,26}, {125,26}, {139,26}, {154,26}, {168,26}, {183,26}, {203,32}, {224,26},
+ {6,38}, {26,38}, {40,38}, {55,38}, {70,38}, {84,38}, {99,38}, {114,38}, {128,38}, {143,38}, {158,38}, {172,38}, {187,38}, {224,38},
+ {2,49}, {18,49}, {33,49}, {48,49}, {62,49}, {77,49}, {92,49}, {106,49}, {121,49}, {136,49}, {150,49}, {165,49}, {185,49}, {209,52},
+ {2,61}, {20,61}, {38,61}, {94,61}, {147,61}, {161,61}, {176,61}, {195,64}, {209,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/q1_max/iso_encoder/keyboard.json b/keyboards/keychron/q1_max/iso_encoder/keyboard.json
new file mode 100644
index 0000000000..82fb828ffe
--- /dev/null
+++ b/keyboards/keychron/q1_max/iso_encoder/keyboard.json
@@ -0,0 +1,100 @@
+{
+ "usb": {
+ "pid": "0x0811",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_iso_83": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25},
+ {"matrix": [2, 13], "x": 13.25, "y": 2.75, "w": 1.25, "h": 2},
+ {"matrix": [3, 13], "x": 15.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 12.25, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 14], "x": 14.25, "y": 4.5},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 9], "x": 10, "y": 5.25},
+ {"matrix": [5, 10], "x": 11, "y": 5.25},
+ {"matrix": [5, 11], "x": 12, "y": 5.25},
+ {"matrix": [5, 12], "x": 13.25, "y": 5.5},
+ {"matrix": [5, 13], "x": 14.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q1_max/iso_encoder/keymaps/default/keymap.c b/keyboards/keychron/q1_max/iso_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..cb212e81d1
--- /dev/null
+++ b/keyboards/keychron/q1_max/iso_encoder/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_83(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, KC_MUTE,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_83(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_83(
+ 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_DEL, KC_MUTE,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_83(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q1_max/iso_encoder/rules.mk b/keyboards/keychron/q1_max/iso_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q1_max/iso_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q1_max/jis_encoder/config.h b/keyboards/keychron/q1_max/jis_encoder/config.h
new file mode 100644
index 0000000000..15f165d5b1
--- /dev/null
+++ b/keyboards/keychron/q1_max/jis_encoder/config.h
@@ -0,0 +1,47 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 85
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Caps lock indicating led */
+# define CAPS_LOCK_INDEX 44
+# define LOW_BAT_IND_INDEX \
+ { 77 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q1_max/jis_encoder/jis_encoder.c b/keyboards/keychron/q1_max/jis_encoder/jis_encoder.c
new file mode 100644
index 0000000000..29d3b0abb5
--- /dev/null
+++ b/keyboards/keychron/q1_max/jis_encoder/jis_encoder.c
@@ -0,0 +1,152 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43 },
+ { 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58 },
+ { 59, __, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72 },
+ { 73, 74, 75, 76, __, __, 77, __, 78, 79, 80, 81, 82, 83, 84 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {18, 0}, {33, 0}, {48, 0}, {62, 0}, {81, 0}, {95, 0}, {110, 0}, {125, 0}, {143, 0}, {158, 0}, {172, 0}, {187, 0}, {205, 0},
+ {0,15}, {15,15}, {29,15}, {44,15}, {59,15}, {73,15}, {88,15}, {103,15}, {117,15}, {132,15}, {146,15}, {161,15}, {176,15}, {190,15}, {205,15},
+ {4,28}, {22,28}, {37,28}, {51,28}, {66,28}, {81,28}, {95,28}, {110,28}, {125,28}, {139,28}, {154,28}, {168,28}, {183,28}, {203,34}, {224,28},
+ {6,40}, {26,40}, {40,40}, {55,40}, {70,40}, {84,40}, {99,40}, {114,40}, {128,40}, {143,40}, {158,40}, {172,40}, {187,40}, {224,40}, {224,15},
+ {9,52}, {33,52}, {48,52}, {62,52}, {77,52}, {92,52}, {106,52}, {121,52}, {136,52}, {150,52}, {165,52}, {179,52}, {194,52}, {209,52},
+ {2,64}, {18,64}, {35,64}, {51,64}, {92,64}, {134,64}, {150,64}, {165,64}, {179,64}, {194,64}, {209,64}, {223,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/q1_max/jis_encoder/keyboard.json b/keyboards/keychron/q1_max/jis_encoder/keyboard.json
new file mode 100644
index 0000000000..78e9c2d9bc
--- /dev/null
+++ b/keyboards/keychron/q1_max/jis_encoder/keyboard.json
@@ -0,0 +1,103 @@
+{
+ "usb": {
+ "pid": "0x0812",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_jis_86": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25},
+ {"matrix": [1, 14], "x": 14, "y": 1.25},
+ {"matrix": [3, 14], "x": 15.25, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25},
+ {"matrix": [2, 13], "x": 13.25, "y": 2.75, "w": 1.25, "h": 2},
+ {"matrix": [3, 13], "x": 15.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 13.25, "y": 4.25},
+ {"matrix": [4, 14], "x": 14.25, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25},
+ {"matrix": [5, 2], "x": 2.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 3], "x": 3.5, "y": 5.25},
+ {"matrix": [5, 6], "x": 4.5, "y": 5.25, "w": 4.5},
+ {"matrix": [5, 8], "x": 9, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 9], "x": 10.25, "y": 5.25},
+ {"matrix": [5, 10], "x": 11.25, "y": 5.25},
+ {"matrix": [5, 11], "x": 12.25, "y": 5.25},
+ {"matrix": [5, 12], "x": 13.25, "y": 5.25},
+ {"matrix": [5, 13], "x": 14.25, "y": 5.25},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q1_max/jis_encoder/keymaps/default/keymap.c b/keyboards/keychron/q1_max/jis_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..9884339ad5
--- /dev/null
+++ b/keyboards/keychron/q1_max/jis_encoder/keymaps/default/keymap.c
@@ -0,0 +1,76 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_jis_86(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, KC_MUTE,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_jis_86(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_jis_86(
+ 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_DEL, KC_MUTE,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_jis_86(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q1_max/jis_encoder/rules.mk b/keyboards/keychron/q1_max/jis_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q1_max/jis_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q1_max/mcuconf.h b/keyboards/keychron/q1_max/mcuconf.h
new file mode 100644
index 0000000000..681e8fd4cc
--- /dev/null
+++ b/keyboards/keychron/q1_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q1_max/q1_max.c b/keyboards/keychron/q1_max/q1_max.c
new file mode 100644
index 0000000000..9a196985a6
--- /dev/null
+++ b/keyboards/keychron/q1_max/q1_max.c
@@ -0,0 +1,61 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 2 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q1_max/readme.md b/keyboards/keychron/q1_max/readme.md
new file mode 100644
index 0000000000..c85989c49d
--- /dev/null
+++ b/keyboards/keychron/q1_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron Q1 Max
+
+
+
+A customizable 75% keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q1 Max
+* Hardware Availability: [Keychron Q1 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q1-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q1_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q1_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q1_max/rules.mk b/keyboards/keychron/q1_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q1_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q1_max/via_json/q1_max_ansi_encoder.json b/keyboards/keychron/q1_max/via_json/q1_max_ansi_encoder.json
new file mode 100644
index 0000000000..f5e9f1b754
--- /dev/null
+++ b/keyboards/keychron/q1_max/via_json/q1_max_ansi_encoder.json
@@ -0,0 +1,285 @@
+{
+ "name": "Keychron Q1 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0810",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 15},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ {
+ "x": 0.25
+ },
+ "0, 14\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 12",
+ {
+ "x": 0.25
+ },
+ "3, 13"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "x": 0.25,
+ "y": 0.25
+ },
+ "4, 14"
+ ],
+ [
+ {
+ "y": -0.25,
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 9",
+ "5, 10",
+ "5, 11",
+ {
+ "x": 0.25,
+ "y": 0.25
+ },
+ "5, 12",
+ "5, 13",
+ "5, 14"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q1_max/via_json/q1_max_iso_encoder.json b/keyboards/keychron/q1_max/via_json/q1_max_iso_encoder.json
new file mode 100644
index 0000000000..eb23ee3449
--- /dev/null
+++ b/keyboards/keychron/q1_max/via_json/q1_max_iso_encoder.json
@@ -0,0 +1,287 @@
+{
+ "name": "Keychron Q1 Max ISO Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0811",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 15},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ {
+ "x": 0.25
+ },
+ "0, 14\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 12",
+ {
+ "x": 1.5
+ },
+ "3, 13"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 1",
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "x": 0.25,
+ "y": 0.25
+ },
+ "4, 14"
+ ],
+ [
+ {
+ "y": -0.25,
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 9",
+ "5, 10",
+ "5, 11",
+ {
+ "x": 0.25,
+ "y": 0.25
+ },
+ "5, 12",
+ "5, 13",
+ "5, 14"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q1_max/via_json/q1_max_jis_encoder.json b/keyboards/keychron/q1_max/via_json/q1_max_jis_encoder.json
new file mode 100644
index 0000000000..bdac3f26dc
--- /dev/null
+++ b/keyboards/keychron/q1_max/via_json/q1_max_jis_encoder.json
@@ -0,0 +1,285 @@
+{
+ "name": "Keychron Q1 Max JIS Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0812",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 15},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ {
+ "x": 0.25
+ },
+ "0, 14\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ "1, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 14",
+ {
+ "x": 0.25
+ },
+ "3, 14"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "2, 14"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 12",
+ {
+ "x": 1.5,
+ "c": "#aaaaaa"
+ },
+ "3, 13"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "c": "#cccccc"
+ },
+ "4, 14"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ "5, 3",
+ {
+ "w": 4.5,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 8",
+ "5, 9",
+ "5, 10",
+ "5, 11",
+ {
+ "c": "#cccccc"
+ },
+ "5, 12",
+ "5, 13",
+ "5, 14"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q2_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/q2_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..bcaea4c2d9
--- /dev/null
+++ b/keyboards/keychron/q2_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,129 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, __ },
+ { 43, __, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, __, 54, 55 },
+ { 56, 57, 58, __, __, __, 59, __, __, 60, 61, 62, 63, 64, 65 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {29, 0}, {44, 0}, {59, 0}, {73, 0}, {88, 0}, {103, 0}, {117, 0}, {132, 0}, {146, 0}, {161, 0}, {176, 0}, {198, 0},
+ {4,15}, {22,15}, {37,15}, {51,15}, {66,15}, {81,15}, {95,15}, {110,15}, {125,15}, {139,15}, {154,15}, {168,15}, {183,15}, {201,15}, {224,15},
+ {6,30}, {26,30}, {40,30}, {55,30}, {70,30}, {84,30}, {99,30}, {114,30}, {128,30}, {143,30}, {158,30}, {172,30}, {196,30}, {224,30},
+ {9,45}, {33,45}, {48,45}, {62,45}, {77,45}, {92,45}, {106,45}, {121,45}, {136,45}, {150,45}, {165,45}, {185,45}, {209,49},
+ {2,60}, {20,60}, {38,60}, {94,60}, {147,60}, {161,60}, {176,60}, {195,64}, {209,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/q2_max/ansi_encoder/config.h b/keyboards/keychron/q2_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..7e2e9c14fa
--- /dev/null
+++ b/keyboards/keychron/q2_max/ansi_encoder/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 66
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40 }
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 29
+# define LOW_BAT_IND_INDEX \
+ { 59 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q2_max/ansi_encoder/keyboard.json b/keyboards/keychron/q2_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..e364acfbc0
--- /dev/null
+++ b/keyboards/keychron/q2_max/ansi_encoder/keyboard.json
@@ -0,0 +1,83 @@
+{
+ "usb": {
+ "pid": "0x0820",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_67": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6, "y": 0},
+ {"matrix": [0, 7], "x": 7, "y": 0},
+ {"matrix": [0, 8], "x": 8, "y": 0},
+ {"matrix": [0, 9], "x": 9, "y": 0},
+ {"matrix": [0, 10], "x": 10, "y": 0},
+ {"matrix": [0, 11], "x": 11, "y": 0},
+ {"matrix": [0, 12], "x": 12, "y": 0},
+ {"matrix": [0, 13], "x": 13, "y": 0, "w": 2},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
+ {"matrix": [1, 1], "x": 1.5, "y": 1},
+ {"matrix": [1, 2], "x": 2.5, "y": 1},
+ {"matrix": [1, 3], "x": 3.5, "y": 1},
+ {"matrix": [1, 4], "x": 4.5, "y": 1},
+ {"matrix": [1, 5], "x": 5.5, "y": 1},
+ {"matrix": [1, 6], "x": 6.5, "y": 1},
+ {"matrix": [1, 7], "x": 7.5, "y": 1},
+ {"matrix": [1, 8], "x": 8.5, "y": 1},
+ {"matrix": [1, 9], "x": 9.5, "y": 1},
+ {"matrix": [1, 10], "x": 10.5, "y": 1},
+ {"matrix": [1, 11], "x": 11.5, "y": 1},
+ {"matrix": [1, 12], "x": 12.5, "y": 1},
+ {"matrix": [1, 13], "x": 13.5, "y": 1, "w": 1.5},
+ {"matrix": [1, 14], "x": 15.25, "y": 1},
+
+ {"matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
+ {"matrix": [2, 1], "x": 1.75, "y": 2},
+ {"matrix": [2, 2], "x": 2.75, "y": 2},
+ {"matrix": [2, 3], "x": 3.75, "y": 2},
+ {"matrix": [2, 4], "x": 4.75, "y": 2},
+ {"matrix": [2, 5], "x": 5.75, "y": 2},
+ {"matrix": [2, 6], "x": 6.75, "y": 2},
+ {"matrix": [2, 7], "x": 7.75, "y": 2},
+ {"matrix": [2, 8], "x": 8.75, "y": 2},
+ {"matrix": [2, 9], "x": 9.75, "y": 2},
+ {"matrix": [2, 10], "x": 10.75, "y": 2},
+ {"matrix": [2, 11], "x": 11.75, "y": 2},
+ {"matrix": [2, 12], "x": 12.75, "y": 2, "w": 2.25},
+ {"matrix": [2, 13], "x": 15.25, "y": 2},
+
+ {"matrix": [3, 0], "x": 0, "y": 3, "w": 2.25},
+ {"matrix": [3, 2], "x": 2.25, "y": 3},
+ {"matrix": [3, 3], "x": 3.25, "y": 3},
+ {"matrix": [3, 4], "x": 4.25, "y": 3},
+ {"matrix": [3, 5], "x": 5.25, "y": 3},
+ {"matrix": [3, 6], "x": 6.25, "y": 3},
+ {"matrix": [3, 7], "x": 7.25, "y": 3},
+ {"matrix": [3, 8], "x": 8.25, "y": 3},
+ {"matrix": [3, 9], "x": 9.25, "y": 3},
+ {"matrix": [3, 10], "x": 10.25, "y": 3},
+ {"matrix": [3, 11], "x": 11.25, "y": 3},
+ {"matrix": [3, 13], "x": 12.25, "y": 3, "w": 1.75},
+ {"matrix": [3, 14], "x": 14.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4, "w": 1.25},
+ {"matrix": [4, 2], "x": 2.5, "y": 4, "w": 1.25},
+ {"matrix": [4, 6], "x": 3.75, "y": 4, "w": 6.25},
+ {"matrix": [4, 9], "x": 10, "y": 4},
+ {"matrix": [4, 10], "x": 11, "y": 4},
+ {"matrix": [4, 11], "x": 12, "y": 4},
+ {"matrix": [4, 12], "x": 13.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 14.25, "y": 4.25},
+ {"matrix": [4, 14], "x": 15.25, "y": 4.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q2_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/q2_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..adaa9714d9
--- /dev/null
+++ b/keyboards/keychron/q2_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,82 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ _FN2,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_67(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN1), MO(_FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_BASE] = LAYOUT_ansi_67(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN1), MO(_FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN1] = LAYOUT_ansi_67(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL,KC_LNPAD,RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_FN1] = LAYOUT_ansi_67(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [_FN2] = LAYOUT_ansi_67(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN1] = { ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_FN1] = { ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [_FN2] = { ENCODER_CCW_CW(_______, _______)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q2_max/ansi_encoder/rules.mk b/keyboards/keychron/q2_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q2_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q2_max/board.h b/keyboards/keychron/q2_max/board.h
new file mode 100644
index 0000000000..006a2998bb
--- /dev/null
+++ b/keyboards/keychron/q2_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT & PIN_PUPDR_PULLUP to avoid FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q2_max/config.h b/keyboards/keychron/q2_max/config.h
new file mode 100644
index 0000000000..a32d58a71f
--- /dev/null
+++ b/keyboards/keychron/q2_max/config.h
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 18
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 15, 16, 17 }
+# define BAT_LEVEL_LED_LIST \
+ { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(4)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q2_max/halconf.h b/keyboards/keychron/q2_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/q2_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q2_max/info.json b/keyboards/keychron/q2_max/info.json
new file mode 100644
index 0000000000..e532f26f75
--- /dev/null
+++ b/keyboards/keychron/q2_max/info.json
@@ -0,0 +1,80 @@
+{
+ "keyboard_name": "Keychron Q2 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string" : true
+ },
+ "matrix_pins": {
+ "cols": ["C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B14",
+ "pin_b": "B15"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["B12"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "dynamic_keymap": {
+ "layer_count": 5
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q2_max/iso_encoder/config.h b/keyboards/keychron/q2_max/iso_encoder/config.h
new file mode 100644
index 0000000000..5f866dd7c7
--- /dev/null
+++ b/keyboards/keychron/q2_max/iso_encoder/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 67
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 29
+# define LOW_BAT_IND_INDEX \
+ { 60 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q2_max/iso_encoder/iso_encoder.c b/keyboards/keychron/q2_max/iso_encoder/iso_encoder.c
new file mode 100644
index 0000000000..9f48ac97c0
--- /dev/null
+++ b/keyboards/keychron/q2_max/iso_encoder/iso_encoder.c
@@ -0,0 +1,130 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, __ },
+ { 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, __, 55, 56 },
+ { 57, 58, 59, __, __, __, 60, __, __, 61, 62, 63, 64, 65, 66 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {29, 0}, {44, 0}, {59, 0}, {73, 0}, {88, 0}, {103, 0}, {117, 0}, {132, 0}, {146, 0}, {161, 0}, {176, 0}, {198, 0},
+ {4,15}, {22,15}, {37,15}, {51,15}, {66,15}, {81,15}, {95,15}, {110,15}, {125,15}, {139,15}, {154,15}, {168,15}, {183,15}, {203,23}, {224,15},
+ {6,30}, {26,30}, {40,30}, {55,30}, {70,30}, {84,30}, {99,30}, {114,30}, {128,30}, {143,30}, {158,30}, {172,30}, {187,30}, {224,30},
+ {2,45}, {18,45}, {33,45}, {48,45}, {62,45}, {77,45}, {92,45}, {106,45}, {121,45}, {136,45}, {150,45}, {165,45}, {185,45}, {209,49},
+ {2,60}, {20,60}, {38,60}, {94,60}, {147,60}, {161,60}, {176,60}, {195,64}, {209,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/q2_max/iso_encoder/keyboard.json b/keyboards/keychron/q2_max/iso_encoder/keyboard.json
new file mode 100644
index 0000000000..e9249b8e2a
--- /dev/null
+++ b/keyboards/keychron/q2_max/iso_encoder/keyboard.json
@@ -0,0 +1,84 @@
+{
+ "usb": {
+ "pid": "0x0821",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_iso_68": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6, "y": 0},
+ {"matrix": [0, 7], "x": 7, "y": 0},
+ {"matrix": [0, 8], "x": 8, "y": 0},
+ {"matrix": [0, 9], "x": 9, "y": 0},
+ {"matrix": [0, 10], "x": 10, "y": 0},
+ {"matrix": [0, 11], "x": 11, "y": 0},
+ {"matrix": [0, 12], "x": 12, "y": 0},
+ {"matrix": [0, 13], "x": 13, "y": 0, "w": 2},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
+ {"matrix": [1, 1], "x": 1.5, "y": 1},
+ {"matrix": [1, 2], "x": 2.5, "y": 1},
+ {"matrix": [1, 3], "x": 3.5, "y": 1},
+ {"matrix": [1, 4], "x": 4.5, "y": 1},
+ {"matrix": [1, 5], "x": 5.5, "y": 1},
+ {"matrix": [1, 6], "x": 6.5, "y": 1},
+ {"matrix": [1, 7], "x": 7.5, "y": 1},
+ {"matrix": [1, 8], "x": 8.5, "y": 1},
+ {"matrix": [1, 9], "x": 9.5, "y": 1},
+ {"matrix": [1, 10], "x": 10.5, "y": 1},
+ {"matrix": [1, 11], "x": 11.5, "y": 1},
+ {"matrix": [1, 12], "x": 12.5, "y": 1},
+ {"matrix": [1, 14], "x": 15.25, "y": 1},
+
+ {"matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
+ {"matrix": [2, 1], "x": 1.75, "y": 2},
+ {"matrix": [2, 2], "x": 2.75, "y": 2},
+ {"matrix": [2, 3], "x": 3.75, "y": 2},
+ {"matrix": [2, 4], "x": 4.75, "y": 2},
+ {"matrix": [2, 5], "x": 5.75, "y": 2},
+ {"matrix": [2, 6], "x": 6.75, "y": 2},
+ {"matrix": [2, 7], "x": 7.75, "y": 2},
+ {"matrix": [2, 8], "x": 8.75, "y": 2},
+ {"matrix": [2, 9], "x": 9.75, "y": 2},
+ {"matrix": [2, 10], "x": 10.75, "y": 2},
+ {"matrix": [2, 11], "x": 11.75, "y": 2},
+ {"matrix": [2, 12], "x": 12.75, "y": 2},
+ {"matrix": [1, 13], "x": 13.25, "y": 1.5, "w": 1.25, "h": 2},
+ {"matrix": [2, 13], "x": 15.25, "y": 2},
+
+ {"matrix": [3, 0], "x": 0, "y": 3, "w": 1.25},
+ {"matrix": [3, 1], "x": 1.25, "y": 3},
+ {"matrix": [3, 2], "x": 2.25, "y": 3},
+ {"matrix": [3, 3], "x": 3.25, "y": 3},
+ {"matrix": [3, 4], "x": 4.25, "y": 3},
+ {"matrix": [3, 5], "x": 5.25, "y": 3},
+ {"matrix": [3, 6], "x": 6.25, "y": 3},
+ {"matrix": [3, 7], "x": 7.25, "y": 3},
+ {"matrix": [3, 8], "x": 8.25, "y": 3},
+ {"matrix": [3, 9], "x": 9.25, "y": 3},
+ {"matrix": [3, 10], "x": 10.25, "y": 3},
+ {"matrix": [3, 11], "x": 11.25, "y": 3},
+ {"matrix": [3, 13], "x": 12.25, "y": 3, "w": 1.75},
+ {"matrix": [3, 14], "x": 14.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4, "w": 1.25},
+ {"matrix": [4, 2], "x": 2.5, "y": 4, "w": 1.25},
+ {"matrix": [4, 6], "x": 3.75, "y": 4, "w": 6.25},
+ {"matrix": [4, 9], "x": 10, "y": 4},
+ {"matrix": [4, 10], "x": 11, "y": 4},
+ {"matrix": [4, 11], "x": 12, "y": 4},
+ {"matrix": [4, 12], "x": 13.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 14.25, "y": 4.25},
+ {"matrix": [4, 14], "x": 15.25, "y": 4.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q2_max/iso_encoder/keymaps/default/keymap.c b/keyboards/keychron/q2_max/iso_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..7994c95be4
--- /dev/null
+++ b/keyboards/keychron/q2_max/iso_encoder/keymaps/default/keymap.c
@@ -0,0 +1,82 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_68(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN1),MO(FN2),KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_BASE] = LAYOUT_iso_68(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN1),MO(FN2),KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN1] = LAYOUT_iso_68(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL,KC_LNPAD,RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_FN1] = LAYOUT_iso_68(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [FN2] = LAYOUT_iso_68(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN1] = { ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_FN1] = { ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [FN2] = { ENCODER_CCW_CW(_______, _______)}
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q2_max/iso_encoder/rules.mk b/keyboards/keychron/q2_max/iso_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q2_max/iso_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q2_max/mcuconf.h b/keyboards/keychron/q2_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/q2_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q2_max/q2_max.c b/keyboards/keychron/q2_max/q2_max.c
new file mode 100644
index 0000000000..486dd77a1b
--- /dev/null
+++ b/keyboards/keychron/q2_max/q2_max.c
@@ -0,0 +1,61 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 1 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q2_max/readme.md b/keyboards/keychron/q2_max/readme.md
new file mode 100644
index 0000000000..4638cca960
--- /dev/null
+++ b/keyboards/keychron/q2_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron Q2 Max
+
+
+
+A customizable 65% keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q2 Max
+* Hardware Availability: [Keychron Q2 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q2-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q2_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q2_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q2_max/rules.mk b/keyboards/keychron/q2_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q2_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q2_max/via_json/q2_ansi_encoder.json b/keyboards/keychron/q2_max/via_json/q2_ansi_encoder.json
new file mode 100644
index 0000000000..fcc60fdaad
--- /dev/null
+++ b/keyboards/keychron/q2_max/via_json/q2_ansi_encoder.json
@@ -0,0 +1,250 @@
+{
+ "name": "Keychron Q2 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0820",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 15},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ {
+ "x": 0.25,
+ "y": -0.25
+ },
+ "0, 14\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25,
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "2, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "2, 13"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "3, 14"
+ ],
+ [
+ {
+ "y": -0.25,
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "w": 1.25
+ },
+ "4, 1",
+ {
+ "w": 1.25
+ },
+ "4, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "4, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "4, 12",
+ "4, 13",
+ "4, 14"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q3_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/q3_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..7d37be10d3
--- /dev/null
+++ b/keyboards/keychron/q3_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,154 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, __, 62, __, __, __ },
+ { 63, __, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, 74, __, 75, __ },
+ { 76, 77, 78, __, __, __, 79, __, __, __, 80, 81, 82, 83, 84, 85, 86 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {16, 0}, {29, 0}, {42, 0}, {55, 0}, {71, 0}, {84, 0}, { 97, 0}, {110, 0}, {126, 0}, {139, 0}, {152, 0}, {165, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,15}, {13,15}, {26,15}, {39,15}, {52,15}, {65,15}, {78,15}, { 91,15}, {104,15}, {117,15}, {130,15}, {143,15}, {156,15}, {176,15}, {198,15}, {211,15}, {224,15},
+ {3,28}, {19,28}, {32,28}, {46,28}, {59,28}, {72,28}, {85,28}, { 98,28}, {111,28}, {124,28}, {137,28}, {150,28}, {163,28}, {179,28}, {198,28}, {211,28}, {224,28},
+ {5,40}, {23,40}, {36,40}, {49,40}, {62,40}, {75,40}, {88,40}, {101,40}, {114,40}, {127,40}, {140,40}, {153,40}, {174,40},
+ {8,52}, {29,52}, {42,52}, {55,52}, {68,52}, {81,52}, { 94,52}, {107,52}, {120,52}, {133,52}, {146,52}, {171,52}, {211,52},
+ {2,64}, {18,64}, {34,64}, {83,64}, {131,64}, {148,64}, {164,64}, {180,64}, {198,64}, {211,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/q3_max/ansi_encoder/config.h b/keyboards/keychron/q3_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..acf125be50
--- /dev/null
+++ b/keyboards/keychron/q3_max/ansi_encoder/config.h
@@ -0,0 +1,43 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 87
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Caps lock indicating led */
+# define CAPS_LOCK_INDEX 50
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q3_max/ansi_encoder/keyboard.json b/keyboards/keychron/q3_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..94971017e7
--- /dev/null
+++ b/keyboards/keychron/q3_max/ansi_encoder/keyboard.json
@@ -0,0 +1,105 @@
+{
+ "usb": {
+ "pid": "0x0830",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_tkl_ansi": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+ {"matrix": [0, 15], "x": 16.25, "y": 0},
+ {"matrix": [0, 16], "x": 17.25, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 15], "x": 16.25, "y": 1.25},
+ {"matrix": [1, 16], "x": 17.25, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 13], "x": 13.5, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 16.25, "y": 2.25},
+ {"matrix": [2, 16], "x": 17.25, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 12.75, "y": 3.25, "w": 2.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 12.25, "y": 4.25, "w": 2.75},
+ {"matrix": [4, 15], "x": 16.25, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.25},
+ {"matrix": [5, 15], "x": 16.25, "y": 5.25},
+ {"matrix": [5, 16], "x": 17.25, "y": 5.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q3_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/q3_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..a33c382208
--- /dev/null
+++ b/keyboards/keychron/q3_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_tkl_ansi(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_MUTE, KC_SNAP, KC_SIRI, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_tkl_ansi(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, RGB_TOG, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_tkl_ansi(
+ 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_MUTE, KC_PSCR, KC_CTANA, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LCMD, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_tkl_ansi(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, RGB_TOG, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q3_max/ansi_encoder/rules.mk b/keyboards/keychron/q3_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q3_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q3_max/board.h b/keyboards/keychron/q3_max/board.h
new file mode 100644
index 0000000000..ee36dc44c2
--- /dev/null
+++ b/keyboards/keychron/q3_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLDOWN(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q3_max/config.h b/keyboards/keychron/q3_max/config.h
new file mode 100644
index 0000000000..282c1e012b
--- /dev/null
+++ b/keyboards/keychron/q3_max/config.h
@@ -0,0 +1,81 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN A8
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q3_max/halconf.h b/keyboards/keychron/q3_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/q3_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q3_max/info.json b/keyboards/keychron/q3_max/info.json
new file mode 100644
index 0000000000..bdeba1c153
--- /dev/null
+++ b/keyboards/keychron/q3_max/info.json
@@ -0,0 +1,77 @@
+{
+ "keyboard_name": "Keychron Q3 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string" : true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["C9"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q3_max/iso_encoder/config.h b/keyboards/keychron/q3_max/iso_encoder/config.h
new file mode 100644
index 0000000000..0854bcf6c8
--- /dev/null
+++ b/keyboards/keychron/q3_max/iso_encoder/config.h
@@ -0,0 +1,43 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 88
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Caps lock indicating led */
+# define CAPS_LOCK_INDEX 51
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q3_max/iso_encoder/iso_encoder.c b/keyboards/keychron/q3_max/iso_encoder/iso_encoder.c
new file mode 100644
index 0000000000..e8053901f2
--- /dev/null
+++ b/keyboards/keychron/q3_max/iso_encoder/iso_encoder.c
@@ -0,0 +1,155 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, __, __, __, __ },
+ { 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, __, 75, __, 76, __ },
+ { 77, 78, 79, __, __, __, 80, __, __, __, 81, 82, 83, 84, 85, 86, 87 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {16, 0}, {29, 0}, {42, 0}, {54, 0}, {66, 0}, {84, 0}, {97, 0}, {110, 0}, {126, 0}, {139, 0}, {152, 0}, {165,0}, {198, 0}, {211,0}, {224,0},
+ {0,15}, {13,15}, {26,15}, {39,15}, {52,15}, {65,15}, {78,15}, {91,15}, {104,15}, {117,15}, {130,15}, {143,15}, {156,15}, {176,15}, {198,15}, {211,15}, {224,15},
+ {3,28}, {20,28}, {33,28}, {46,28}, {59,28}, {72,28}, {85,28}, {98,28}, {111,28}, {124,28}, {137,28}, {150,28}, {163,28}, {178,28}, {198,28}, {211,28}, {224,28},
+ {5,40}, {23,40}, {36,40}, {49,40}, {62,40}, {75,40}, {88,40}, {101,40}, {114,40}, {127,40}, {140,40}, {150,40}, {166,40},
+ {2,52}, {16,52}, {29,52}, {42,52}, {55,52}, {68,52}, {81,52}, {94,52}, {107,52}, {120,52}, {133,52}, {146,52}, {171,52}, {211,52},
+ {2,64}, {18,64}, {34,64}, {83,64}, {131,64}, {148,64}, {164,64}, {178,64}, {198,64}, {211,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 1, 1, 1,
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 1, 1, 1,
+ 8, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 1,
+ 1, 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 1,
+ 1, 1, 1, 4, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/q3_max/iso_encoder/keyboard.json b/keyboards/keychron/q3_max/iso_encoder/keyboard.json
new file mode 100644
index 0000000000..d2d6c6c970
--- /dev/null
+++ b/keyboards/keychron/q3_max/iso_encoder/keyboard.json
@@ -0,0 +1,107 @@
+{
+ "usb": {
+ "pid": "0x0831",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_iso_88": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+ {"matrix": [0, 15], "x": 16.25, "y": 0},
+ {"matrix": [0, 16], "x": 17.25, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 15], "x": 16.25, "y": 1.25},
+ {"matrix": [1, 16], "x": 17.25, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 13], "x": 13.5, "y": 2.25,"w":1.5,"h":2},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 16.25, "y": 2.25},
+ {"matrix": [2, 16], "x": 17.25, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25},
+
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 12.25, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 15], "x": 16.25, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.25},
+ {"matrix": [5, 15], "x": 16.25, "y": 5.25},
+ {"matrix": [5, 16], "x": 17.25, "y": 5.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q3_max/iso_encoder/keymaps/default/keymap.c b/keyboards/keychron/q3_max/iso_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..d379f00d8b
--- /dev/null
+++ b/keyboards/keychron/q3_max/iso_encoder/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_88(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_MUTE, KC_SNAP, KC_SIRI, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_ENT, KC_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_88(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, RGB_TOG, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_88(
+ 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_MUTE, KC_PSCR, KC_CTANA, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_ENT, KC_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_88(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, RGB_TOG, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q3_max/iso_encoder/rules.mk b/keyboards/keychron/q3_max/iso_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q3_max/iso_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q3_max/mcuconf.h b/keyboards/keychron/q3_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/q3_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q3_max/q3_max.c b/keyboards/keychron/q3_max/q3_max.c
new file mode 100644
index 0000000000..da12299ee0
--- /dev/null
+++ b/keyboards/keychron/q3_max/q3_max.c
@@ -0,0 +1,83 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 2 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+
+ } else {
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q3_max/readme.md b/keyboards/keychron/q3_max/readme.md
new file mode 100644
index 0000000000..c99ee6b243
--- /dev/null
+++ b/keyboards/keychron/q3_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron Q3 Max
+
+
+
+A customizable TKL keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q3 Max
+* Hardware Availability: [Keychron Q3 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q3-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q3_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q3_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q3_max/rules.mk b/keyboards/keychron/q3_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q3_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q3_max/via_json/q3_max_ansi_encoder.json b/keyboards/keychron/q3_max/via_json/q3_max_ansi_encoder.json
new file mode 100644
index 0000000000..8877acc747
--- /dev/null
+++ b/keyboards/keychron/q3_max/via_json/q3_max_ansi_encoder.json
@@ -0,0 +1,297 @@
+{
+ "name": "Keychron Q3 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0830",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 13\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.25
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 13"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "x": 1.25,
+ "c": "#cccccc"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q3_max/via_json/q3_max_iso_encoder.json b/keyboards/keychron/q3_max/via_json/q3_max_iso_encoder.json
new file mode 100644
index 0000000000..38a7523ad7
--- /dev/null
+++ b/keyboards/keychron/q3_max/via_json/q3_max_iso_encoder.json
@@ -0,0 +1,300 @@
+{
+ "name": "Keychron Q3 Max ISO Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0831",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 13\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.25
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "c": "#777777",
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1
+ },
+ "2, 13",
+ {
+ "c": "#aaaaaa",
+ "x": 0.25
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 12"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 1",
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "x": 1.25,
+ "c": "#cccccc"
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q5_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/q5_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..9fdb88b76a
--- /dev/null
+++ b/keyboards/keychron/q5_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,168 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB10_CA6, CB12_CA6, CB11_CA6},
+ {1, CB10_CA5, CB12_CA5, CB11_CA5},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, 14, 15, 16, __ },
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35 },
+ { 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54 },
+ { 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, __, 69, 70, 71, __ },
+ { 72, __, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, __, 85, 86, 87, 88 },
+ { 89, 90, 91, __, __, __, 92, __, __, 93, 94, 95, 96, 97, 98, __, 99, 100, __ },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {23, 0}, {34, 0}, {46, 0}, {57, 0}, {75, 0}, {86, 0}, {98, 0}, {109, 0}, {127, 0}, {138, 0}, {150, 0}, {161, 0}, {175, 0}, {189, 0}, {201, 0}, {212, 0},
+ {0,15}, {12,15}, {23,15}, {35,15}, {46,15}, {58,15}, {69,15}, {81,15}, { 92,15}, {104,15}, {115,15}, {127,15}, {138,15}, {155,15}, {175,15}, {189,15}, {201,15}, {212,15}, {224,15},
+ {3,26}, {17,26}, {29,26}, {40,26}, {52,26}, {63,26}, {75,26}, {86,26}, { 98,26}, {109,26}, {121,26}, {132,26}, {144,26}, {158,26}, {175,26}, {189,26}, {201,26}, {212,26}, {224,32},
+ {4,38}, {20,38}, {32,38}, {43,38}, {55,38}, {66,38}, {78,38}, {89,38}, {101,38}, {112,38}, {124,38}, {135,38}, {154,38}, {175,38}, {189,38}, {201,38}, {212,38},
+ {7,50}, {26,50}, {37,50}, {49,50}, {60,50}, {72,50}, {83,50}, { 95,50}, {106,50}, {118,50}, {129,50}, {145,50}, {164,52}, {189,50}, {201,50}, {212,50}, {224,55},
+ {1,61}, {16,61}, {30,61}, {73,61}, {115,61}, {126,61}, {138,61}, {152,64}, {164,64}, {175,64}, {195,61}, {212,61},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/q5_max/ansi_encoder/config.h b/keyboards/keychron/q5_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..1448bf689c
--- /dev/null
+++ b/keyboards/keychron/q5_max/ansi_encoder/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 101
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define NUM_LOCK_INDEX 32
+# define CAPS_LOCK_INDEX 55
+# define LOW_BAT_IND_INDEX \
+ { 92 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q5_max/ansi_encoder/keyboard.json b/keyboards/keychron/q5_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..a206fdef1a
--- /dev/null
+++ b/keyboards/keychron/q5_max/ansi_encoder/keyboard.json
@@ -0,0 +1,119 @@
+{
+ "usb": {
+ "pid": "0x0850",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_101": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 2, "y": 0},
+ {"matrix": [0, 2], "x": 3, "y": 0},
+ {"matrix": [0, 3], "x": 4, "y": 0},
+ {"matrix": [0, 4], "x": 5, "y": 0},
+ {"matrix": [0, 5], "x": 6.5, "y": 0},
+ {"matrix": [0, 6], "x": 7.5, "y": 0},
+ {"matrix": [0, 7], "x": 8.5, "y": 0},
+ {"matrix": [0, 8], "x": 9.5, "y": 0},
+ {"matrix": [0, 9], "x": 11, "y": 0},
+ {"matrix": [0, 10], "x": 12, "y": 0},
+ {"matrix": [0, 11], "x": 13, "y": 0},
+ {"matrix": [0, 12], "x": 14, "y": 0},
+ {"matrix": [0, 13], "x": 15.25, "y": 0},
+ {"matrix": [0, 15], "x": 16.5, "y": 0},
+ {"matrix": [0, 16], "x": 17.5, "y": 0},
+ {"matrix": [0, 17], "x": 18.5, "y": 0},
+ {"matrix": [0, 18], "x": 19.5, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 15], "x": 16.5, "y": 1.25},
+ {"matrix": [1, 16], "x": 17.5, "y": 1.25},
+ {"matrix": [1, 17], "x": 18.5, "y": 1.25},
+ {"matrix": [1, 18], "x": 19.5, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 13], "x": 13.5, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 16.5, "y": 2.25},
+ {"matrix": [2, 16], "x": 17.5, "y": 2.25},
+ {"matrix": [2, 17], "x": 18.5, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 13], "x": 15.25, "y": 3.25},
+ {"matrix": [3, 15], "x": 16.5, "y": 3.25},
+ {"matrix": [3, 16], "x": 17.5, "y": 3.25},
+ {"matrix": [3, 17], "x": 18.5, "y": 3.25},
+ {"matrix": [2, 18], "x": 19.5, "y": 2.25, "h": 2},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 13], "x": 14.25, "y": 4.5},
+ {"matrix": [4, 15], "x": 16.5, "y": 4.25},
+ {"matrix": [4, 16], "x": 17.5, "y": 4.25},
+ {"matrix": [4, 17], "x": 18.5, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 9], "x": 10, "y": 5.25},
+ {"matrix": [5, 10], "x": 11, "y": 5.25},
+ {"matrix": [5, 11], "x": 12, "y": 5.25},
+ {"matrix": [5, 12], "x": 13.25, "y": 5.5},
+ {"matrix": [5, 13], "x": 14.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.5},
+ {"matrix": [5, 16], "x": 16.5, "y": 5.25, "w": 2},
+ {"matrix": [5, 17], "x": 18.5, "y": 5.25},
+ {"matrix": [4, 18], "x": 19.5, "y": 4.25, "h": 2}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q5_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/q5_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..5b01b30efb
--- /dev/null
+++ b/keyboards/keychron/q5_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_101(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, KC_F13, KC_F14 , KC_F15, KC_MUTE,
+ 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_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_HOME, KC_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [MAC_FN] = LAYOUT_ansi_101(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_101(
+ 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_DEL, _______, _______, _______, KC_MUTE,
+ 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_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_HOME, KC_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [WIN_FN] = LAYOUT_ansi_101(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q5_max/ansi_encoder/rules.mk b/keyboards/keychron/q5_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q5_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q5_max/board.h b/keyboards/keychron/q5_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/q5_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q5_max/config.h b/keyboards/keychron/q5_max/config.h
new file mode 100644
index 0000000000..ecac7b1f5f
--- /dev/null
+++ b/keyboards/keychron/q5_max/config.h
@@ -0,0 +1,79 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 21
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 18, 19, 20 }
+# define BAT_LEVEL_LED_LIST \
+ { 18, 19, 20, 21, 22, 23, 24, 25, 26, 27 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q5_max/halconf.h b/keyboards/keychron/q5_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/q5_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q5_max/info.json b/keyboards/keychron/q5_max/info.json
new file mode 100644
index 0000000000..e589981b7c
--- /dev/null
+++ b/keyboards/keychron/q5_max/info.json
@@ -0,0 +1,77 @@
+{
+ "keyboard_name": "Keychron Q5 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "B10"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B14",
+ "pin_b": "B15"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["B12"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q5_max/iso_encoder/config.h b/keyboards/keychron/q5_max/iso_encoder/config.h
new file mode 100644
index 0000000000..b031e8d353
--- /dev/null
+++ b/keyboards/keychron/q5_max/iso_encoder/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 102
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define NUM_LOCK_INDEX 32
+# define CAPS_LOCK_INDEX 55
+# define LOW_BAT_IND_INDEX \
+ { 93 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q5_max/iso_encoder/iso_encoder.c b/keyboards/keychron/q5_max/iso_encoder/iso_encoder.c
new file mode 100644
index 0000000000..f28eab1b42
--- /dev/null
+++ b/keyboards/keychron/q5_max/iso_encoder/iso_encoder.c
@@ -0,0 +1,169 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB10_CA6, CB12_CA6, CB11_CA6},
+ {1, CB10_CA5, CB12_CA5, CB11_CA5},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, 14, 15, 16, __ },
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35 },
+ { 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54 },
+ { 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, __, 69, 70, 71, __ },
+ { 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, __, 86, 87, 88, 89 },
+ { 90, 91, 92, __, __, __, 93, __, __, 94, 95, 96, 97, 98, 99, __, 100, 101, __ },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {23, 0}, {34, 0}, {46, 0}, {57, 0}, {75, 0}, {86, 0}, {98, 0}, {109, 0}, {127, 0}, {138, 0}, {150, 0}, {161, 0}, {175, 0}, {189, 0}, {201, 0}, {212, 0},
+ {0,15}, {12,15}, {23,15}, {35,15}, {46,15}, {58,15}, {69,15}, {81,15}, { 92,15}, {104,15}, {115,15}, {127,15}, {138,15}, {155,15}, {175,15}, {189,15}, {201,15}, {212,15}, {224,15},
+ {3,26}, {17,26}, {29,26}, {40,26}, {52,26}, {63,26}, {75,26}, {86,26}, { 98,26}, {109,26}, {121,26}, {132,26}, {144,26}, {158,26}, {175,26}, {189,26}, {201,26}, {212,26}, {224,32},
+ {4,38}, {20,38}, {32,38}, {43,38}, {55,38}, {66,38}, {78,38}, {89,38}, {101,38}, {112,38}, {124,38}, {135,38}, {154,38}, {175,38}, {189,38}, {201,38}, {212,38},
+ {2,50}, {15,50}, {26,50}, {37,50}, {49,50}, {60,50}, {72,50}, {83,50}, { 95,50}, {106,50}, {118,50}, {129,50}, {145,50}, {164,52}, {189,50}, {201,50}, {212,50}, {224,55},
+ {1,61}, {16,61}, {30,61}, {73,61}, {115,61}, {126,61}, {138,61}, {152,64}, {164,64}, {175,64}, {195,61}, {212,61},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/q5_max/iso_encoder/keyboard.json b/keyboards/keychron/q5_max/iso_encoder/keyboard.json
new file mode 100644
index 0000000000..f26b692f28
--- /dev/null
+++ b/keyboards/keychron/q5_max/iso_encoder/keyboard.json
@@ -0,0 +1,120 @@
+{
+ "usb": {
+ "pid": "0x0851",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_iso_102": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 2, "y": 0},
+ {"matrix": [0, 2], "x": 3, "y": 0},
+ {"matrix": [0, 3], "x": 4, "y": 0},
+ {"matrix": [0, 4], "x": 5, "y": 0},
+ {"matrix": [0, 5], "x": 6.5, "y": 0},
+ {"matrix": [0, 6], "x": 7.5, "y": 0},
+ {"matrix": [0, 7], "x": 8.5, "y": 0},
+ {"matrix": [0, 8], "x": 9.5, "y": 0},
+ {"matrix": [0, 9], "x": 11, "y": 0},
+ {"matrix": [0, 10], "x": 12, "y": 0},
+ {"matrix": [0, 11], "x": 13, "y": 0},
+ {"matrix": [0, 12], "x": 14, "y": 0},
+ {"matrix": [0, 13], "x": 15.25, "y": 0},
+ {"matrix": [0, 15], "x": 16.5, "y": 0},
+ {"matrix": [0, 16], "x": 17.5, "y": 0},
+ {"matrix": [0, 17], "x": 18.5, "y": 0},
+ {"matrix": [0, 18], "x": 19.5, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 15], "x": 16.5, "y": 1.25},
+ {"matrix": [1, 16], "x": 17.5, "y": 1.25},
+ {"matrix": [1, 17], "x": 18.5, "y": 1.25},
+ {"matrix": [1, 18], "x": 19.5, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 16.5, "y": 2.25},
+ {"matrix": [2, 16], "x": 17.5, "y": 2.25},
+ {"matrix": [2, 17], "x": 18.5, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25},
+ {"matrix": [2, 13], "x": 13.75, "y": 2.25, "w":1.25, "h":2},
+ {"matrix": [3, 13], "x": 15.25, "y": 3.25},
+ {"matrix": [3, 15], "x": 16.5, "y": 3.25},
+ {"matrix": [3, 16], "x": 17.5, "y": 3.25},
+ {"matrix": [3, 17], "x": 18.5, "y": 3.25},
+ {"matrix": [2, 18], "x": 19.5, "y": 2.25, "h": 2},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w":1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 13], "x": 14.25, "y": 4.5},
+ {"matrix": [4, 15], "x": 16.5, "y": 4.25},
+ {"matrix": [4, 16], "x": 17.5, "y": 4.25},
+ {"matrix": [4, 17], "x": 18.5, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 9], "x": 10, "y": 5.25},
+ {"matrix": [5, 10], "x": 11, "y": 5.25},
+ {"matrix": [5, 11], "x": 12, "y": 5.25},
+ {"matrix": [5, 12], "x": 13.25, "y": 5.5},
+ {"matrix": [5, 13], "x": 14.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.5},
+ {"matrix": [5, 16], "x": 16.5, "y": 5.25, "w": 2},
+ {"matrix": [5, 17], "x": 18.5, "y": 5.25},
+ {"matrix": [4, 18], "x": 19.5, "y": 4.25, "h": 2}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q5_max/iso_encoder/keymaps/default/keymap.c b/keyboards/keychron/q5_max/iso_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..c392023b1b
--- /dev/null
+++ b/keyboards/keychron/q5_max/iso_encoder/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_102(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, KC_F13, KC_F14 , KC_F15, KC_MUTE,
+ 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_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_HOME, KC_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [MAC_FN] = LAYOUT_iso_102(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_102(
+ 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_DEL, _______, _______, _______, KC_MUTE,
+ 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_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_HOME, KC_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [WIN_FN] = LAYOUT_iso_102(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q5_max/iso_encoder/rules.mk b/keyboards/keychron/q5_max/iso_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q5_max/iso_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q5_max/mcuconf.h b/keyboards/keychron/q5_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/q5_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q5_max/q5_max.c b/keyboards/keychron/q5_max/q5_max.c
new file mode 100644
index 0000000000..81d73d007d
--- /dev/null
+++ b/keyboards/keychron/q5_max/q5_max.c
@@ -0,0 +1,62 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 2 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q5_max/readme.md b/keyboards/keychron/q5_max/readme.md
new file mode 100644
index 0000000000..5db708912c
--- /dev/null
+++ b/keyboards/keychron/q5_max/readme.md
@@ -0,0 +1,23 @@
+# Keychron Q5 Max
+
+
+
+A customizable 98% keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q5 Max
+* Hardware Availability: [Keychron Q5 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q5-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q5_max/ansi_encoder:default
+ make keychron/q5_max/iso_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q5_max/ansi_encoder:default:flash
+ make keychron/q5_max/iso_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q5_max/rules.mk b/keyboards/keychron/q5_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q5_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q5_max/via_json/q5_max_ansi_encoder.json b/keyboards/keychron/q5_max/via_json/q5_max_ansi_encoder.json
new file mode 100644
index 0000000000..94a5028c36
--- /dev/null
+++ b/keyboards/keychron/q5_max/via_json/q5_max_ansi_encoder.json
@@ -0,0 +1,339 @@
+{
+ "name": "Keychron Q5 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0850",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 19},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 15",
+ "0, 16",
+ "0, 17",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 18\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "1, 15",
+ "1, 16",
+ "1, 17",
+ "1, 18"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "2, 15",
+ "2, 16",
+ "2, 17",
+ {
+ "h": 2
+ },
+ "2, 18"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "3, 15",
+ "3, 16",
+ "3, 17"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 12",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "4, 13",
+ {
+ "x": 1.25,
+ "y": -0.25
+ },
+ "4, 15",
+ "4, 16",
+ "4, 17",
+ {
+ "h": 2
+ },
+ "4, 18"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 9",
+ "5, 10",
+ "5, 11",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "5, 12",
+ "5, 13",
+ "5, 14",
+ {
+ "x": 0.25,
+ "y": -0.25,
+ "w": 2
+ },
+ "5, 16",
+ "5, 17"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q5_max/via_json/q5_max_iso_encoder.json b/keyboards/keychron/q5_max/via_json/q5_max_iso_encoder.json
new file mode 100644
index 0000000000..8faa3ecefe
--- /dev/null
+++ b/keyboards/keychron/q5_max/via_json/q5_max_iso_encoder.json
@@ -0,0 +1,339 @@
+{
+ "name": "Keychron Q5 Max ISO Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0851",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 19},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0,9",
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,15",
+ "0,16",
+ "0,17",
+ "0,18\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,13",
+ {
+ "x": 0.25
+ },
+ "1,14",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "1,15",
+ "1,16",
+ "1,17",
+ "1,18"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.5
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2,13",
+ {
+ "x": 0.25
+ },
+ "2,14",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "2,15",
+ "2,16",
+ "2,17",
+ {
+ "h": 2
+ },
+ "2,18"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,1",
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ "3,12",
+ {
+ "c": "#aaaaaa",
+ "x": 1.5
+ },
+ "3,13",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "3,15",
+ "3,16",
+ "3,17"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "c": "#cccccc"
+ },
+ "4,1",
+ "4,2",
+ "4,3",
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7",
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,12",
+ {
+ "x": 2.5,
+ "c": "#cccccc"
+ },
+ "4,15",
+ "4,16",
+ "4,17",
+ {
+ "h": 2
+ },
+ "4,18"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 14.25
+ },
+ "4,13"
+ ],
+ [
+ {
+ "y": -0.25,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,0",
+ {
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "5,6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5,9",
+ "5,10",
+ "5,11",
+ {
+ "x": 3.5,
+ "c": "#cccccc",
+ "w": 2
+ },
+ "5,16",
+ "5,17"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 13.25
+ },
+ "5,12",
+ "5,13",
+ "5,14"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q60_max/ansi/ansi.c b/keyboards/keychron/q60_max/ansi/ansi.c
new file mode 100644
index 0000000000..46ce2edf31
--- /dev/null
+++ b/keyboards/keychron/q60_max/ansi/ansi.c
@@ -0,0 +1,124 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, __ },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, __, __ },
+ { 42, __, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, __ },
+ { __, 55, 56, __, __, __, 57, __, __, __, __, 58, 59, __, __ },
+ },
+ {
+ // LED Index to Physical Position
+ { 0, 0}, {16, 0}, {32, 0}, {48, 0}, {64, 0}, {80, 0}, { 96, 0}, {112, 0}, {128, 0}, {144, 0}, {160, 0}, {176, 0}, {192, 0}, {208, 0}, {224, 0},
+ { 4,16}, {24,16}, {40,16}, {56,16}, {72,16}, {88,16}, {104,16}, {120,16}, {136,16}, {152,16}, {168,16}, {184,16}, {200,16}, {220,16},
+ { 6,32}, {28,32}, {44,32}, {60,32}, {76,32}, {92,32}, {108,32}, {124,32}, {140,32}, {156,32}, {172,32}, {188,32}, {214,32},
+ {10,48}, {36,48}, {52,48}, {68,48}, {84,48}, {100,48}, {116,48}, {132,48}, {148,48}, {164,48}, {180,48}, {202,48}, {224,48},
+ {24,64}, {44,64}, {112,64}, {180,64}, {200,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1
+ }
+};
+
+#endif
diff --git a/keyboards/keychron/q60_max/ansi/config.h b/keyboards/keychron/q60_max/ansi/config.h
new file mode 100644
index 0000000000..9bb93b5093
--- /dev/null
+++ b/keyboards/keychron/q60_max/ansi/config.h
@@ -0,0 +1,49 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 60
+# define DRIVER_CS_PINS \
+ { B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50, 0x50 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 16, 17, 18 }
+# define P24G_INDICATION_LED_MATRIX_INDEX 19
+# define BAT_LEVEL_LED_LIST \
+ { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
+# define LOW_BAT_IND_INDEX \
+ { 57 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q60_max/ansi/keyboard.json b/keyboards/keychron/q60_max/ansi/keyboard.json
new file mode 100644
index 0000000000..91bce79159
--- /dev/null
+++ b/keyboards/keychron/q60_max/ansi/keyboard.json
@@ -0,0 +1,76 @@
+{
+ "usb": {
+ "pid": "0x08C0",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_60": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6, "y": 0},
+ {"matrix": [0, 7], "x": 7, "y": 0},
+ {"matrix": [0, 8], "x": 8, "y": 0},
+ {"matrix": [0, 9], "x": 9, "y": 0},
+ {"matrix": [0, 10], "x": 10, "y": 0},
+ {"matrix": [0, 11], "x": 11, "y": 0},
+ {"matrix": [0, 12], "x": 12, "y": 0},
+ {"matrix": [0, 13], "x": 13, "y": 0},
+ {"matrix": [0, 14], "x": 14, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
+ {"matrix": [1, 1], "x": 1.5, "y": 1},
+ {"matrix": [1, 2], "x": 2.5, "y": 1},
+ {"matrix": [1, 3], "x": 3.5, "y": 1},
+ {"matrix": [1, 4], "x": 4.5, "y": 1},
+ {"matrix": [1, 5], "x": 5.5, "y": 1},
+ {"matrix": [1, 6], "x": 6.5, "y": 1},
+ {"matrix": [1, 7], "x": 7.5, "y": 1},
+ {"matrix": [1, 8], "x": 8.5, "y": 1},
+ {"matrix": [1, 9], "x": 9.5, "y": 1},
+ {"matrix": [1, 10], "x": 10.5, "y": 1},
+ {"matrix": [1, 11], "x": 11.5, "y": 1},
+ {"matrix": [1, 12], "x": 12.5, "y": 1},
+ {"matrix": [1, 13], "x": 13.5, "y": 1, "w": 1.5},
+
+ {"matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
+ {"matrix": [2, 1], "x": 1.75, "y": 2},
+ {"matrix": [2, 2], "x": 2.75, "y": 2},
+ {"matrix": [2, 3], "x": 3.75, "y": 2},
+ {"matrix": [2, 4], "x": 4.75, "y": 2},
+ {"matrix": [2, 5], "x": 5.75, "y": 2},
+ {"matrix": [2, 6], "x": 6.75, "y": 2},
+ {"matrix": [2, 7], "x": 7.75, "y": 2},
+ {"matrix": [2, 8], "x": 8.75, "y": 2},
+ {"matrix": [2, 9], "x": 9.75, "y": 2},
+ {"matrix": [2, 10], "x": 10.75, "y": 2},
+ {"matrix": [2, 11], "x": 11.75, "y": 2},
+ {"matrix": [2, 12], "x": 12.75, "y": 2, "w": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3, "w": 2.25},
+ {"matrix": [3, 2], "x": 2.25, "y": 3},
+ {"matrix": [3, 3], "x": 3.25, "y": 3},
+ {"matrix": [3, 4], "x": 4.25, "y": 3},
+ {"matrix": [3, 5], "x": 5.25, "y": 3},
+ {"matrix": [3, 6], "x": 6.25, "y": 3},
+ {"matrix": [3, 7], "x": 7.25, "y": 3},
+ {"matrix": [3, 8], "x": 8.25, "y": 3},
+ {"matrix": [3, 9], "x": 9.25, "y": 3},
+ {"matrix": [3, 10], "x": 10.25, "y": 3},
+ {"matrix": [3, 11], "x": 11.25, "y": 3},
+ {"matrix": [3, 12], "x": 12.25, "y": 3, "w": 1.75},
+ {"matrix": [3, 13], "x": 14, "y": 3},
+
+ {"matrix": [4, 1], "x": 1.5, "y": 4, "w": 1.25},
+ {"matrix": [4, 2], "x": 2.75, "y": 4, "w": 1.25},
+ {"matrix": [4, 6], "x": 4, "y": 4, "w": 7.25},
+ {"matrix": [4, 11], "x": 11, "y": 4, "w": 1.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4, "w": 1.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q60_max/ansi/keymaps/default/keymap.c b/keyboards/keychron/q60_max/ansi/keymaps/default/keymap.c
new file mode 100644
index 0000000000..a84195318f
--- /dev/null
+++ b/keyboards/keychron/q60_max/ansi/keymaps/default/keymap.c
@@ -0,0 +1,79 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ WIN_BASE,
+ FN,
+ L3,
+ L4,
+ L5
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_60(
+ KC_ESC, 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_BSLS, KC_GRV,
+ 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_DEL,
+ KC_LCTL, 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_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, MO(FN),
+ KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN),
+
+ [WIN_BASE] = LAYOUT_ansi_60(
+ KC_ESC, 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_BSLS, KC_GRV,
+ 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_DEL,
+ KC_LCTL, 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_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, MO(FN),
+ KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN),
+
+ [FN] = LAYOUT_ansi_60(
+ _______, 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_INS, KC_DEL,
+ KC_CAPS, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, KC_PSCR, KC_SCRL, KC_PAUS, KC_UP, _______, KC_BSPC,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, _______, _______, _______, KC_HOME, KC_PGUP, KC_LEFT, KC_RIGHT, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, BAT_LVL, NK_TOGG, _______, KC_END, KC_PGDN, KC_DOWN, _______, _______,
+ _______, _______, _______, _______, _______),
+
+ [L3] = LAYOUT_ansi_60(
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______),
+
+ [L4] = LAYOUT_ansi_60(
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______),
+
+ [L5] = LAYOUT_ansi_60(
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q60_max/ansi/rules.mk b/keyboards/keychron/q60_max/ansi/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q60_max/ansi/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q60_max/board.h b/keyboards/keychron/q60_max/board.h
new file mode 100644
index 0000000000..dcf619eba2
--- /dev/null
+++ b/keyboards/keychron/q60_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT & PIN_PUPDR_PULLUP to avoid FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q60_max/config.h b/keyboards/keychron/q60_max/config.h
new file mode 100644
index 0000000000..7fdfa6efcc
--- /dev/null
+++ b/keyboards/keychron/q60_max/config.h
@@ -0,0 +1,75 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(2)
+#define BL_CYCLE_KEY KC_C
+#define FN_BL_CYCLE_KEY RGB_HUD
+#define BL_TRIG_KEY KC_L
+#define FN_BL_TRIG_KEY KC_PGUP
+#define FN_Z_KEY RGB_RMOD
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q60_max/halconf.h b/keyboards/keychron/q60_max/halconf.h
new file mode 100644
index 0000000000..8c0d5caeb4
--- /dev/null
+++ b/keyboards/keychron/q60_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q60_max/info.json b/keyboards/keychron/q60_max/info.json
new file mode 100644
index 0000000000..4053a97dc4
--- /dev/null
+++ b/keyboards/keychron/q60_max/info.json
@@ -0,0 +1,70 @@
+{
+ "keyboard_name": "Keychron Q60 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string" : true
+ },
+ "matrix_pins": {
+ "cols": ["C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["B5", "B4", "B3", "D2", "C12"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch" :{
+ "pins": ["B12"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "dynamic_keymap": {
+ "layer_count": 6
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q60_max/mcuconf.h b/keyboards/keychron/q60_max/mcuconf.h
new file mode 100644
index 0000000000..681e8fd4cc
--- /dev/null
+++ b/keyboards/keychron/q60_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q60_max/q60_max.c b/keyboards/keychron/q60_max/q60_max.c
new file mode 100644
index 0000000000..71f88749f7
--- /dev/null
+++ b/keyboards/keychron/q60_max/q60_max.c
@@ -0,0 +1,61 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 1 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q60_max/readme.md b/keyboards/keychron/q60_max/readme.md
new file mode 100644
index 0000000000..6a681a058d
--- /dev/null
+++ b/keyboards/keychron/q60_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron Q60 Max
+
+
+
+A customizable 60% keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q60 Max
+* Hardware Availability: [Keychron Q60 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q60-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q60_max/ansi/rgb:default
+
+Flashing example for this keyboard:
+
+ make keychron/q60_max/ansi/rgb:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q60_max/rules.mk b/keyboards/keychron/q60_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q60_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q60_max/via_json/q60_max_ansi.json b/keyboards/keychron/q60_max/via_json/q60_max_ansi.json
new file mode 100644
index 0000000000..596e8fa803
--- /dev/null
+++ b/keyboards/keychron/q60_max/via_json/q60_max_ansi.json
@@ -0,0 +1,213 @@
+{
+ "name": "Keychron Q60 Max",
+ "vendorId": "0x3434",
+ "productId": "0x08C0",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 15},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ "0, 14"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 13"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "2, 12"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 12",
+ "3, 13"
+ ],
+ [
+ {
+ "x": 1.5
+ },
+ "4, 1",
+ {
+ "w": 1.5
+ },
+ "4, 2",
+ {
+ "w": 7,
+ "c": "#cccccc"
+ },
+ "4, 6",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "4, 11",
+ "4, 12"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q65_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/q65_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..7ed9ae1b17
--- /dev/null
+++ b/keyboards/keychron/q65_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,131 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, __ },
+ { 46, 47, __, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60 },
+ { 61, 62, 63, 64, __, __, __, 65, __, __, 66, 67, 68, 69, 70, 71 },
+ },
+ {
+ // LED Index to Physical Position
+ {20, 0}, {33, 0}, {47, 0}, {60, 0}, {73, 0}, {86, 0}, { 99, 0}, {112, 0}, {125, 0}, {138, 0}, {151, 0}, {164, 0}, {177, 0}, {197, 0}, {224, 0},
+ {0,15}, {24,15}, {40,15}, {53,15}, {66,15}, {79,15}, {92,15}, {105,15}, {119,15}, {132,15}, {145,15}, {158,15}, {171,15}, {184,15}, {200,15}, {224,15},
+ {0,30}, {25,30}, {43,30}, {56,30}, {69,30}, {83,30}, {96,30}, {109,30}, {122,30}, {135,30}, {148,30}, {161,30}, {174,30}, {195,30}, {224,30},
+ {0,45}, {29,45}, {50,45}, {63,45}, {76,45}, {89,45}, {102,45}, {115,45}, {128,45}, {141,45}, {155,45}, {168,45}, {186,45}, {207,49}, {224,45},
+ {0,60}, {22,60}, {38,60}, {55,60}, {104,60}, {151,60}, {164,60}, {177,60}, {194,64}, {207,64}, {220,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/q65_max/ansi_encoder/config.h b/keyboards/keychron/q65_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..a9738eae61
--- /dev/null
+++ b/keyboards/keychron/q65_max/ansi_encoder/config.h
@@ -0,0 +1,48 @@
+/* Copyright 2021 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 72
+# define DRIVER_CS_PINS \
+ { B9, B8 }
+
+/* Scan phase of led driver */
+# define PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 32
+# define LOW_BAT_IND_INDEX \
+ { 65 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q65_max/ansi_encoder/keyboard.json b/keyboards/keychron/q65_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..fd3efbc85b
--- /dev/null
+++ b/keyboards/keychron/q65_max/ansi_encoder/keyboard.json
@@ -0,0 +1,89 @@
+{
+ "usb": {
+ "pid": "0x08B0",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_73": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.5, "y": 0.25},
+ {"matrix": [0, 2], "x": 2.5, "y": 0.25},
+ {"matrix": [0, 3], "x": 3.5, "y": 0.25},
+ {"matrix": [0, 4], "x": 4.5, "y": 0.25},
+ {"matrix": [0, 5], "x": 5.5, "y": 0.25},
+ {"matrix": [0, 6], "x": 6.5, "y": 0.25},
+ {"matrix": [0, 7], "x": 7.5, "y": 0.25},
+ {"matrix": [0, 8], "x": 8.5, "y": 0.25},
+ {"matrix": [0, 9], "x": 9.5, "y": 0.25},
+ {"matrix": [0, 10], "x": 10.5, "y": 0.25},
+ {"matrix": [0, 11], "x": 11.5, "y": 0.25},
+ {"matrix": [0, 12], "x": 12.5, "y": 0.25},
+ {"matrix": [0, 13], "x": 13.5, "y": 0.25},
+ {"matrix": [0, 14], "x": 14.5, "y": 0.25, "w": 2},
+ {"matrix": [0, 15], "x": 17, "y": 0.25},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1.5, "y": 1.25, "w": 1.5},
+ {"matrix": [1, 2], "x": 3, "y": 1.25},
+ {"matrix": [1, 3], "x": 4, "y": 1.25},
+ {"matrix": [1, 4], "x": 5, "y": 1.25},
+ {"matrix": [1, 5], "x": 6, "y": 1.25},
+ {"matrix": [1, 6], "x": 7, "y": 1.25},
+ {"matrix": [1, 7], "x": 8, "y": 1.25},
+ {"matrix": [1, 8], "x": 9, "y": 1.25},
+ {"matrix": [1, 9], "x": 10, "y": 1.25},
+ {"matrix": [1, 10], "x": 11, "y": 1.25},
+ {"matrix": [1, 11], "x": 12, "y": 1.25},
+ {"matrix": [1, 12], "x": 13, "y": 1.25},
+ {"matrix": [1, 13], "x": 14, "y": 1.25},
+ {"matrix": [1, 14], "x": 15, "y": 1.25, "w": 1.5},
+ {"matrix": [1, 15], "x": 17, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25, "w": 1.75},
+ {"matrix": [2, 2], "x": 3.25, "y": 2.25},
+ {"matrix": [2, 3], "x": 4.25, "y": 2.25},
+ {"matrix": [2, 4], "x": 5.25, "y": 2.25},
+ {"matrix": [2, 5], "x": 6.25, "y": 2.25},
+ {"matrix": [2, 6], "x": 7.25, "y": 2.25},
+ {"matrix": [2, 7], "x": 8.25, "y": 2.25},
+ {"matrix": [2, 8], "x": 9.25, "y": 2.25},
+ {"matrix": [2, 9], "x": 10.25, "y": 2.25},
+ {"matrix": [2, 10], "x": 11.25, "y": 2.25},
+ {"matrix": [2, 11], "x": 12.25, "y": 2.25},
+ {"matrix": [2, 12], "x": 13.25, "y": 2.25},
+ {"matrix": [2, 13], "x": 14.25, "y": 2.25, "w": 2.25},
+ {"matrix": [2, 14], "x": 17, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25},
+ {"matrix": [3, 1], "x": 1.5, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 13.75, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 14], "x": 15.75, "y": 3.5},
+ {"matrix": [3, 15], "x": 17, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25},
+ {"matrix": [4, 1], "x": 1.5, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 2], "x": 2.75, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 3], "x": 4, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 7], "x": 5.25, "y": 4.25, "w": 6.25},
+ {"matrix": [4, 10], "x": 11.5, "y": 4.25},
+ {"matrix": [4, 11], "x": 12.5, "y": 4.25},
+ {"matrix": [4, 12], "x": 13.5, "y": 4.25},
+ {"matrix": [4, 13], "x": 14.75, "y": 4.5},
+ {"matrix": [4, 14], "x": 15.75, "y": 4.5},
+ {"matrix": [4, 15], "x": 16.75, "y": 4.5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q65_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/q65_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..f53450e169
--- /dev/null
+++ b/keyboards/keychron/q65_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,81 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_73(
+ KC_MUTE, KC_ESC, 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,
+ MC_2, 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_HOME,
+ MC_3, 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_PGUP,
+ MC_4, 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_PGDN,
+ MC_5, KC_LCTL, KC_LOPTN,KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN1),MO(FN2),KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_BASE] = LAYOUT_ansi_73(
+ KC_MUTE, KC_ESC, 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,
+ MC_2, 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_HOME,
+ MC_3, 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_PGUP,
+ MC_4, 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_PGDN,
+ MC_5, KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN1),MO(FN2),KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN1] = LAYOUT_ansi_73(
+ RGB_TOG, KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL,KC_LNPAD,RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_FN1] = LAYOUT_ansi_73(
+ RGB_TOG, KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [FN2] = LAYOUT_ansi_73(
+ _______, KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN1] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_FN1] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [FN2] = {ENCODER_CCW_CW(_______, _______)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q65_max/ansi_encoder/rules.mk b/keyboards/keychron/q65_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q65_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q65_max/board.h b/keyboards/keychron/q65_max/board.h
new file mode 100644
index 0000000000..dcf619eba2
--- /dev/null
+++ b/keyboards/keychron/q65_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT & PIN_PUPDR_PULLUP to avoid FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q65_max/config.h b/keyboards/keychron/q65_max/config.h
new file mode 100644
index 0000000000..bac618e2ae
--- /dev/null
+++ b/keyboards/keychron/q65_max/config.h
@@ -0,0 +1,80 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define BAT_LEVEL_LED_LIST \
+ { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(2)
+#define FN_KEY_2 MO(3)
+#define FN_KEY_3 MO(4)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q65_max/halconf.h b/keyboards/keychron/q65_max/halconf.h
new file mode 100644
index 0000000000..8c0d5caeb4
--- /dev/null
+++ b/keyboards/keychron/q65_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q65_max/info.json b/keyboards/keychron/q65_max/info.json
new file mode 100644
index 0000000000..4658a01f12
--- /dev/null
+++ b/keyboards/keychron/q65_max/info.json
@@ -0,0 +1,80 @@
+{
+ "keyboard_name": "Keychron Q65 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string" : true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["B12"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "dynamic_keymap": {
+ "layer_count": 5
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q65_max/mcuconf.h b/keyboards/keychron/q65_max/mcuconf.h
new file mode 100644
index 0000000000..681e8fd4cc
--- /dev/null
+++ b/keyboards/keychron/q65_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q65_max/q65_max.c b/keyboards/keychron/q65_max/q65_max.c
new file mode 100644
index 0000000000..71f88749f7
--- /dev/null
+++ b/keyboards/keychron/q65_max/q65_max.c
@@ -0,0 +1,61 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 1 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q65_max/readme.md b/keyboards/keychron/q65_max/readme.md
new file mode 100644
index 0000000000..3a1dc24e8b
--- /dev/null
+++ b/keyboards/keychron/q65_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron Q65 Max
+
+
+
+A customizable 65% keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q65 Max
+* Hardware Availability: [Keychron Q65 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q65-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q65_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q65_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q65_max/rules.mk b/keyboards/keychron/q65_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q65_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q65_max/via_json/q65_max_ansi_encoder.json b/keyboards/keychron/q65_max/via_json/q65_max_ansi_encoder.json
new file mode 100644
index 0000000000..88d98270a9
--- /dev/null
+++ b/keyboards/keychron/q65_max/via_json/q65_max_ansi_encoder.json
@@ -0,0 +1,275 @@
+{
+ "name": "Keychron Q65 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x08B0",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.5,
+ "y": 0.25,
+ "c": "#777777"
+ },
+ "0, 1",
+ {
+ "c": "#cccccc"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "c": "#aaaaaa"
+ },
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "0, 14",
+ {
+ "x": 0.5
+ },
+ "0, 15"
+ ],
+ [
+ "1, 0",
+ {
+ "x": 0.5,
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 1",
+ {
+ "c": "#cccccc"
+ },
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ "1, 13",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 14",
+ {
+ "x": 0.5
+ },
+ "1, 15"
+ ],
+ [
+ "2, 0",
+ {
+ "x": 0.5,
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "2, 1",
+ {
+ "c": "#cccccc"
+ },
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "c": "#aaaaaa"
+ },
+ {
+ "x": 0.5
+ },
+ "2, 14"
+ ],
+ [
+ "3, 0",
+ {
+ "x": 0.5,
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 1",
+ {
+ "c": "#cccccc"
+ },
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 12",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 13",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "3, 14",
+ {
+ "x": 0.25,
+ "y": -0.25,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ "4, 0",
+ {
+ "x": 0.5,
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 1",
+ {
+ "w": 1.25
+ },
+ "4, 2",
+ {
+ "w": 1.25
+ },
+ "4, 3",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "4, 7",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "4, 13",
+ "4, 14",
+ "4, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/q6_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/q6_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..42c08ec1d9
--- /dev/null
+++ b/keyboards/keychron/q6_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,175 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB10_CA6, CB12_CA6, CB11_CA6},
+ {1, CB10_CA5, CB12_CA5, CB11_CA5},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, 14, 15, 16, 17, 18 },
+ { 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38 },
+ { 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58 },
+ { 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78 },
+ { 79, __, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, __, 90, __, 91, __, 92, 93, 94 },
+ { 95, 96, 97, __, __, __, 98, __, __, __, 99, 100, 101, 102, 103, 104, 105, __, 106, 107 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {13, 0}, {24, 0}, {34, 0}, {45, 0}, {57, 0}, {68, 0}, {78, 0}, {89, 0}, {102, 0}, {112, 0}, {123, 0}, {133, 0}, {159, 0}, {169, 0}, {180, 0}, {193, 0}, {203, 0}, {214, 0},
+ {0,15}, {10,15}, {21,15}, {31,15}, {42,15}, {52,15}, {63,15}, {73,15}, {83,15}, { 94,15}, {104,15}, {115,15}, {125,15}, {141,15}, {159,15}, {169,15}, {180,15}, {193,15}, {203,15}, {214,15},
+ {3,27}, {16,27}, {26,27}, {36,27}, {47,27}, {57,27}, {68,27}, {78,27}, {89,27}, { 99,27}, {109,27}, {120,27}, {130,27}, {143,27}, {159,27}, {169,27}, {180,27}, {193,27}, {203,27}, {214,27},
+ {4,40}, {18,40}, {29,40}, {39,40}, {50,40}, {60,40}, {70,40}, {81,40}, {91,40}, {102,40}, {112,40}, {123,40}, {139,40}, {224, 0}, {224,15}, {224,34}, {224,58}, {193,40}, {203,40}, {214,40},
+ {7,52}, {23,52}, {34,52}, {44,52}, {55,52}, {65,52}, {76,52}, {86,52}, { 96,52}, {107,52}, {117,52}, {137,52}, {169,52}, {193,52}, {203,52}, {214,52},
+ {1,64}, {14,64}, {27,64}, {66,64}, {105,64}, {118,64}, {131,64}, {145,64}, {159,64}, {169,64}, {180,64}, {198,64}, {214,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/q6_max/ansi_encoder/config.h b/keyboards/keychron/q6_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..37a5493cd9
--- /dev/null
+++ b/keyboards/keychron/q6_max/ansi_encoder/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 108
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define NUM_LOCK_INDEX 36
+# define CAPS_LOCK_INDEX 59
+# define LOW_BAT_IND_INDEX \
+ { 98 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q6_max/ansi_encoder/keyboard.json b/keyboards/keychron/q6_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..a438ce3c04
--- /dev/null
+++ b/keyboards/keychron/q6_max/ansi_encoder/keyboard.json
@@ -0,0 +1,126 @@
+{
+ "usb": {
+ "pid": "0x0860",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_109_ansi": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+ {"matrix": [0, 15], "x": 16.25, "y": 0},
+ {"matrix": [0, 16], "x": 17.25, "y": 0},
+ {"matrix": [0, 17], "x": 18.5, "y": 0},
+ {"matrix": [0, 18], "x": 19.5, "y": 0},
+ {"matrix": [0, 19], "x": 20.5, "y": 0},
+ {"matrix": [3, 13], "x": 21.5, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 15], "x": 16.25, "y": 1.25},
+ {"matrix": [1, 16], "x": 17.25, "y": 1.25},
+ {"matrix": [1, 17], "x": 18.5, "y": 1.25},
+ {"matrix": [1, 18], "x": 19.5, "y": 1.25},
+ {"matrix": [1, 19], "x": 20.5, "y": 1.25},
+ {"matrix": [3, 14], "x": 21.5, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 13], "x": 13.5, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 16.25, "y": 2.25},
+ {"matrix": [2, 16], "x": 17.25, "y": 2.25},
+ {"matrix": [2, 17], "x": 18.5, "y": 2.25},
+ {"matrix": [2, 18], "x": 19.5, "y": 2.25},
+ {"matrix": [2, 19], "x": 20.5, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 17], "x": 18.5, "y": 3.25},
+ {"matrix": [3, 18], "x": 19.5, "y": 3.25},
+ {"matrix": [3, 19], "x": 20.5, "y": 3.25},
+ {"matrix": [3, 15], "x": 21.5, "y": 2.25, "h": 2},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 12.25, "y": 4.25, "w": 2.75},
+ {"matrix": [4, 15], "x": 16.25, "y": 4.25},
+ {"matrix": [4, 17], "x": 18.5, "y": 4.25},
+ {"matrix": [4, 18], "x": 19.5, "y": 4.25},
+ {"matrix": [4, 19], "x": 20.5, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.25},
+ {"matrix": [5, 15], "x": 16.25, "y": 5.25},
+ {"matrix": [5, 16], "x": 17.25, "y": 5.25},
+ {"matrix": [5, 18], "x": 18.5, "y": 5.25, "w": 2},
+ {"matrix": [5, 19], "x": 20.5, "y": 5.25},
+ {"matrix": [3, 16], "x": 21.5, "y": 4.25, "h": 2}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/q6_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/q6_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..82c6b3bdd8
--- /dev/null
+++ b/keyboards/keychron/q6_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,74 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_109_ansi(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_MUTE, KC_SNAP, KC_SIRI, RGB_MOD, KC_F13, KC_F14, KC_F15, KC_F16,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+ [MAC_FN] = LAYOUT_109_ansi(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, RGB_TOG, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+ [WIN_BASE] = LAYOUT_109_ansi(
+ 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_MUTE, KC_PSCR, KC_CTANA, RGB_MOD, _______, _______, _______, _______,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+ [WIN_FN] = LAYOUT_109_ansi(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, RGB_TOG, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q6_max/ansi_encoder/rules.mk b/keyboards/keychron/q6_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q6_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q6_max/board.h b/keyboards/keychron/q6_max/board.h
new file mode 100644
index 0000000000..c52da0f35f
--- /dev/null
+++ b/keyboards/keychron/q6_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q6_max/config.h b/keyboards/keychron/q6_max/config.h
new file mode 100644
index 0000000000..242285b0a7
--- /dev/null
+++ b/keyboards/keychron/q6_max/config.h
@@ -0,0 +1,81 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_LOW_LED_PIN C9
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 23
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 20, 21, 22 }
+# define BAT_LEVEL_LED_LIST \
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q6_max/halconf.h b/keyboards/keychron/q6_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/q6_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q6_max/info.json b/keyboards/keychron/q6_max/info.json
new file mode 100644
index 0000000000..21089420c6
--- /dev/null
+++ b/keyboards/keychron/q6_max/info.json
@@ -0,0 +1,77 @@
+{
+ "keyboard_name": "Keychron Q6 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string" : true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A13", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "B10"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B14",
+ "pin_b": "B15"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["B12"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q6_max/iso_encoder/config.h b/keyboards/keychron/q6_max/iso_encoder/config.h
new file mode 100644
index 0000000000..fa959dd849
--- /dev/null
+++ b/keyboards/keychron/q6_max/iso_encoder/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 109
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define NUM_LOCK_INDEX 36
+# define CAPS_LOCK_INDEX 59
+# define LOW_BAT_IND_INDEX \
+ { 99 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTSs
+
+#endif
diff --git a/keyboards/keychron/q6_max/iso_encoder/iso_encoder.c b/keyboards/keychron/q6_max/iso_encoder/iso_encoder.c
new file mode 100644
index 0000000000..7c5443e4ca
--- /dev/null
+++ b/keyboards/keychron/q6_max/iso_encoder/iso_encoder.c
@@ -0,0 +1,177 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB10_CA6, CB12_CA6, CB11_CA6},
+ {1, CB10_CA5, CB12_CA5, CB11_CA5},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to RGB Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, 14, 15, 16, 17, 18 },
+ { 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38 },
+ { 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58 },
+ { 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78 },
+ { 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, __, 91, __, 92, __, 93, 94, 95 },
+ { 96, 97, 98, __, __, __, 99, __, __, __, 100, 101, 102, 103, 104, 105, 106, __, 107, 108 },
+ },
+ {
+ // RGB Index to Physical Position
+ {0, 0}, {13, 0}, {24, 0}, {34, 0}, {45, 0}, {57, 0}, {68, 0}, {78, 0}, {89, 0}, {102,0}, {112, 0}, {123, 0}, {133, 0}, {159, 0}, {169,0}, {180, 0}, {193,0}, {203,0}, {214,0},
+ {0,15}, {10,15}, {21,15}, {32,15}, {42,15}, {52,15}, {63,15}, {73,15}, {83,15}, {94,15}, {104,15}, {115,15}, {125,15}, {141,15}, {159,15}, {169,15}, {180,15}, {193,15},{203,15},{214,15},
+ {3,26}, {16,26}, {26,26}, {36,26}, {47,26}, {57,26}, {68,26}, {78,26}, {89,26}, {99,26}, {109,26}, {120,26}, {130,26}, {141,26}, {159,26}, {169,26}, {180,26}, {193,26},{203,26},{214,26},
+ {4,38}, {18,38}, {29,38}, {39,38}, {50,38}, {60,38}, {70,38}, {81,38}, {91,38}, {102,38},{112,38}, {133,38}, {147,38}, {224, 0}, {224,15}, {224,26}, {224,49}, {193,38},{204,38},{214,38},
+ {1,49}, {13,49}, {23,49}, {34,49}, {44,49}, {55,49}, {65,49}, {76,49}, {86,49}, {96,49}, {107,49}, {117,49}, {137,49}, {169,49}, {193,49},{204,49},{214,49},
+ {1,61}, {14,61}, {27,61}, {66,61}, {105,61}, {118,61}, {131,61}, {145,64}, {159,61}, {169,61}, {180,61}, {198,61},{214,61}
+ },
+ {
+ // RGB Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+
+};
+#endif
diff --git a/keyboards/keychron/q6_max/iso_encoder/keyboard.json b/keyboards/keychron/q6_max/iso_encoder/keyboard.json
new file mode 100644
index 0000000000..6b02e7cdac
--- /dev/null
+++ b/keyboards/keychron/q6_max/iso_encoder/keyboard.json
@@ -0,0 +1,128 @@
+{
+ "usb": {
+ "pid": "0x0861",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_iso_110": {
+ "layout": [
+ {"matrix":[0,0], "x":0, "y":0},
+ {"matrix":[0,1], "x":1.25, "y":0},
+ {"matrix":[0,2], "x":2.25, "y":0},
+ {"matrix":[0,3], "x":3.25, "y":0},
+ {"matrix":[0,4], "x":4.25, "y":0},
+ {"matrix":[0,5], "x":5.5, "y":0},
+ {"matrix":[0,6], "x":6.5, "y":0},
+ {"matrix":[0,7], "x":7.5, "y":0},
+ {"matrix":[0,8], "x":8.5, "y":0},
+ {"matrix":[0,9], "x":9.75, "y":0},
+ {"matrix":[0,10], "x":10.75, "y":0},
+ {"matrix":[0,11], "x":11.75, "y":0},
+ {"matrix":[0,12], "x":12.75, "y":0},
+ {"matrix":[0,13], "x":14, "y":0},
+ {"matrix":[0,14], "x":15.25, "y":0},
+ {"matrix":[0,15], "x":16.25, "y":0},
+ {"matrix":[0,16], "x":17.25, "y":0},
+ {"matrix":[0,17], "x":18.5, "y":0},
+ {"matrix":[0,18], "x":19.5, "y":0},
+ {"matrix":[0,19], "x":20.5, "y":0},
+ {"matrix":[3,13], "x":21.5, "y":0},
+
+ {"matrix":[1,0], "x":0, "y":1.25},
+ {"matrix":[1,1], "x":1, "y":1.25},
+ {"matrix":[1,2], "x":2, "y":1.25},
+ {"matrix":[1,3], "x":3, "y":1.25},
+ {"matrix":[1,4], "x":4, "y":1.25},
+ {"matrix":[1,5], "x":5, "y":1.25},
+ {"matrix":[1,6], "x":6, "y":1.25},
+ {"matrix":[1,7], "x":7, "y":1.25},
+ {"matrix":[1,8], "x":8, "y":1.25},
+ {"matrix":[1,9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[1,13], "x":13, "y":1.25, "w":2},
+ {"matrix":[1,14], "x":15.25, "y":1.25},
+ {"matrix":[1,15], "x":16.25, "y":1.25},
+ {"matrix":[1,16], "x":17.25, "y":1.25},
+ {"matrix":[1,17], "x":18.5, "y":1.25},
+ {"matrix":[1,18], "x":19.5, "y":1.25},
+ {"matrix":[1,19], "x":20.5, "y":1.25},
+ {"matrix":[3,14], "x":21.5, "y":1.25},
+
+ {"matrix":[2,0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2,1], "x":1.5, "y":2.25},
+ {"matrix":[2,2], "x":2.5, "y":2.25},
+ {"matrix":[2,3], "x":3.5, "y":2.25},
+ {"matrix":[2,4], "x":4.5, "y":2.25},
+ {"matrix":[2,5], "x":5.5, "y":2.25},
+ {"matrix":[2,6], "x":6.5, "y":2.25},
+ {"matrix":[2,7], "x":7.5, "y":2.25},
+ {"matrix":[2,8], "x":8.5, "y":2.25},
+ {"matrix":[2,9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,14], "x":15.25, "y":2.25},
+ {"matrix":[2,15], "x":16.25, "y":2.25},
+ {"matrix":[2,16], "x":17.25, "y":2.25},
+ {"matrix":[2,17], "x":18.5, "y":2.25},
+ {"matrix":[2,18], "x":19.5, "y":2.25},
+ {"matrix":[2,19], "x":20.5, "y":2.25},
+
+ {"matrix":[3,0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3,1], "x":1.75, "y":3.25},
+ {"matrix":[3,2], "x":2.75, "y":3.25},
+ {"matrix":[3,3], "x":3.75, "y":3.25},
+ {"matrix":[3,4], "x":4.75, "y":3.25},
+ {"matrix":[3,5], "x":5.75, "y":3.25},
+ {"matrix":[3,6], "x":6.75, "y":3.25},
+ {"matrix":[3,7], "x":7.75, "y":3.25},
+ {"matrix":[3,8], "x":8.75, "y":3.25},
+ {"matrix":[3,9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,12], "x":12.75, "y":3.25},
+ {"matrix": [2,13], "x": 13.75, "y": 2.25, "w": 1.25, "h": 2},
+ {"matrix":[3,17], "x":18.5, "y":3.25},
+ {"matrix":[3,18], "x":19.5, "y":3.25},
+ {"matrix":[3,19], "x":20.5, "y":3.25},
+ {"matrix":[3,15], "x":21.5, "y":2.25, "h": 2},
+
+ {"matrix":[4,0], "x":0, "y":4.25, "w":1.25},
+ {"matrix":[4,1], "x":1.25, "y":4.25},
+ {"matrix":[4,2], "x":2.25, "y":4.25},
+ {"matrix":[4,3], "x":3.25, "y":4.25},
+ {"matrix":[4,4], "x":4.25, "y":4.25},
+ {"matrix":[4,5], "x":5.25, "y":4.25},
+ {"matrix":[4,6], "x":6.25, "y":4.25},
+ {"matrix":[4,7], "x":7.25, "y":4.25},
+ {"matrix":[4,8], "x":8.25, "y":4.25},
+ {"matrix":[4,9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25, "y":4.25},
+ {"matrix":[4,11], "x":11.25, "y":4.25},
+ {"matrix":[4,13], "x":12.25, "y":4.25, "w":2.75},
+ {"matrix":[4,15], "x":16.25, "y":4.25},
+ {"matrix":[4,17], "x":18.5, "y":4.25},
+ {"matrix":[4,18], "x":19.5, "y":4.25},
+ {"matrix":[4,19], "x":20.5, "y":4.25},
+
+ {"matrix":[5,0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5,1], "x":1.25, "y":5.25, "w":1.25},
+ {"matrix":[5,2], "x":2.5, "y":5.25, "w":1.25},
+ {"matrix":[5,6], "x":3.75, "y":5.25, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5.25, "w":1.25},
+ {"matrix":[5,11], "x":11.25, "y":5.25, "w":1.25},
+ {"matrix":[5,12], "x":12.5, "y":5.25, "w":1.25},
+ {"matrix":[5,13], "x":13.75, "y":5.25, "w":1.25},
+ {"matrix":[5,14], "x":15.25, "y":5.25},
+ {"matrix":[5,15], "x":16.25, "y":5.25},
+ {"matrix":[5,16], "x":17.25, "y":5.25},
+ {"matrix":[5,18], "x":18.5, "y":5.25, "w":2},
+ {"matrix":[5,19], "x":20.5, "y":5.25},
+ {"matrix":[3,16], "x":21.5, "y":4.25, "h":2}
+ ]
+ }
+ }
+
+}
diff --git a/keyboards/keychron/q6_max/iso_encoder/keymaps/default/keymap.c b/keyboards/keychron/q6_max/iso_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..baaf299fd7
--- /dev/null
+++ b/keyboards/keychron/q6_max/iso_encoder/keymaps/default/keymap.c
@@ -0,0 +1,76 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_110(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_MUTE, KC_SNAP, KC_SIRI, RGB_MOD, KC_F13, KC_F14, KC_F15, KC_F16,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [MAC_FN] = LAYOUT_iso_110(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, RGB_TOG, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_110(
+ 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_MUTE, KC_PSCR, KC_CTANA, RGB_MOD, _______, _______, _______, _______,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+
+ [WIN_FN] = LAYOUT_iso_110(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, RGB_TOG, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q6_max/iso_encoder/rules.mk b/keyboards/keychron/q6_max/iso_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q6_max/iso_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q6_max/mcuconf.h b/keyboards/keychron/q6_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/q6_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q6_max/q6_max.c b/keyboards/keychron/q6_max/q6_max.c
new file mode 100644
index 0000000000..c604e127ed
--- /dev/null
+++ b/keyboards/keychron/q6_max/q6_max.c
@@ -0,0 +1,84 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 2 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ } else {
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q6_max/readme.md b/keyboards/keychron/q6_max/readme.md
new file mode 100644
index 0000000000..e403583d6e
--- /dev/null
+++ b/keyboards/keychron/q6_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron Q6 Max
+
+
+
+A customizable 100% fullsize keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q6 Max
+* Hardware Availability: [Keychron Q6 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q6-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q6_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q6_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q6_max/rules.mk b/keyboards/keychron/q6_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q6_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q6_max/via_json/q6_max_ansi_encoder.json b/keyboards/keychron/q6_max/via_json/q6_max_ansi_encoder.json
new file mode 100644
index 0000000000..5254a68dfa
--- /dev/null
+++ b/keyboards/keychron/q6_max/via_json/q6_max_ansi_encoder.json
@@ -0,0 +1,349 @@
+{
+ "name": "Keychron Q6 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0860",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 20},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 13\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.25
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 17",
+ "0, 18",
+ "0, 19",
+ "3, 13"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "1, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#cccccc"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 17",
+ "1, 18",
+ "1, 19",
+ "3, 14"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#cccccc"
+ },
+ "2, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#cccccc"
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "2, 17",
+ "2, 18",
+ "2, 19",
+ {
+ "h": 2,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#cccccc"
+ },
+ "3, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 12",
+ {
+ "x": 3.5,
+ "c": "#aaaaaa"
+ },
+ "3, 17",
+ "3, 18",
+ "3, 19"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#cccccc"
+ },
+ "4, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#cccccc"
+ },
+ "4, 13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 15",
+ {
+ "x": 1.25
+ },
+ "4, 17",
+ "4, 18",
+ "4, 19",
+ {
+ "h": 2
+ },
+ "3, 16"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#aaaaaa"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16",
+ {
+ "x": 0.25,
+ "w": 2
+ },
+ "5, 18",
+ "5, 19"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/q8_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/q8_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..e8425ee2a3
--- /dev/null
+++ b/keyboards/keychron/q8_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,131 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB12_CA2, CB10_CA2, CB11_CA2},
+ {0, CB12_CA3, CB10_CA3, CB11_CA3},
+ {0, CB12_CA4, CB10_CA4, CB11_CA4},
+ {0, CB12_CA5, CB10_CA5, CB11_CA5},
+ {0, CB12_CA6, CB10_CA6, CB11_CA6},
+ {0, CB12_CA7, CB10_CA7, CB11_CA7},
+ {0, CB12_CA8, CB10_CA8, CB11_CA8},
+ {0, CB12_CA9, CB10_CA9, CB11_CA9},
+ {0, CB12_CA10, CB10_CA10, CB11_CA10},
+ {0, CB12_CA11, CB10_CA11, CB11_CA11},
+ {0, CB12_CA12, CB10_CA12, CB11_CA12},
+ {0, CB12_CA13, CB10_CA13, CB11_CA13},
+ {0, CB12_CA14, CB10_CA14, CB11_CA14},
+ {0, CB12_CA15, CB10_CA15, CB11_CA15},
+
+ {0, CB3_CA2, CB1_CA2, CB2_CA2},
+ {0, CB3_CA3, CB1_CA3, CB2_CA3},
+ {0, CB3_CA4, CB1_CA4, CB2_CA4},
+ {0, CB3_CA5, CB1_CA5, CB2_CA5},
+ {0, CB3_CA6, CB1_CA6, CB2_CA6},
+ {0, CB3_CA7, CB1_CA7, CB2_CA7},
+ {0, CB3_CA8, CB1_CA8, CB2_CA8},
+ {0, CB3_CA9, CB1_CA9, CB2_CA9},
+ {0, CB3_CA10, CB1_CA10, CB2_CA10},
+ {0, CB3_CA11, CB1_CA11, CB2_CA11},
+ {0, CB3_CA12, CB1_CA12, CB2_CA12},
+ {0, CB3_CA13, CB1_CA13, CB2_CA13},
+ {0, CB3_CA14, CB1_CA14, CB2_CA14},
+ {0, CB3_CA15, CB1_CA15, CB2_CA15},
+ {0, CB3_CA16, CB1_CA16, CB2_CA16},
+
+ {1, CB3_CA15, CB1_CA15, CB2_CA15},
+ {1, CB3_CA14, CB1_CA14, CB2_CA14},
+ {1, CB3_CA13, CB1_CA13, CB2_CA13},
+ {1, CB3_CA12, CB1_CA12, CB2_CA12},
+ {1, CB3_CA11, CB1_CA11, CB2_CA11},
+ {1, CB3_CA10, CB1_CA10, CB2_CA10},
+ {1, CB3_CA8, CB1_CA8, CB2_CA8},
+ {1, CB3_CA7, CB1_CA7, CB2_CA7},
+ {1, CB3_CA6, CB1_CA6, CB2_CA6},
+ {1, CB3_CA5, CB1_CA5, CB2_CA5},
+ {1, CB3_CA4, CB1_CA4, CB2_CA4},
+ {1, CB3_CA3, CB1_CA3, CB2_CA3},
+ {1, CB3_CA2, CB1_CA2, CB2_CA2},
+ {1, CB3_CA1, CB1_CA1, CB2_CA1},
+
+ {1, CB9_CA15, CB7_CA15, CB8_CA15},
+ {1, CB9_CA13, CB7_CA13, CB8_CA13},
+ {1, CB9_CA12, CB7_CA12, CB8_CA12},
+ {1, CB9_CA11, CB7_CA11, CB8_CA11},
+ {1, CB9_CA10, CB7_CA10, CB8_CA10},
+ {1, CB9_CA9, CB7_CA9, CB8_CA9},
+ {1, CB9_CA8, CB7_CA8, CB8_CA8},
+ {1, CB9_CA7, CB7_CA7, CB8_CA7},
+ {1, CB9_CA6, CB7_CA6, CB8_CA6},
+ {1, CB9_CA5, CB7_CA5, CB8_CA5},
+ {1, CB9_CA4, CB7_CA4, CB8_CA4},
+ {1, CB9_CA3, CB7_CA3, CB8_CA3},
+ {1, CB9_CA2, CB7_CA2, CB8_CA2},
+ {1, CB9_CA1, CB7_CA1, CB8_CA1},
+
+ {1, CB6_CA15, CB4_CA15, CB5_CA15},
+ {1, CB6_CA14, CB4_CA14, CB5_CA14},
+ {1, CB6_CA13, CB4_CA13, CB5_CA13},
+ {1, CB6_CA12, CB4_CA12, CB5_CA12},
+ {1, CB6_CA9, CB4_CA9, CB5_CA9},
+ {1, CB6_CA8, CB4_CA8, CB5_CA8},
+ {1, CB6_CA7, CB4_CA7, CB5_CA7},
+ {1, CB6_CA6, CB4_CA6, CB5_CA6},
+ {1, CB6_CA3, CB4_CA3, CB5_CA3},
+ {1, CB6_CA2, CB4_CA2, CB5_CA2},
+ {1, CB6_CA1, CB4_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28 },
+ { 29, 30, 31, 32, 33, 34, __, 35, 36, 37, 38, 39, 40, 41, 42 },
+ { 43, __, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56 },
+ { 57, 58, 59, 60, __, __, 61, 62, 63, 64, __, __, 65, 66, 67 },
+ },
+ {
+ // LED Index to Physical Position
+ {7, 1}, {20, 1}, {33, 0}, {47, 3}, {60, 6}, {73, 8}, { 86,11}, {107,11}, {120, 8}, {133, 6}, {146, 3}, {160, 0}, {173, 1}, {193, 1},
+ {7,14}, {24,14}, {38,14}, {51,17}, {64,20}, {77,22}, {103,25}, {116,22}, {129,19}, {142,17}, {155,14}, {170,14}, {183,14}, {200,14}, {222,16},
+ {6,27}, {24,27}, {39,28}, {52,30}, {65,33}, {78,36}, {109,37}, {122,34}, {135,31}, {148,29}, {162,27}, {176,27}, {197,27}, {224,29},
+ {7,40}, {28,40}, {43,41}, {56,44}, {69,47}, { 82,49}, {102,51}, {115,49}, {128,46}, {141,43}, {154,41}, {169,40}, {187,40}, {209,43},
+ {0,53}, {17,53}, {42,54}, {64,59}, { 85,63}, {105,64}, {129,59}, {154,54}, {196,56}, {209,56}, {222,56}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/q8_max/ansi_encoder/config.h b/keyboards/keychron/q8_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..c0672c5120
--- /dev/null
+++ b/keyboards/keychron/q8_max/ansi_encoder/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 68
+# define DRIVER_CS_PINS \
+ { B8, B10 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40, 0x40 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 29
+# define LOW_BAT_IND_INDEX \
+ { 60, 63 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/q8_max/ansi_encoder/keyboard.json b/keyboards/keychron/q8_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..f9285f8e86
--- /dev/null
+++ b/keyboards/keychron/q8_max/ansi_encoder/keyboard.json
@@ -0,0 +1,85 @@
+{
+ "usb": {
+ "pid": "0x0880",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_69": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0.75, "y": 0},
+ {"matrix": [0, 1], "x": 1.75, "y": 0},
+ {"matrix": [0, 2], "x": 2.75, "y": 0},
+ {"matrix": [0, 3], "x": 3.75, "y": 0.25},
+ {"matrix": [0, 4], "x": 4.75, "y": 0.25},
+ {"matrix": [0, 5], "x": 5.75, "y": 0.5},
+ {"matrix": [0, 6], "x": 6.75, "y": 0.75},
+ {"matrix": [0, 7], "x": 8.25, "y": 0.75},
+ {"matrix": [0, 8], "x": 9.25, "y": 0.5},
+ {"matrix": [0, 9], "x": 10.25, "y": 0.25},
+ {"matrix": [0, 10], "x": 11.25, "y": 0.25},
+ {"matrix": [0, 11], "x": 12.25, "y": 0},
+ {"matrix": [0, 12], "x": 13.25, "y": 0},
+ {"matrix": [0, 13], "x": 14.25, "y": 0, "w": 2},
+ {"matrix": [0, 14], "x": 16.75, "y": 0},
+
+ {"matrix": [1, 0], "x": 0.5, "y": 1, "w": 1.5},
+ {"matrix": [1, 1], "x": 2, "y": 1},
+ {"matrix": [1, 2], "x": 3, "y": 1},
+ {"matrix": [1, 3], "x": 4, "y": 1.25},
+ {"matrix": [1, 4], "x": 5, "y": 1.5},
+ {"matrix": [1, 5], "x": 6, "y": 1.75},
+ {"matrix": [1, 6], "x": 8, "y": 1.75},
+ {"matrix": [1, 7], "x": 9, "y": 1.75},
+ {"matrix": [1, 8], "x": 10, "y": 1.5},
+ {"matrix": [1, 9], "x": 11, "y": 1.25},
+ {"matrix": [1, 10], "x": 12, "y": 1},
+ {"matrix": [1, 11], "x": 13, "y": 1},
+ {"matrix": [1, 12], "x": 14, "y": 1},
+ {"matrix": [1, 13], "x": 15, "y": 1, "w": 1.5},
+ {"matrix": [1, 14], "x": 17, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0.25, "y": 2, "w": 1.75},
+ {"matrix": [2, 1], "x": 2, "y": 2},
+ {"matrix": [2, 2], "x": 3.25, "y": 2},
+ {"matrix": [2, 3], "x": 4.25, "y": 2.25},
+ {"matrix": [2, 4], "x": 5, "y": 2.5},
+ {"matrix": [2, 5], "x": 6, "y": 2.75},
+ {"matrix": [2, 7], "x": 8.5, "y": 2.75},
+ {"matrix": [2, 8], "x": 9.5, "y": 2.5},
+ {"matrix": [2, 9], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 12.5, "y": 2},
+ {"matrix": [2, 12], "x": 13.5, "y": 2},
+ {"matrix": [2, 13], "x": 14.5, "y": 2, "w": 2.25},
+ {"matrix": [2, 14], "x": 17, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3, "w": 2.25},
+ {"matrix": [3, 2], "x": 2.25, "y": 3},
+ {"matrix": [3, 3], "x": 3.5, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.5, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.5, "y": 3.5},
+ {"matrix": [3, 6], "x": 6.25, "y": 3.75},
+ {"matrix": [3, 7], "x": 7.75, "y": 4},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.75},
+ {"matrix": [3, 9], "x": 10, "y": 3.5},
+ {"matrix": [3, 10], "x": 10.75, "y": 3},
+ {"matrix": [3, 11], "x": 11.75, "y": 3},
+ {"matrix": [3, 12], "x": 13, "y": 3},
+ {"matrix": [3, 13], "x": 14, "y": 3, "w": 1.75},
+ {"matrix": [3, 14], "x": 16, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4, "w": 1.25},
+ {"matrix": [4, 2], "x": 3.25, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 3], "x": 4.5, "y": 4.5, "w": 2.25},
+ {"matrix": [4, 6], "x": 6.75, "y": 4.75},
+ {"matrix": [4, 7], "x": 8.25, "y": 5},
+ {"matrix": [4, 8], "x": 9, "y": 4.5, "w": 2.75},
+ {"matrix": [4, 9], "x": 11.75, "y": 4},
+ {"matrix": [4, 12], "x": 15, "y": 4.25},
+ {"matrix": [4, 13], "x": 16, "y": 4.25},
+ {"matrix": [4, 14], "x": 17, "y": 4.25}
+ ]
+ }
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/q8_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/q8_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..900f8c951e
--- /dev/null
+++ b/keyboards/keychron/q8_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,82 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_69(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN1), MO(FN2), KC_SPC, KC_RCMMD, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_BASE] = LAYOUT_ansi_69(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN1), MO(FN2), KC_SPC, KC_RALT, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN1] = LAYOUT_ansi_69(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL,KC_LNPAD,RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_FN1] = LAYOUT_ansi_69(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [FN2] = LAYOUT_ansi_69(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN1] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_FN1] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [FN2] = {ENCODER_CCW_CW(_______, _______)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/q8_max/ansi_encoder/rules.mk b/keyboards/keychron/q8_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/q8_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/q8_max/board.h b/keyboards/keychron/q8_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/q8_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/q8_max/config.h b/keyboards/keychron/q8_max/config.h
new file mode 100644
index 0000000000..025db94f28
--- /dev/null
+++ b/keyboards/keychron/q8_max/config.h
@@ -0,0 +1,78 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B9
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN C14
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 18
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 15, 16, 17 }
+# define BAT_LEVEL_LED_LIST \
+ { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(4)
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/q8_max/halconf.h b/keyboards/keychron/q8_max/halconf.h
new file mode 100644
index 0000000000..49257ab5df
--- /dev/null
+++ b/keyboards/keychron/q8_max/halconf.h
@@ -0,0 +1,30 @@
+/* Copyright 2024 Keychron
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see .
+ */
+
+#pragma once
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+# define HAL_USE_SPI TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/q8_max/info.json b/keyboards/keychron/q8_max/info.json
new file mode 100644
index 0000000000..9baa393420
--- /dev/null
+++ b/keyboards/keychron/q8_max/info.json
@@ -0,0 +1,80 @@
+{
+ "keyboard_name": "Keychron Q8 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string" : true
+ },
+ "matrix_pins": {
+ "cols": ["C8", "C9", "A8", "A15", "C10", "C11", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3"],
+ "rows": ["D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B14",
+ "pin_b": "B15"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["B7"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "dynamic_keymap": {
+ "layer_count": 5
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/q8_max/mcuconf.h b/keyboards/keychron/q8_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/q8_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/q8_max/q8_max.c b/keyboards/keychron/q8_max/q8_max.c
new file mode 100644
index 0000000000..486dd77a1b
--- /dev/null
+++ b/keyboards/keychron/q8_max/q8_max.c
@@ -0,0 +1,61 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 1 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/q8_max/readme.md b/keyboards/keychron/q8_max/readme.md
new file mode 100644
index 0000000000..f7f5cd844f
--- /dev/null
+++ b/keyboards/keychron/q8_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron Q8 Max
+
+
+
+A customizable 65% ergonomic keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron Q8 Max
+* Hardware Availability: [Keychron Q8 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-q8-max-alice-layout-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/q8_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/q8_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/q8_max/rules.mk b/keyboards/keychron/q8_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/q8_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/q8_max/via_json/q8_max_ansi_encoder.json b/keyboards/keychron/q8_max/via_json/q8_max_ansi_encoder.json
new file mode 100644
index 0000000000..8809dba483
--- /dev/null
+++ b/keyboards/keychron/q8_max/via_json/q8_max_ansi_encoder.json
@@ -0,0 +1,351 @@
+{
+ "name": "Keychron Q8 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0880",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols": 15},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "x": 2.75
+ },
+ "0,2",
+ {
+ "x": 8.85
+ },
+ "0,11",
+ {
+ "x": 3.5,
+ "c": "#aaaaaa"
+ },
+ "0,14\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 0.75,
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "c": "#cccccc"
+ },
+ "0,1"
+ ],
+ [
+ {
+ "y": -0.85,
+ "x": 13.6
+ },
+ "0,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "0,13"
+ ],
+ [
+ {
+ "x": 0.5,
+ "w": 1.5
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ {
+ "x": 10.3
+ },
+ "1,11",
+ "1,12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1,13"
+ ],
+ [
+ {
+ "y": -0.9,
+ "x": 17.3
+ },
+ "1,14"
+ ],
+ [
+ {
+ "y": -0.1,
+ "x": 0.25,
+ "w": 1.75
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ {
+ "x": 9.75
+ },
+ "2,11",
+ "2,12",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "2,13"
+ ],
+ [
+ {
+ "y": -0.9,
+ "x": 17.5,
+ "c": "#aaaaaa"
+ },
+ "2,14"
+ ],
+ [
+ {
+ "y": -0.1,
+ "w": 2.25
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,2",
+ {
+ "x": 10.15
+ },
+ "3,12",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "3,13"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.4,
+ "c": "#777777"
+ },
+ "3,14"
+ ],
+ [
+ {
+ "y": -0.25,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "w": 1.25
+ },
+ "4,1"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 15.4,
+ "c": "#777777"
+ },
+ "4,12",
+ "4,13",
+ "4,14"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -5.7,
+ "x": 3.85,
+ "c": "#cccccc"
+ },
+ "0,3",
+ "0,4",
+ "0,5",
+ "0,6"
+ ],
+ [
+ {
+ "x": 3.35
+ },
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5"
+ ],
+ [
+ {
+ "x": 3.55
+ },
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5"
+ ],
+ [
+ {
+ "x": 3.9
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6"
+ ],
+ [
+ {
+ "x": 4,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,2",
+ {
+ "w": 2.25
+ },
+ "4,3",
+ {
+ "c": "#aaaaaa"
+ },
+ "4,6"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -3.2,
+ "x": 8.35,
+ "c": "#cccccc"
+ },
+ "0,7",
+ "0,8",
+ {
+ "c": "#cccccc"
+ },
+ "0,9",
+ "0,10"
+ ],
+ [
+ {
+ "x": 7.9
+ },
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10"
+ ],
+ [
+ {
+ "x": 8.25
+ },
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10"
+ ],
+ [
+ {
+ "x": 7.8
+ },
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 7.8,
+ "c": "#aaaaaa"
+ },
+ "4,7",
+ {
+ "w": 2.75
+ },
+ "4,8",
+ {
+ "c": "#aaaaaa"
+ },
+ "4,9"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/v10_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/v10_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..8d67b7b0f5
--- /dev/null
+++ b/keyboards/keychron/v10_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,155 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA8, CB6_CA8, CB5_CA8},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { __, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, __, 14 },
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, __, 30 },
+ { 31, 32, 33, 34, 35, 36, 37, __, 38, 39, 40, 41, 42, 43, 44, 45, __, 46 },
+ { 47, 48, 49, 50, 51, 52, 53, __, 54, 55, 56, 57, 58, 59, 60, __, __, 61 },
+ { 62, 63, __, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, __, 76, __ },
+ { 77, 78, 79, __, 80, __, 81, 82, __, 83, __, 84, __, __, __, 85, 86, 87 },
+ },
+ {
+ // LED Index to Physical Position
+ {19, 0}, {34, 0}, {46, 0}, {59, 1}, {71, 3}, {86, 6}, {98, 8}, {121, 8}, {133, 6}, {147, 3}, {159, 1}, {173, 0}, {185, 0}, {201, 1}, {219, 1},
+ {5,14}, {24,14}, {36,14}, {48,13}, {61,15}, {73,17}, {85,20}, {97,22}, {116,22}, {128,20}, {140,17}, {152,15}, {165,13}, {177,14}, {195,14}, {220,14},
+ {4,24}, {24,24}, {40,24}, {53,24}, {65,27}, {77,29}, {89,31}, {113,33}, {125,31}, {137,29}, {149,26}, {161,24}, {174,24}, {186,24}, {201,24}, {222,24},
+ {2,34}, {23,34}, {40,34}, {53,35}, {65,37}, {77,39}, {89,42}, {118,42}, {130,40}, {142,38}, {154,36}, {167,34}, {179,34}, {199,34}, {224,35},
+ {0,45}, {24,45}, {44,45}, {57,46}, {69,48}, {81,51}, {93,53}, {112,54}, {124,52}, {136,50}, {148,48}, {160,46}, {173,45}, {190,45}, {210,47},
+ {0,55}, {18,55}, {33,55}, {56,57}, {77,61}, {96,64}, {125,63}, {147,58}, {198,58}, {210,58}, {222,58}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/v10_max/ansi_encoder/config.h b/keyboards/keychron/v10_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..41006ba091
--- /dev/null
+++ b/keyboards/keychron/v10_max/ansi_encoder/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 88
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20, 0x20 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 48
+# define LOW_BAT_IND_INDEX \
+ { 81, 83 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v10_max/ansi_encoder/keyboard.json b/keyboards/keychron/v10_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..598c55d5b7
--- /dev/null
+++ b/keyboards/keychron/v10_max/ansi_encoder/keyboard.json
@@ -0,0 +1,106 @@
+{
+ "usb": {
+ "pid": "0x09A0",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_89": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.5, "y": 0},
+ {"matrix": [0, 2], "x": 2.75, "y": 0},
+ {"matrix": [0, 3], "x": 3.75, "y": 0},
+ {"matrix": [0, 4], "x": 4.75, "y": 0},
+ {"matrix": [0, 5], "x": 5.75, "y": 0.25},
+ {"matrix": [0, 6], "x": 7, "y": 0.5},
+ {"matrix": [0, 7], "x": 8, "y": 0.75},
+ {"matrix": [0, 8], "x": 9.75, "y": 0.75},
+ {"matrix": [0, 9], "x": 10.75, "y": 0.5},
+ {"matrix": [0, 10], "x": 12, "y": 0.25},
+ {"matrix": [0, 11], "x": 13, "y": 0},
+ {"matrix": [0, 12], "x": 14, "y": 0},
+ {"matrix": [0, 13], "x": 15, "y": 0},
+ {"matrix": [0, 14], "x": 16.5, "y": 0},
+ {"matrix": [0, 17], "x": 17.75, "y": 0},
+
+ {"matrix": [1, 0], "x": 0.5, "y": 1.25},
+ {"matrix": [1, 1], "x": 2, "y": 1.25},
+ {"matrix": [1, 2], "x": 3, "y": 1.25},
+ {"matrix": [1, 3], "x": 4, "y": 1.25},
+ {"matrix": [1, 4], "x": 5, "y": 1.5},
+ {"matrix": [1, 5], "x": 6, "y": 1.75},
+ {"matrix": [1, 6], "x": 7, "y": 2},
+ {"matrix": [1, 7], "x": 8, "y": 2},
+ {"matrix": [1, 8], "x": 9.5, "y": 2},
+ {"matrix": [1, 9], "x": 10.5, "y": 2},
+ {"matrix": [1, 10], "x": 11.5, "y": 1.75},
+ {"matrix": [1, 11], "x": 12.5, "y": 1.5},
+ {"matrix": [1, 12], "x": 13.5, "y": 1.25},
+ {"matrix": [1, 13], "x": 14.5, "y": 1.25},
+ {"matrix": [1, 14], "x": 15.5, "y": 1.25, "w": 2},
+ {"matrix": [1, 17], "x": 18, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0.25, "y": 2.25},
+ {"matrix": [2, 1], "x": 1.75, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 2], "x": 3.25, "y": 2.25},
+ {"matrix": [2, 3], "x": 4.25, "y": 2.25},
+ {"matrix": [2, 4], "x": 5.25, "y": 2.5},
+ {"matrix": [2, 5], "x": 6.25, "y": 2.75},
+ {"matrix": [2, 6], "x": 7.25, "y": 3},
+ {"matrix": [2, 8], "x": 9.25, "y": 3.25},
+ {"matrix": [2, 9], "x": 10.25, "y": 3},
+ {"matrix": [2, 10], "x": 11.25, "y": 2.75},
+ {"matrix": [2, 11], "x": 12.25, "y": 2.5},
+ {"matrix": [2, 12], "x": 13, "y": 2.25},
+ {"matrix": [2, 13], "x": 14.25, "y": 2.25},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 16.25, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 17], "x": 18, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0.25, "y": 3.25},
+ {"matrix": [3, 1], "x": 1.5, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 2], "x": 3.25, "y": 3.25},
+ {"matrix": [3, 3], "x": 4.25, "y": 3.5},
+ {"matrix": [3, 4], "x": 5.25, "y": 3.5},
+ {"matrix": [3, 5], "x": 6.25, "y": 3.75},
+ {"matrix": [3, 6], "x": 7.25, "y": 4},
+ {"matrix": [3, 8], "x": 9.75, "y": 4},
+ {"matrix": [3, 9], "x": 10.5, "y": 4},
+ {"matrix": [3, 10], "x": 11.5, "y": 3.75},
+ {"matrix": [3, 11], "x": 12.5, "y": 3.5},
+ {"matrix": [3, 12], "x": 13.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 14.75, "y": 3.25},
+ {"matrix": [3, 14], "x": 15.75, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 17], "x": 18.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 3], "x": 3.5, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.75, "y": 4.5},
+ {"matrix": [4, 5], "x": 5.5, "y": 4.75},
+ {"matrix": [4, 6], "x": 6.5, "y": 4.75},
+ {"matrix": [4, 7], "x": 7.5, "y": 5},
+ {"matrix": [4, 8], "x": 9, "y": 5.25},
+ {"matrix": [4, 9], "x": 10, "y": 5},
+ {"matrix": [4, 10], "x": 11, "y": 4.75},
+ {"matrix": [4, 11], "x": 12, "y": 4.5},
+ {"matrix": [4, 12], "x": 13, "y": 4.5},
+ {"matrix": [4, 13], "x": 14, "y": 4.25},
+ {"matrix": [4, 14], "x": 15, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 16], "x": 17.25, "y": 4.5},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 4], "x": 4.5, "y": 5.5, "w": 1.25},
+ {"matrix": [5, 6], "x": 5.75, "y": 5.75, "w": 2.25},
+ {"matrix": [5, 7], "x": 7.75, "y": 6.25},
+ {"matrix": [5, 9], "x": 8.75, "y": 6, "w": 3.75},
+ {"matrix": [5, 11], "x": 9, "y": 5.75, "w": 7.25},
+ {"matrix": [5, 15], "x": 16.25, "y": 5.5},
+ {"matrix": [5, 16], "x": 17.25, "y": 5.5},
+ {"matrix": [5, 17], "x": 18.25, "y": 5.5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v10_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/v10_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..276e51caa8
--- /dev/null
+++ b/keyboards/keychron/v10_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,76 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_89(
+ KC_MUTE, KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN), KC_SPC, KC_RCMMD, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_89(
+ RGB_TOG, _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_89(
+ KC_MUTE, 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_INS, KC_DEL,
+ MC_1, 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_PGUP,
+ MC_2, 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_PGDN,
+ MC_3, 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_HOME,
+ MC_4, KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ MC_5, KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN), KC_SPC, KC_RALT, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_89(
+ RGB_TOG, _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______,
+ _______, _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)}
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v10_max/ansi_encoder/rules.mk b/keyboards/keychron/v10_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v10_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v10_max/board.h b/keyboards/keychron/v10_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/v10_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/v10_max/config.h b/keyboards/keychron/v10_max/config.h
new file mode 100644
index 0000000000..f1c1b3be85
--- /dev/null
+++ b/keyboards/keychron/v10_max/config.h
@@ -0,0 +1,82 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN C14
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+#define FN_BL_TRIG_KEY KC_END
+
+#define P2P4G_CELAR_MASK 0
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/v10_max/halconf.h b/keyboards/keychron/v10_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/v10_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/v10_max/info.json b/keyboards/keychron/v10_max/info.json
new file mode 100644
index 0000000000..bd8a1a60e4
--- /dev/null
+++ b/keyboards/keychron/v10_max/info.json
@@ -0,0 +1,80 @@
+{
+ "keyboard_name": "Keychron V10 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "nkro" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch" :{
+ "pins": ["A8"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20,
+ "bootmagic": {
+ "matrix": [0,1]
+ }
+}
diff --git a/keyboards/keychron/v10_max/mcuconf.h b/keyboards/keychron/v10_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/v10_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/v10_max/readme.md b/keyboards/keychron/v10_max/readme.md
new file mode 100644
index 0000000000..3e3d1fbd02
--- /dev/null
+++ b/keyboards/keychron/v10_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron V10 Max
+
+
+
+A customizable 75% ergonomic wireless keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron V10 Max
+* Hardware Availability: [Keychron V10 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-v10-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/v10_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/v10_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/v10_max/rules.mk b/keyboards/keychron/v10_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/v10_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/v10_max/v10_max.c b/keyboards/keychron/v10_max/v10_max.c
new file mode 100644
index 0000000000..d32c5be2e8
--- /dev/null
+++ b/keyboards/keychron/v10_max/v10_max.c
@@ -0,0 +1,84 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 2));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ } else {
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/v10_max/via_json/v10_max_ansi_encoder.json b/keyboards/keychron/v10_max/via_json/v10_max_ansi_encoder.json
new file mode 100644
index 0000000000..0256eb20e9
--- /dev/null
+++ b/keyboards/keychron/v10_max/via_json/v10_max_ansi_encoder.json
@@ -0,0 +1,400 @@
+{
+ "name": "Keychron V10 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x09A0",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols": 18},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0,0\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.5,
+ "c": "#777777"
+ },
+ "0,1\nESC",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,2",
+ "0,3",
+ {
+ "x": 9.35
+ },
+ "0,12",
+ "0,13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,14",
+ {
+ "x": 0.25
+ },
+ "0,17"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 0.75,
+ "c": "#aaaaaa"
+ },
+ "1,0",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ {
+ "x": 8.65
+ },
+ "1,12",
+ "1,13",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "1,14",
+ {
+ "x": 0.6
+ },
+ "1,17"
+ ],
+ [
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "2,0",
+ {
+ "x": 0.5,
+ "w": 1.5
+ },
+ "2,1",
+ {
+ "c": "#cccccc"
+ },
+ "2,2",
+ {
+ "x": 9.9
+ },
+ "2,13",
+ "2,14",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "2,15",
+ {
+ "x": 0.5
+ },
+ "2,17"
+ ],
+ [
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "3,0",
+ {
+ "x": 0.5,
+ "w": 1.75
+ },
+ "3,1",
+ {
+ "c": "#cccccc"
+ },
+ "3,2",
+ {
+ "x": 9.6
+ },
+ "3,12",
+ "3,13",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "3,14",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "3,17"
+ ],
+ [
+ {
+ "c": "#aaaaaa"
+ },
+ "4,0",
+ {
+ "x": 0.5,
+ "w": 2.25
+ },
+ "4,1",
+ {
+ "c": "#cccccc"
+ },
+ "4,3",
+ {
+ "x": 9.95
+ },
+ "4,13",
+ {
+ "c": "#aaaaaa",
+ "w": 1.75
+ },
+ "4,14"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 17.7,
+ "c": "#aaaaaa"
+ },
+ "4,16"
+ ],
+ [
+ {
+ "y": -0.25,
+ "c": "#aaaaaa"
+ },
+ "5,0",
+ {
+ "x": 0.5,
+ "w": 1.25
+ },
+ "5,1",
+ {
+ "w": 1.25
+ },
+ "5,2"
+ ],
+ [
+ {
+ "y": -0.75,
+ "x": 16.7,
+ "c": "#aaaaaa"
+ },
+ "5,15",
+ "5,16",
+ "5,17"
+ ],
+ [
+ {
+ "r": 6,
+ "y": -7.05,
+ "x": 5.4,
+ "c": "#cccccc"
+ },
+ "0,4",
+ "0,5",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0,6",
+ "0,7"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 5.55,
+ "c": "#cccccc"
+ },
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7"
+ ],
+ [
+ {
+ "x": 4.9
+ },
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6"
+ ],
+ [
+ {
+ "x": 5
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6"
+ ],
+ [
+ {
+ "x": 5.35
+ },
+ "4,4",
+ "4,5",
+ "4,6",
+ "4,7"
+ ],
+ [
+ {
+ "x": 5.35,
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "5,4",
+ {
+ "w": 2.25
+ },
+ "5,6",
+ "5,7"
+ ],
+ [
+ {
+ "r": -6,
+ "y": -4.25,
+ "x": 10.05
+ },
+ "0,8",
+ "0,9",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0,10",
+ "0,11"
+ ],
+ [
+ {
+ "y": 0.25,
+ "x": 9.4
+ },
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11"
+ ],
+ [
+ {
+ "x": 8.9
+ },
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ "2,12"
+ ],
+ [
+ {
+ "x": 9.4
+ },
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x": 8.85
+ },
+ "4,8",
+ "4,9",
+ "4,10",
+ "4,11",
+ "4,12"
+ ],
+ [
+ {
+ "x": 8.85,
+ "w": 2.55,
+ "c": "#aaaaaa"
+ },
+ "5,9",
+ "5,11"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/v1_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/v1_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..5522876685
--- /dev/null
+++ b/keyboards/keychron/v1_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,149 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, __, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, __, 43 },
+ { 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, __, 56, __, 57 },
+ { 58, __, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, __, 70, __ },
+ { 71, 72, 73, __, __, __, 74, __, __, __, 75, 76, 77, 78, 79, 80 }
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {18, 0}, {32, 0}, {47, 0}, {62, 0}, {80, 0}, {95, 0}, {109, 0}, {124, 0}, {142, 0}, {157, 0}, {172, 0}, {186, 0}, {205, 0},
+ {0,14}, {14,14}, {29,14}, {43,14}, {58,14}, {73,14}, {87,14}, {102, 14}, {117, 14}, {131, 14}, {146, 14}, {161, 14}, {175, 14}, {197, 14}, {224, 14},
+ {3,26}, {21,26}, {36,26}, {51,26}, {65,26}, {80,26}, {95,26}, {109, 26}, {124, 26}, {139, 26}, {153, 26}, {168, 26}, {183, 26}, {201, 26}, {224, 26},
+ {5,37}, {25,37}, {40,37}, {54,37}, {69,37}, {84,37}, {98,37}, {113, 37}, {128, 37}, {142, 37}, {157, 37}, {172, 37}, {195, 37}, {224, 37},
+ {9,50}, {32,50}, {47,50}, {62,50}, {76,50}, {91,50}, {106, 50}, {120, 50}, {135, 50}, {150, 50}, {164, 50}, {185, 50}, {209, 50},
+ {1,62}, {20,62}, {38,62}, {93,62}, {146, 62}, {161, 62}, {176, 62}, {194, 62}, {209, 62}, {224, 62}
+
+ },
+ {
+ // RGB LED Index to Flag
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4
+ },
+};
+#endif
diff --git a/keyboards/keychron/v1_max/ansi_encoder/config.h b/keyboards/keychron/v1_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..801271a5d0
--- /dev/null
+++ b/keyboards/keychron/v1_max/ansi_encoder/config.h
@@ -0,0 +1,52 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 81
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 44
+# define P24G_INDICATION_LED_MATRIX_INDEX 18
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 15, 16, 17 }
+# define BAT_LEVEL_LED_LIST \
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24 }
+# define LOW_BAT_IND_INDEX \
+ { 74 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v1_max/ansi_encoder/keyboard.json b/keyboards/keychron/v1_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..49d521e2a6
--- /dev/null
+++ b/keyboards/keychron/v1_max/ansi_encoder/keyboard.json
@@ -0,0 +1,111 @@
+{
+ "usb": {
+ "pid": "0x0913",
+ "device_version": "1.0.1"
+ },
+ "features": {
+ "encoder": true,
+ "encoder_map": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "layouts": {
+ "LAYOUT_ansi_82": {
+ "layout": [
+ {"matrix":[0,0], "x":0, "y":0},
+ {"matrix":[0,1], "x":1.25, "y":0},
+ {"matrix":[0,2], "x":2.25, "y":0},
+ {"matrix":[0,3], "x":3.25, "y":0},
+ {"matrix":[0,4], "x":4.25, "y":0},
+ {"matrix":[0,5], "x":5.5, "y":0},
+ {"matrix":[0,6], "x":6.5, "y":0},
+ {"matrix":[0,7], "x":7.5, "y":0},
+ {"matrix":[0,8], "x":8.5, "y":0},
+ {"matrix":[0,9], "x":9.75, "y":0},
+ {"matrix":[0,10], "x":10.75, "y":0},
+ {"matrix":[0,11], "x":11.75, "y":0},
+ {"matrix":[0,12], "x":12.75, "y":0},
+ {"matrix":[0,13], "x":14, "y":0},
+ {"matrix":[0,15], "x":15.25, "y":0},
+
+ {"matrix":[1,0], "x":0, "y":1.25},
+ {"matrix":[1,1], "x":1, "y":1.25},
+ {"matrix":[1,2], "x":2, "y":1.25},
+ {"matrix":[1,3], "x":3, "y":1.25},
+ {"matrix":[1,4], "x":4, "y":1.25},
+ {"matrix":[1,5], "x":5, "y":1.25},
+ {"matrix":[1,6], "x":6, "y":1.25},
+ {"matrix":[1,7], "x":7, "y":1.25},
+ {"matrix":[1,8], "x":8, "y":1.25},
+ {"matrix":[1,9], "x":9, "y":1.25},
+ {"matrix":[1,10], "x":10, "y":1.25},
+ {"matrix":[1,11], "x":11, "y":1.25},
+ {"matrix":[1,12], "x":12, "y":1.25},
+ {"matrix":[1,13], "x":13, "y":1.25, "w":2},
+ {"matrix":[1,15], "x":15.25, "y":1.25},
+
+ {"matrix":[2,0], "x":0, "y":2.25, "w":1.5},
+ {"matrix":[2,1], "x":1.5, "y":2.25},
+ {"matrix":[2,2], "x":2.5, "y":2.25},
+ {"matrix":[2,3], "x":3.5, "y":2.25},
+ {"matrix":[2,4], "x":4.5, "y":2.25},
+ {"matrix":[2,5], "x":5.5, "y":2.25},
+ {"matrix":[2,6], "x":6.5, "y":2.25},
+ {"matrix":[2,7], "x":7.5, "y":2.25},
+ {"matrix":[2,8], "x":8.5, "y":2.25},
+ {"matrix":[2,9], "x":9.5, "y":2.25},
+ {"matrix":[2,10], "x":10.5, "y":2.25},
+ {"matrix":[2,11], "x":11.5, "y":2.25},
+ {"matrix":[2,12], "x":12.5, "y":2.25},
+ {"matrix":[2,13], "x":13.5, "y":2.25, "w":1.5},
+ {"matrix":[2,15], "x":15.25, "y":2.25},
+
+ {"matrix":[3,0], "x":0, "y":3.25, "w":1.75},
+ {"matrix":[3,1], "x":1.75, "y":3.25},
+ {"matrix":[3,2], "x":2.75, "y":3.25},
+ {"matrix":[3,3], "x":3.75, "y":3.25},
+ {"matrix":[3,4], "x":4.75, "y":3.25},
+ {"matrix":[3,5], "x":5.75, "y":3.25},
+ {"matrix":[3,6], "x":6.75, "y":3.25},
+ {"matrix":[3,7], "x":7.75, "y":3.25},
+ {"matrix":[3,8], "x":8.75, "y":3.25},
+ {"matrix":[3,9], "x":9.75, "y":3.25},
+ {"matrix":[3,10], "x":10.75, "y":3.25},
+ {"matrix":[3,11], "x":11.75, "y":3.25},
+ {"matrix":[3,13], "x":12.75, "y":3.25, "w":2.25},
+ {"matrix":[3,15], "x":15.25, "y":3.25},
+
+ {"matrix":[4,0], "x":0, "y":4.25, "w":2.25},
+ {"matrix":[4,2], "x":2.25, "y":4.25},
+ {"matrix":[4,3], "x":3.25, "y":4.25},
+ {"matrix":[4,4], "x":4.25, "y":4.25},
+ {"matrix":[4,5], "x":5.25, "y":4.25},
+ {"matrix":[4,6], "x":6.25, "y":4.25},
+ {"matrix":[4,7], "x":7.25, "y":4.25},
+ {"matrix":[4,8], "x":8.25, "y":4.25},
+ {"matrix":[4,9], "x":9.25, "y":4.25},
+ {"matrix":[4,10], "x":10.25, "y":4.25},
+ {"matrix":[4,11], "x":11.25, "y":4.25},
+ {"matrix":[4,12], "x":12.25, "y":4.25, "w":1.75},
+ {"matrix":[4,14], "x":14.25, "y":4.5},
+
+ {"matrix":[5,0], "x":0, "y":5.25, "w":1.25},
+ {"matrix":[5,1], "x":1.25, "y":5.25, "w":1.25},
+ {"matrix":[5,2], "x":2.5, "y":5.25, "w":1.25},
+ {"matrix":[5,6], "x":3.75, "y":5.25, "w":6.25},
+ {"matrix":[5,10], "x":10, "y":5.25},
+ {"matrix":[5,11], "x":11, "y":5.25},
+ {"matrix":[5,12], "x":12, "y":5.25},
+ {"matrix":[5,13], "x":13.25, "y":5.5},
+ {"matrix":[5,14], "x":14.25, "y":5.5},
+ {"matrix":[5,15], "x":15.25, "y":5.5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v1_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/v1_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..b5011998c9
--- /dev/null
+++ b/keyboards/keychron/v1_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,76 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_82(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, KC_MUTE,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_ansi_82(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_ansi_82(
+ 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_DEL, KC_MUTE,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_ansi_82(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v1_max/ansi_encoder/rules.mk b/keyboards/keychron/v1_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v1_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v1_max/board.h b/keyboards/keychron/v1_max/board.h
new file mode 100644
index 0000000000..b5bf023d24
--- /dev/null
+++ b/keyboards/keychron/v1_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/v1_max/config.h b/keyboards/keychron/v1_max/config.h
new file mode 100644
index 0000000000..1d3d093081
--- /dev/null
+++ b/keyboards/keychron/v1_max/config.h
@@ -0,0 +1,77 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+#define FN_BL_TRIG_KEY KC_END
+
+#define P2P4G_CELAR_MASK 0
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/v1_max/halconf.h b/keyboards/keychron/v1_max/halconf.h
new file mode 100644
index 0000000000..8c0d5caeb4
--- /dev/null
+++ b/keyboards/keychron/v1_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/v1_max/info.json b/keyboards/keychron/v1_max/info.json
new file mode 100644
index 0000000000..a013c45e1a
--- /dev/null
+++ b/keyboards/keychron/v1_max/info.json
@@ -0,0 +1,67 @@
+{
+ "keyboard_name": "Keychron V1 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string" : true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch" :{
+ "pins": ["A3"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/v1_max/iso_encoder/config.h b/keyboards/keychron/v1_max/iso_encoder/config.h
new file mode 100644
index 0000000000..d9ff3bff74
--- /dev/null
+++ b/keyboards/keychron/v1_max/iso_encoder/config.h
@@ -0,0 +1,52 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 82
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indicator */
+# define CAPS_LOCK_INDEX 43
+# define P24G_INDICATION_LED_MATRIX_INDEX 18
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 15, 16, 17 }
+# define BAT_LEVEL_LED_LIST \
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24 }
+# define LOW_BAT_IND_INDEX \
+ { 75 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v1_max/iso_encoder/iso_encoder.c b/keyboards/keychron/v1_max/iso_encoder/iso_encoder.c
new file mode 100644
index 0000000000..dc8fcf03b0
--- /dev/null
+++ b/keyboards/keychron/v1_max/iso_encoder/iso_encoder.c
@@ -0,0 +1,149 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, __, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, __, __, 42 },
+ { 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, __, 57 },
+ { 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, __, 71, __ },
+ { 72, 73, 74, __, __, __, 75, __, __, __, 76, 77, 78, 79, 80, 81 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {18, 0}, {33, 0}, {48, 0}, {62, 0}, {81, 0}, {95, 0}, {110, 0}, {125, 0}, {143, 0}, {157, 0}, {172, 0}, {187, 0}, {205, 0},
+ {0,15}, {15,15}, {29,15}, {44,15}, {59,15}, {73,15}, {88,15}, {103,15}, {117,15}, {132,15}, {146,15}, {161,15}, {176,15}, {203,15}, {224,15},
+ {4,26}, {22,26}, {37,26}, {51,26}, {66,26}, {81,26}, {95,26}, {110,26}, {125,26}, {139,26}, {154,26}, {168,26}, {183,26}, {224,26},
+ {6,38}, {26,38}, {40,38}, {55,38}, {70,38}, {84,38}, {99,38}, {114,38}, {128,38}, {143,38}, {158,38}, {172,38}, {187,38}, {203,32}, {224,38},
+ {2,49}, {18,49}, {33,49}, {48,49}, {62,49}, {77,49}, {92,49}, {106,49}, {121,49}, {136,49}, {150,49}, {165,49}, {185,49}, {209,52},
+ {2,61}, {20,61}, {38,61}, {94,61}, {147,61}, {161,61}, {176,61}, {195,64}, {209,64}, {224,64},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/v1_max/iso_encoder/keyboard.json b/keyboards/keychron/v1_max/iso_encoder/keyboard.json
new file mode 100644
index 0000000000..575c491bd2
--- /dev/null
+++ b/keyboards/keychron/v1_max/iso_encoder/keyboard.json
@@ -0,0 +1,112 @@
+{
+ "usb": {
+ "pid": "0x0914",
+ "device_version": "1.0.2"
+ },
+ "features": {
+ "encoder": true,
+ "encoder_map": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "layouts": {
+ "LAYOUT_iso_83": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0,15], "x":15.25, "y":0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 15], "x": 15.25, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 15], "x": 15.25, "y":2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 13.25, "y": 3.25},
+ {"matrix": [3, 15], "x": 15.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 14], "x": 14.25, "y": 4.5},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25},
+ {"matrix": [5, 11], "x": 11, "y": 5.25},
+ {"matrix": [5, 12], "x": 12, "y": 5.25},
+ {"matrix": [5, 13], "x": 13.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 14.25, "y": 5.5},
+ {"matrix": [5, 15], "x": 15.25, "y": 5.5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v1_max/iso_encoder/keymaps/default/keymap.c b/keyboards/keychron/v1_max/iso_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..9a7da5704d
--- /dev/null
+++ b/keyboards/keychron/v1_max/iso_encoder/keymaps/default/keymap.c
@@ -0,0 +1,76 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_83(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, KC_MUTE,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_iso_83(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_iso_83(
+ 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_DEL, KC_MUTE,
+ 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_PGUP,
+ 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_PGDN,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_iso_83(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v1_max/iso_encoder/rules.mk b/keyboards/keychron/v1_max/iso_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v1_max/iso_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v1_max/jis_encoder/config.h b/keyboards/keychron/v1_max/jis_encoder/config.h
new file mode 100644
index 0000000000..347a61b7f9
--- /dev/null
+++ b/keyboards/keychron/v1_max/jis_encoder/config.h
@@ -0,0 +1,52 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 85
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indicator */
+# define CAPS_LOCK_INDEX 44
+# define P24G_INDICATION_LED_MATRIX_INDEX 18
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 15, 16, 17 }
+# define BAT_LEVEL_LED_LIST \
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24 }
+# define LOW_BAT_IND_INDEX \
+ { 77 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v1_max/jis_encoder/jis_encoder.c b/keyboards/keychron/v1_max/jis_encoder/jis_encoder.c
new file mode 100644
index 0000000000..9ae49602e7
--- /dev/null
+++ b/keyboards/keychron/v1_max/jis_encoder/jis_encoder.c
@@ -0,0 +1,152 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA3, CB9_CA3, CB8_CA3},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29 },
+ { 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, __, __, 43 },
+ { 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, __, 58 },
+ { 59, __, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, __ },
+ { 73, 74, 75, 76, __, __, 77, __, __, 78, 79, 80, 81, 82, 83, 84 }
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {27, 0}, {41, 0}, {55, 0}, {75, 0}, {89, 0}, {103, 0}, {117, 0}, {131, 0}, {145, 0}, {159, 0}, {173, 0}, {188, 0},
+ {0,14}, {14,14}, {26,14}, {40,14}, {54,14}, {68,14}, {82,14}, {96, 14}, {110, 14}, {124, 14}, {138, 14}, {152, 14}, {166, 14}, {180, 14}, {192,14}, {224, 14},
+ {7,26}, {18,26}, {33,26}, {47,26}, {61,26}, {75,26}, {89,26}, {103, 26}, {117, 26}, {131, 26}, {145, 26}, {159, 26}, {173, 26}, {224, 26},
+ {8,37}, {20,37}, {34,37}, {48,37}, {62,37}, {76,37}, {90,37}, {104, 37}, {118, 37}, {132, 37}, {146, 37}, {160, 37}, {174, 37}, {186, 32}, {224, 37},
+ {8,50}, {26,50}, {40,50}, {54,50}, {68,50}, {82,50}, {96, 50}, {110, 50}, {124, 50}, {138, 50}, {152, 50}, {166, 50}, {180, 50}, {188, 50},
+ {1,62}, {15,62}, {27,62}, {40,62}, {90,62}, {123, 62}, {137, 62}, {151, 62}, {165, 62}, {174, 62}, {188, 62}, {224, 62}
+ },
+ {
+ // RGB LED Index to Flag
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4
+ },
+};
+#endif
diff --git a/keyboards/keychron/v1_max/jis_encoder/keyboard.json b/keyboards/keychron/v1_max/jis_encoder/keyboard.json
new file mode 100644
index 0000000000..e6c29b2636
--- /dev/null
+++ b/keyboards/keychron/v1_max/jis_encoder/keyboard.json
@@ -0,0 +1,115 @@
+{
+ "usb": {
+ "pid": "0x0915",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "encoder": true,
+ "encoder_map": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "layouts": {
+ "LAYOUT_jis_86": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0,15], "x":15.25, "y":0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25},
+ {"matrix": [1, 14], "x": 14, "y": 1.25},
+ {"matrix": [1, 15], "x": 15.25, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 15], "x": 15.25, "y":2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25},
+ {"matrix": [3, 13], "x": 13.75, "y": 2.25, "w": 1.25, "h": 2},
+ {"matrix": [3, 15], "x": 15.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4.25},
+ {"matrix": [4, 13], "x": 13.25, "y": 4.25},
+ {"matrix": [4, 14], "x": 14.25, "y": 4.5},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25},
+ {"matrix": [5, 2], "x": 2.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 3], "x": 3.5, "y": 5.25},
+ {"matrix": [5, 6], "x": 4.5, "y": 5.25, "w": 4.5},
+ {"matrix": [5, 9], "x": 9, "y": 5.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25},
+ {"matrix": [5, 11], "x": 11, "y": 5.25},
+ {"matrix": [5, 12], "x": 12, "y": 5.25},
+ {"matrix": [5, 13], "x": 13.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 14.25, "y": 5.5},
+ {"matrix": [5, 15], "x": 15.25, "y": 5.5}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v1_max/jis_encoder/keymaps/default/keymap.c b/keyboards/keychron/v1_max/jis_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..730ea25c07
--- /dev/null
+++ b/keyboards/keychron/v1_max/jis_encoder/keymaps/default/keymap.c
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_jis_86(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, KC_MUTE,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_LNG2, KC_SPC, KC_LNG1, KC_RCMMD,MO(MAC_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_jis_86(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_jis_86(
+ 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_DEL, KC_MUTE,
+ 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_INT3, KC_BSPC, KC_PGUP,
+ 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_PGDN,
+ 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_BSLS, KC_ENT, KC_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_INT1, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_INT5, KC_SPC, KC_INT4, KC_RALT, MO(WIN_FN),KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_jis_86(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v1_max/jis_encoder/rules.mk b/keyboards/keychron/v1_max/jis_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v1_max/jis_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v1_max/mcuconf.h b/keyboards/keychron/v1_max/mcuconf.h
new file mode 100644
index 0000000000..681e8fd4cc
--- /dev/null
+++ b/keyboards/keychron/v1_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/v1_max/readme.md b/keyboards/keychron/v1_max/readme.md
new file mode 100644
index 0000000000..8fbc226b8c
--- /dev/null
+++ b/keyboards/keychron/v1_max/readme.md
@@ -0,0 +1,23 @@
+# Keychron V1 Max
+
+
+
+A customizable wireless 75% keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron V1 Max
+* Hardware Availability: [Keychron V1 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-v1-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/v1_max/ansi_encoder:default
+ make keychron/v1_max/iso_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/v1_max/ansi_encoder:default:flash
+ make keychron/v1_max/iso_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/v1_max/rules.mk b/keyboards/keychron/v1_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/v1_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/v1_max/v1_max.c b/keyboards/keychron/v1_max/v1_max.c
new file mode 100644
index 0000000000..951949847a
--- /dev/null
+++ b/keyboards/keychron/v1_max/v1_max.c
@@ -0,0 +1,85 @@
+/* Copyright 2023 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer_buffer;
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 2));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer_buffer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer_buffer) {
+ if (timer_elapsed32(power_on_indicator_timer_buffer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer_buffer = 0;
+
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+
+ } else {
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer_buffer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/v1_max/via_json/v1_max_ansi_encoder.json b/keyboards/keychron/v1_max/via_json/v1_max_ansi_encoder.json
new file mode 100644
index 0000000000..f5ed3a07e8
--- /dev/null
+++ b/keyboards/keychron/v1_max/via_json/v1_max_ansi_encoder.json
@@ -0,0 +1,286 @@
+{
+ "name": "Keychron V1 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0913",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ {
+ "x": 0.25
+ },
+ "0, 15\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 12",
+ {
+ "x": 0.25,
+ "y": 0.25
+ },
+ "4, 14"
+ ],
+ [
+ {
+ "y": -0.25,
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "x": 0.25,
+ "y": 0.25
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/v1_max/via_json/v1_max_iso_encoder.json b/keyboards/keychron/v1_max/via_json/v1_max_iso_encoder.json
new file mode 100644
index 0000000000..4e24fc7d8c
--- /dev/null
+++ b/keyboards/keychron/v1_max/via_json/v1_max_iso_encoder.json
@@ -0,0 +1,291 @@
+{
+ "name": "Keychron V1 Max ISO Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0914",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.25
+ },
+ "0, 9",
+ {
+ "c": "#cccccc"
+ },
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ {
+ "x": 0.25
+ },
+ "0, 0\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "3, 13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 12",
+ {
+ "x": 1.5,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 1",
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 12",
+ {
+ "x": 0.25,
+ "y": 0.25
+ },
+ "4, 14"
+ ],
+ [
+ {
+ "y": -0.25,
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "x": 0.25,
+ "y": 0.25
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/v1_max/via_json/v1_max_jis_encoder.json b/keyboards/keychron/v1_max/via_json/v1_max_jis_encoder.json
new file mode 100644
index 0000000000..bb27ab9fe4
--- /dev/null
+++ b/keyboards/keychron/v1_max/via_json/v1_max_jis_encoder.json
@@ -0,0 +1,281 @@
+{
+ "name": "Keychron V1 Max JIS Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0915",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ {
+ "x": 0.25
+ },
+ "0, 15\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25
+ },
+ "1, 0",
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ "1, 13",
+ "1, 14",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "3, 13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 12",
+ {
+ "x": 1.5,
+ "c": "#aaaaaa"
+ },
+ "3, 15"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 13",
+ {
+ "c":"#cccccc"
+ },
+ "4, 14"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ "5, 3",
+ {
+ "w": 4.5,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 9",
+ "5, 10",
+ {
+ "w":1.25
+ },
+ "5, 11",
+ "5, 12",
+ {
+ "c":"#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/v2_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/v2_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..214cf9c071
--- /dev/null
+++ b/keyboards/keychron/v2_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,129 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, __, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, __, __, 42 },
+ { 43, __, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, __, 55, __ },
+ { 56, 57, 58, __, __, __, 59, __, __, __, 60, 61, 62, 63, 64, 65 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {29, 0}, {44, 0}, {59, 0}, {73, 0}, {88, 0}, {103, 0}, {117, 0}, {132, 0}, {147, 0}, {161, 0}, {176, 0}, {198, 0},
+ {4,15}, {22,15}, {37,15}, {51,15}, {66,15}, {81,15}, {95,15}, {110,15}, {125,15}, {139,15}, {154,15}, {169,15}, {183,15}, {201,15}, {224,15},
+ {6,30}, {26,30}, {40,30}, {55,30}, {70,30}, {84,30}, {99,30}, {114,30}, {128,30}, {143,30}, {158,30}, {172,30}, {196,30}, {224,30},
+ {9,45}, {33,45}, {48,45}, {62,45}, {77,45}, {92,45}, {106,45}, {121,45}, {136,45}, {150,45}, {165,45}, {185,45}, {209,49},
+ {2,60}, {20,60}, {38,60}, {94,60}, {147,60}, {161,60}, {176,60}, {195,64}, {209,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/v2_max/ansi_encoder/config.h b/keyboards/keychron/v2_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..3eb1558848
--- /dev/null
+++ b/keyboards/keychron/v2_max/ansi_encoder/config.h
@@ -0,0 +1,52 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 66
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 29
+# define P24G_INDICATION_LED_MATRIX_INDEX 18
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 15, 16, 17 }
+# define BAT_LEVEL_LED_LIST \
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24 }
+# define LOW_BAT_IND_INDEX \
+ { 59 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v2_max/ansi_encoder/keyboard.json b/keyboards/keychron/v2_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..5e6827c6b1
--- /dev/null
+++ b/keyboards/keychron/v2_max/ansi_encoder/keyboard.json
@@ -0,0 +1,83 @@
+{
+ "usb": {
+ "pid": "0x0920",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_67": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6, "y": 0},
+ {"matrix": [0, 7], "x": 7, "y": 0},
+ {"matrix": [0, 8], "x": 8, "y": 0},
+ {"matrix": [0, 9], "x": 9, "y": 0},
+ {"matrix": [0, 10], "x": 10, "y": 0},
+ {"matrix": [0, 11], "x": 11, "y": 0},
+ {"matrix": [0, 12], "x": 12, "y": 0},
+ {"matrix": [0, 13], "x": 13, "y": 0, "w": 2},
+ {"matrix": [0, 15], "x": 15.25, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
+ {"matrix": [1, 1], "x": 1.5, "y": 1},
+ {"matrix": [1, 2], "x": 2.5, "y": 1},
+ {"matrix": [1, 3], "x": 3.5, "y": 1},
+ {"matrix": [1, 4], "x": 4.5, "y": 1},
+ {"matrix": [1, 5], "x": 5.5, "y": 1},
+ {"matrix": [1, 6], "x": 6.5, "y": 1},
+ {"matrix": [1, 7], "x": 7.5, "y": 1},
+ {"matrix": [1, 8], "x": 8.5, "y": 1},
+ {"matrix": [1, 9], "x": 9.5, "y": 1},
+ {"matrix": [1, 10], "x": 10.5, "y": 1},
+ {"matrix": [1, 11], "x": 11.5, "y": 1},
+ {"matrix": [1, 12], "x": 12.5, "y": 1},
+ {"matrix": [1, 13], "x": 13.5, "y": 1, "w": 1.5},
+ {"matrix": [1, 15], "x": 15.25, "y": 1},
+
+ {"matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
+ {"matrix": [2, 1], "x": 1.75, "y": 2},
+ {"matrix": [2, 2], "x": 2.75, "y": 2},
+ {"matrix": [2, 3], "x": 3.75, "y": 2},
+ {"matrix": [2, 4], "x": 4.75, "y": 2},
+ {"matrix": [2, 5], "x": 5.75, "y": 2},
+ {"matrix": [2, 6], "x": 6.75, "y": 2},
+ {"matrix": [2, 7], "x": 7.75, "y": 2},
+ {"matrix": [2, 8], "x": 8.75, "y": 2},
+ {"matrix": [2, 9], "x": 9.75, "y": 2},
+ {"matrix": [2, 10], "x": 10.75, "y": 2},
+ {"matrix": [2, 11], "x": 11.75, "y": 2},
+ {"matrix": [2, 12], "x": 12.75, "y": 2, "w": 2.25},
+ {"matrix": [2, 15], "x": 15.25, "y": 2},
+
+ {"matrix": [3, 0], "x": 0, "y": 3, "w": 2.25},
+ {"matrix": [3, 2], "x": 2.25, "y": 3},
+ {"matrix": [3, 3], "x": 3.25, "y": 3},
+ {"matrix": [3, 4], "x": 4.25, "y": 3},
+ {"matrix": [3, 5], "x": 5.25, "y": 3},
+ {"matrix": [3, 6], "x": 6.25, "y": 3},
+ {"matrix": [3, 7], "x": 7.25, "y": 3},
+ {"matrix": [3, 8], "x": 8.25, "y": 3},
+ {"matrix": [3, 9], "x": 9.25, "y": 3},
+ {"matrix": [3, 10], "x": 10.25, "y": 3},
+ {"matrix": [3, 11], "x": 11.25, "y": 3},
+ {"matrix": [3, 12], "x": 12.25, "y": 3, "w": 1.75},
+ {"matrix": [3, 14], "x": 14.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4, "w": 1.25},
+ {"matrix": [4, 2], "x": 2.5, "y": 4, "w": 1.25},
+ {"matrix": [4, 6], "x": 3.75, "y": 4, "w": 6.25},
+ {"matrix": [4, 10], "x": 10, "y": 4},
+ {"matrix": [4, 11], "x": 11, "y": 4},
+ {"matrix": [4, 12], "x": 12, "y": 4},
+ {"matrix": [4, 13], "x": 13.25, "y": 4.25},
+ {"matrix": [4, 14], "x": 14.25, "y": 4.25},
+ {"matrix": [4, 15], "x": 15.25, "y": 4.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v2_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/v2_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..eb014e44c8
--- /dev/null
+++ b/keyboards/keychron/v2_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,82 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_67(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN1),MO(FN2),KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_BASE] = LAYOUT_ansi_67(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ 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_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN1),MO(FN2),KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN1] = LAYOUT_ansi_67(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL,KC_LNPAD,RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_FN1] = LAYOUT_ansi_67(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [FN2] = LAYOUT_ansi_67(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN1] = { ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_FN1] = { ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [FN2] = { ENCODER_CCW_CW(_______, _______)}
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v2_max/ansi_encoder/rules.mk b/keyboards/keychron/v2_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v2_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v2_max/board.h b/keyboards/keychron/v2_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/v2_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/v2_max/config.h b/keyboards/keychron/v2_max/config.h
new file mode 100644
index 0000000000..85fffb8535
--- /dev/null
+++ b/keyboards/keychron/v2_max/config.h
@@ -0,0 +1,74 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in blueooth mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(4)
+#define P2P4G_CELAR_MASK 0
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/v2_max/halconf.h b/keyboards/keychron/v2_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/v2_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/v2_max/info.json b/keyboards/keychron/v2_max/info.json
new file mode 100644
index 0000000000..43873f5ccd
--- /dev/null
+++ b/keyboards/keychron/v2_max/info.json
@@ -0,0 +1,80 @@
+{
+ "keyboard_name": "Keychron V2 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string" : true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1"],
+ "rows": ["C12", "D2", "B3", "B4", "B5"]
+ },
+ "diode_direction": "ROW2COL",
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "dip_switch" :{
+ "pins": ["A8"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "dynamic_keymap": {
+ "layer_count": 5
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/v2_max/iso_encoder/config.h b/keyboards/keychron/v2_max/iso_encoder/config.h
new file mode 100644
index 0000000000..f5b4662db6
--- /dev/null
+++ b/keyboards/keychron/v2_max/iso_encoder/config.h
@@ -0,0 +1,52 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 67
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 29
+# define P24G_INDICATION_LED_MATRIX_INDEX 18
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 15, 16, 17 }
+# define BAT_LEVEL_LED_LIST \
+ { 15, 16, 17, 18, 19, 20, 21, 22, 23, 24 }
+# define LOW_BAT_IND_INDEX \
+ { 60 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v2_max/iso_encoder/iso_encoder.c b/keyboards/keychron/v2_max/iso_encoder/iso_encoder.c
new file mode 100644
index 0000000000..931667c833
--- /dev/null
+++ b/keyboards/keychron/v2_max/iso_encoder/iso_encoder.c
@@ -0,0 +1,126 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, __, __ },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, __, 28 },
+ { 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, __, __, 42 },
+ { 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, __, 56, __ },
+ { 57, 58, 59, __, __, __, 60, __, __, __, 61, 62, 63, 64, 65, 66 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {15, 0}, {29, 0}, {44, 0}, {59, 0}, {73, 0}, {88, 0}, {103, 0}, {117, 0}, {132, 0}, {147, 0}, {161, 0}, {176, 0}, {198, 0},
+ {4,15}, {22,15}, {37,15}, {51,15}, {66,15}, {81,15}, {95,15}, {110,15}, {125,15}, {139,15}, {154,15}, {169,15}, {183,15}, {203,22}, {224,15},
+ {6,30}, {26,30}, {40,30}, {55,30}, {70,30}, {84,30}, {99,30}, {114,30}, {128,30}, {143,30}, {158,30}, {172,30}, {187,30}, {224,30},
+ {2,45}, {18,45}, {33,45}, {48,45}, {62,45}, {77,45}, {92,45}, {106,45}, {121,45}, {136,45}, {150,45}, {165,45}, {185,45}, {209,49},
+ {2,60}, {20,60}, {38,60}, {94,60}, {147,60}, {161,60}, {176,60}, {195,64}, {209,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/v2_max/iso_encoder/keyboard.json b/keyboards/keychron/v2_max/iso_encoder/keyboard.json
new file mode 100644
index 0000000000..0c26d4a5bf
--- /dev/null
+++ b/keyboards/keychron/v2_max/iso_encoder/keyboard.json
@@ -0,0 +1,84 @@
+{
+ "usb": {
+ "pid": "0x0921",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_iso_68": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6, "y": 0},
+ {"matrix": [0, 7], "x": 7, "y": 0},
+ {"matrix": [0, 8], "x": 8, "y": 0},
+ {"matrix": [0, 9], "x": 9, "y": 0},
+ {"matrix": [0, 10], "x": 10, "y": 0},
+ {"matrix": [0, 11], "x": 11, "y": 0},
+ {"matrix": [0, 12], "x": 12, "y": 0},
+ {"matrix": [0, 13], "x": 13, "y": 0, "w": 2},
+ {"matrix": [0, 15], "x": 15.25, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
+ {"matrix": [1, 1], "x": 1.5, "y": 1},
+ {"matrix": [1, 2], "x": 2.5, "y": 1},
+ {"matrix": [1, 3], "x": 3.5, "y": 1},
+ {"matrix": [1, 4], "x": 4.5, "y": 1},
+ {"matrix": [1, 5], "x": 5.5, "y": 1},
+ {"matrix": [1, 6], "x": 6.5, "y": 1},
+ {"matrix": [1, 7], "x": 7.5, "y": 1},
+ {"matrix": [1, 8], "x": 8.5, "y": 1},
+ {"matrix": [1, 9], "x": 9.5, "y": 1},
+ {"matrix": [1, 10], "x": 10.5, "y": 1},
+ {"matrix": [1, 11], "x": 11.5, "y": 1},
+ {"matrix": [1, 12], "x": 12.5, "y": 1},
+ {"matrix": [1, 15], "x": 15.25, "y": 1},
+
+ {"matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
+ {"matrix": [2, 1], "x": 1.75, "y": 2},
+ {"matrix": [2, 2], "x": 2.75, "y": 2},
+ {"matrix": [2, 3], "x": 3.75, "y": 2},
+ {"matrix": [2, 4], "x": 4.75, "y": 2},
+ {"matrix": [2, 5], "x": 5.75, "y": 2},
+ {"matrix": [2, 6], "x": 6.75, "y": 2},
+ {"matrix": [2, 7], "x": 7.75, "y": 2},
+ {"matrix": [2, 8], "x": 8.75, "y": 2},
+ {"matrix": [2, 9], "x": 9.75, "y": 2},
+ {"matrix": [2, 10], "x": 10.75, "y": 2},
+ {"matrix": [2, 11], "x": 11.75, "y": 2},
+ {"matrix": [2, 12], "x": 12.75, "y": 2},
+ {"matrix": [1, 13], "x": 13.25, "y": 1.25, "w": 1.25, "h": 2},
+ {"matrix": [2, 15], "x": 15.25, "y": 2},
+
+ {"matrix": [3, 0], "x": 0, "y": 3, "w": 1.25},
+ {"matrix": [3, 1], "x": 1.25, "y": 3},
+ {"matrix": [3, 2], "x": 2.25, "y": 3},
+ {"matrix": [3, 3], "x": 3.25, "y": 3},
+ {"matrix": [3, 4], "x": 4.25, "y": 3},
+ {"matrix": [3, 5], "x": 5.25, "y": 3},
+ {"matrix": [3, 6], "x": 6.25, "y": 3},
+ {"matrix": [3, 7], "x": 7.25, "y": 3},
+ {"matrix": [3, 8], "x": 8.25, "y": 3},
+ {"matrix": [3, 9], "x": 9.25, "y": 3},
+ {"matrix": [3, 10], "x": 10.25, "y": 3},
+ {"matrix": [3, 11], "x": 11.25, "y": 3},
+ {"matrix": [3, 12], "x": 12.25, "y": 3, "w": 1.75},
+ {"matrix": [3, 14], "x": 14.25, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4, "w": 1.25},
+ {"matrix": [4, 2], "x": 2.5, "y": 4, "w": 1.25},
+ {"matrix": [4, 6], "x": 3.75, "y": 4, "w": 6.25},
+ {"matrix": [4, 10], "x": 10, "y": 4},
+ {"matrix": [4, 11], "x": 11, "y": 4},
+ {"matrix": [4, 12], "x": 12, "y": 4},
+ {"matrix": [4, 13], "x": 13.25, "y": 4.25},
+ {"matrix": [4, 14], "x": 14.25, "y": 4.25},
+ {"matrix": [4, 15], "x": 15.25, "y": 4.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v2_max/iso_encoder/keymaps/default/keymap.c b/keyboards/keychron/v2_max/iso_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..7367302072
--- /dev/null
+++ b/keyboards/keychron/v2_max/iso_encoder/keymaps/default/keymap.c
@@ -0,0 +1,82 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ FN2,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_68(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ 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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD,MO(MAC_FN1),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_BASE] = LAYOUT_iso_68(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ 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_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN1),MO(FN2), KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN1] = LAYOUT_iso_68(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL,KC_LNPAD,RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_FN1] = LAYOUT_iso_68(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [FN2] = LAYOUT_iso_68(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_BASE] = { ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN1] = { ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_FN1] = { ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [FN2] = { ENCODER_CCW_CW(_______, _______)}
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v2_max/iso_encoder/rules.mk b/keyboards/keychron/v2_max/iso_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v2_max/iso_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v2_max/mcuconf.h b/keyboards/keychron/v2_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/v2_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/v2_max/readme.md b/keyboards/keychron/v2_max/readme.md
new file mode 100644
index 0000000000..ce06522777
--- /dev/null
+++ b/keyboards/keychron/v2_max/readme.md
@@ -0,0 +1,23 @@
+# Keychron V2 Max
+
+
+
+A customizable 65% keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron V2 Max
+* Hardware Availability: [Keychron V2 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-v2-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/v2_max/ansi_encoder:default
+ make keychron/v2_max/iso_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/v2_max/ansi_encoder:default:flash
+ make keychron/v2_max/iso_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/v2_max/rules.mk b/keyboards/keychron/v2_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/v2_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/v2_max/v2_max.c b/keyboards/keychron/v2_max/v2_max.c
new file mode 100644
index 0000000000..eacfff38ec
--- /dev/null
+++ b/keyboards/keychron/v2_max/v2_max.c
@@ -0,0 +1,84 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 1));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ } else {
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/v2_max/via_json/v2_max_ansi_encoder.json b/keyboards/keychron/v2_max/via_json/v2_max_ansi_encoder.json
new file mode 100644
index 0000000000..a6b80c6e62
--- /dev/null
+++ b/keyboards/keychron/v2_max/via_json/v2_max_ansi_encoder.json
@@ -0,0 +1,250 @@
+{
+ "name": "Keychron V2 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0920",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ {
+ "x": 0.25,
+ "y": -0.25
+ },
+ "0, 15\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25,
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "2, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 12",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "3, 14"
+ ],
+ [
+ {
+ "y": -0.25,
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "w": 1.25
+ },
+ "4, 1",
+ {
+ "w": 1.25
+ },
+ "4, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "4, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "4, 13",
+ "4, 14",
+ "4, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/v2_max/via_json/v2_max_iso_encoder.json b/keyboards/keychron/v2_max/via_json/v2_max_iso_encoder.json
new file mode 100644
index 0000000000..8ba74ac970
--- /dev/null
+++ b/keyboards/keychron/v2_max/via_json/v2_max_iso_encoder.json
@@ -0,0 +1,253 @@
+{
+ "name": "Keychron V2 Max ISO Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0921",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 16},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "0, 13",
+ {
+ "x": 0.25,
+ "y": -0.25
+ },
+ "0, 15\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25,
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "1, 13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 15"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 12",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "3, 14"
+ ],
+ [
+ {
+ "y": -0.25,
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "w": 1.25
+ },
+ "4, 1",
+ {
+ "w": 1.25
+ },
+ "4, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "4, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 10",
+ "4, 11",
+ "4, 12",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "4, 13",
+ "4, 14",
+ "4, 15"
+ ]
+ ]
+ }
+}
diff --git a/keyboards/keychron/v3_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/v3_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..3a12c82705
--- /dev/null
+++ b/keyboards/keychron/v3_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,154 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA8, CB6_CA8, CB5_CA8},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, __, __, __, __ },
+ { 63, __, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, __, __, 75, __ },
+ { 76, 77, 78, __, __, __, 79, __, __, __, 80, 81, 82, 83, 84, 85, 86 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {16, 0}, {29, 0}, {42, 0}, {55, 0}, {71, 0}, {84, 0}, { 97, 0}, {110, 0}, {126, 0}, {139, 0}, {152, 0}, {165, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,15}, {13,15}, {26,15}, {39,15}, {52,15}, {65,15}, {78,15}, { 91,15}, {104,15}, {117,15}, {130,15}, {143,15}, {156,15}, {176,15}, {198,15}, {211,15}, {224,15},
+ {3,28}, {19,28}, {32,28}, {46,28}, {59,28}, {72,28}, {85,28}, { 98,28}, {111,28}, {124,28}, {137,28}, {150,28}, {163,28}, {179,28}, {198,28}, {211,28}, {224,28},
+ {5,40}, {23,40}, {36,40}, {49,40}, {62,40}, {75,40}, {88,40}, {101,40}, {114,40}, {127,40}, {140,40}, {153,40}, {174,40},
+ {8,52}, {29,52}, {42,52}, {55,52}, {68,52}, {81,52}, { 94,52}, {107,52}, {120,52}, {133,52}, {146,52}, {171,52}, {211,52},
+ {2,64}, {18,64}, {34,64}, {83,64}, {132,64}, {148,64}, {164,64}, {180,64}, {198,64}, {211,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/v3_max/ansi_encoder/config.h b/keyboards/keychron/v3_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..ea679827ea
--- /dev/null
+++ b/keyboards/keychron/v3_max/ansi_encoder/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 87
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 50
+# define LOW_BAT_IND_INDEX \
+ { 79 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v3_max/ansi_encoder/keyboard.json b/keyboards/keychron/v3_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..df7e50d48e
--- /dev/null
+++ b/keyboards/keychron/v3_max/ansi_encoder/keyboard.json
@@ -0,0 +1,117 @@
+{
+ "usb": {
+ "pid": "0x0933",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "encoder": true,
+ "encoder_map": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "layouts": {
+ "LAYOUT_tkl_ansi": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+ {"matrix": [0, 15], "x": 16.25, "y": 0},
+ {"matrix": [0, 16], "x": 17.25, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 15], "x": 16.25, "y": 1.25},
+ {"matrix": [1, 16], "x": 17.25, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 13], "x": 13.5, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 16.25, "y": 2.25},
+ {"matrix": [2, 16], "x": 17.25, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25, "w": 2.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4.25, "w": 2.75},
+ {"matrix": [4, 15], "x": 16.25, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.25},
+ {"matrix": [5, 15], "x": 16.25, "y": 5.25},
+ {"matrix": [5, 16], "x": 17.25, "y": 5.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v3_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/v3_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..f8818b50bc
--- /dev/null
+++ b/keyboards/keychron/v3_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,76 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_tkl_ansi(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_MUTE, KC_SNAP, KC_SIRI, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_tkl_ansi(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, RGB_TOG, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_tkl_ansi(
+ 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_MUTE, KC_PSCR, KC_CTANA, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LCMD, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_tkl_ansi(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, RGB_TOG, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v3_max/ansi_encoder/rules.mk b/keyboards/keychron/v3_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v3_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v3_max/board.h b/keyboards/keychron/v3_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/v3_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/v3_max/config.h b/keyboards/keychron/v3_max/config.h
new file mode 100644
index 0000000000..ff3641ede1
--- /dev/null
+++ b/keyboards/keychron/v3_max/config.h
@@ -0,0 +1,78 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A9
+# define BT_MODE_SELECT_PIN A10
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define P2P4G_CELAR_MASK 0
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/v3_max/halconf.h b/keyboards/keychron/v3_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/v3_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/v3_max/info.json b/keyboards/keychron/v3_max/info.json
new file mode 100644
index 0000000000..763ceacb9e
--- /dev/null
+++ b/keyboards/keychron/v3_max/info.json
@@ -0,0 +1,67 @@
+{
+ "keyboard_name": "Keychron V3 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string": true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch" :{
+ "pins": ["A8"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/v3_max/iso_encoder/config.h b/keyboards/keychron/v3_max/iso_encoder/config.h
new file mode 100644
index 0000000000..9c6a43ee11
--- /dev/null
+++ b/keyboards/keychron/v3_max/iso_encoder/config.h
@@ -0,0 +1,45 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 88
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34, 0x34 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indicator */
+# define CAPS_LOCK_INDEX 50
+# define LOW_BAT_IND_INDEX \
+ { 80 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v3_max/iso_encoder/iso_encoder.c b/keyboards/keychron/v3_max/iso_encoder/iso_encoder.c
new file mode 100644
index 0000000000..34646f6d8a
--- /dev/null
+++ b/keyboards/keychron/v3_max/iso_encoder/iso_encoder.c
@@ -0,0 +1,155 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB10_CA1, CB12_CA1, CB11_CA1},
+ {0, CB10_CA2, CB12_CA2, CB11_CA2},
+ {0, CB10_CA3, CB12_CA3, CB11_CA3},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA8, CB6_CA8, CB5_CA8},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, 14, 15 },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32 },
+ { 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49 },
+ { 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, __, __, __, __ },
+ { 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, __, __, 76, __ },
+ { 77, 78, 79, __, __, __, 80, __, __, __, 81, 82, 83, 84, 85, 86, 87 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {16, 0}, {29, 0}, {42, 0}, {55, 0}, {71, 0}, {84, 0}, { 97, 0}, {110, 0}, {126, 0}, {139, 0}, {152, 0}, {165, 0}, {198, 0}, {211, 0}, {224, 0},
+ {0,15}, {13,15}, {26,15}, {39,15}, {52,15}, {65,15}, {78,15}, { 91,15}, {104,15}, {117,15}, {130,15}, {143,15}, {156,15}, {176,15}, {198,15}, {211,15}, {224,15},
+ {3,28}, {19,28}, {32,28}, {46,28}, {59,28}, {72,28}, {85,28}, { 98,28}, {111,28}, {124,28}, {137,28}, {150,28}, {163,28}, {180,34}, {198,28}, {211,28}, {224,28},
+ {5,40}, {23,40}, {36,40}, {49,40}, {62,40}, {75,40}, {88,40}, {101,40}, {114,40}, {127,40}, {140,40}, {153,40}, {166,40},
+ {2,52}, {16,52}, {29,52}, {42,52}, {55,52}, {68,52}, {81,52}, { 94,52}, {107,52}, {120,52}, {133,52}, {146,52}, {171,52}, {211,52},
+ {2,64}, {18,64}, {34,64}, {83,64}, {132,64}, {148,64}, {164,64}, {180,64}, {198,64}, {211,64}, {224,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/v3_max/iso_encoder/keyboard.json b/keyboards/keychron/v3_max/iso_encoder/keyboard.json
new file mode 100644
index 0000000000..8c1d214fcd
--- /dev/null
+++ b/keyboards/keychron/v3_max/iso_encoder/keyboard.json
@@ -0,0 +1,118 @@
+{
+ "usb": {
+ "pid": "0x0934",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "encoder": true,
+ "encoder_map": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "layouts": {
+ "LAYOUT_tkl_iso": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+ {"matrix": [0, 15], "x": 16.25, "y": 0},
+ {"matrix": [0, 16], "x": 17.25, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 15], "x": 16.25, "y": 1.25},
+ {"matrix": [1, 16], "x": 17.25, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 16.25, "y": 2.25},
+ {"matrix": [2, 16], "x": 17.25, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25},
+ {"matrix": [2, 13], "x": 13.25, "y": 2.75, "h": 2},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4.25, "w": 2.75},
+ {"matrix": [4, 15], "x": 16.25, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.25},
+ {"matrix": [5, 15], "x": 16.25, "y": 5.25},
+ {"matrix": [5, 16], "x": 17.25, "y": 5.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v3_max/iso_encoder/keymaps/default/keymap.c b/keyboards/keychron/v3_max/iso_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..63bd1ff3e3
--- /dev/null
+++ b/keyboards/keychron/v3_max/iso_encoder/keymaps/default/keymap.c
@@ -0,0 +1,76 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_tkl_iso(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_MUTE, KC_SNAP, KC_SIRI, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN] = LAYOUT_tkl_iso(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, RGB_TOG, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_BASE] = LAYOUT_tkl_iso(
+ 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_MUTE, KC_PSCR, KC_CTANA, RGB_MOD,
+ 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_INS, KC_HOME, KC_PGUP,
+ 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_DEL, KC_END, KC_PGDN,
+ 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_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_LCTL, KC_LCMD, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_FN] = LAYOUT_tkl_iso(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, RGB_TOG, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v3_max/iso_encoder/rules.mk b/keyboards/keychron/v3_max/iso_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v3_max/iso_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v3_max/mcuconf.h b/keyboards/keychron/v3_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/v3_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/v3_max/readme.md b/keyboards/keychron/v3_max/readme.md
new file mode 100644
index 0000000000..43c1c72965
--- /dev/null
+++ b/keyboards/keychron/v3_max/readme.md
@@ -0,0 +1,23 @@
+# Keychron V3 Max
+
+
+
+A customizable wireless TLK keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron V3 Max
+* Hardware Availability: [Keychron V3 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-v3-max-qmk-via-wireless-custom-mechanical-keyboard?variant=40868403150937)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/v3_max/ansi_encoder:default
+ make keychron/v3_max/iso_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/v3_max/ansi_encoder:default:flash
+ make keychron/v3_max/iso_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/v3_max/rules.mk b/keyboards/keychron/v3_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/v3_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/v3_max/v3_max.c b/keyboards/keychron/v3_max/v3_max.c
new file mode 100644
index 0000000000..19e1c4b0cc
--- /dev/null
+++ b/keyboards/keychron/v3_max/v3_max.c
@@ -0,0 +1,61 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 2 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/v3_max/via_json/v3_max_ansi_encoder_v1.0.json b/keyboards/keychron/v3_max/via_json/v3_max_ansi_encoder_v1.0.json
new file mode 100644
index 0000000000..4f3a398a2b
--- /dev/null
+++ b/keyboards/keychron/v3_max/via_json/v3_max_ansi_encoder_v1.0.json
@@ -0,0 +1,295 @@
+{
+ "name": "Keychron V3 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0933",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 13\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.25
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 12"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#aaaaaa"
+ },
+ "4, 12",
+ {
+ "x": 1.25
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.25
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/v3_max/via_json/v3_max_iso_encoder_v1.0.json b/keyboards/keychron/v3_max/via_json/v3_max_iso_encoder_v1.0.json
new file mode 100644
index 0000000000..3dac5a0c07
--- /dev/null
+++ b/keyboards/keychron/v3_max/via_json/v3_max_iso_encoder_v1.0.json
@@ -0,0 +1,298 @@
+{
+ "name": "Keychron V3 Max ISO Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0934",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 13\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.25
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "c": "#777777",
+ "w": 1.25,
+ "h": 2,
+ "w2": 1.5,
+ "h2": 1,
+ "x2": -0.25
+ },
+ "2, 13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 12"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 1",
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#aaaaaa"
+ },
+ "4, 12",
+ {
+ "x": 1.25
+ },
+ "4, 15"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.25
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/v4_max/ansi/ansi.c b/keyboards/keychron/v4_max/ansi/ansi.c
new file mode 100644
index 0000000000..c1d2c1d8b9
--- /dev/null
+++ b/keyboards/keychron/v4_max/ansi/ansi.c
@@ -0,0 +1,124 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9 },
+ {1, CB4_CA8, CB6_CA8, CB5_CA8 },
+ {1, CB4_CA7, CB6_CA7, CB5_CA7 },
+ {1, CB4_CA6, CB6_CA6, CB5_CA6 },
+ {1, CB4_CA5, CB6_CA5, CB5_CA5 },
+ {1, CB4_CA4, CB6_CA4, CB5_CA4 },
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1}
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13 },
+ { 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27 },
+ { 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, __, 40 },
+ { 41, __, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, __, 52 },
+ { 53, 54, 55, __, __, __, 56, __, __, __, 57, 58, 59, 60 }
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {13, 0}, {26, 0}, {35, 0}, {46, 0}, {57, 0}, {68, 0}, {79, 0}, {90, 0}, {101, 0}, {112, 0}, {123, 0}, {134, 0}, {145, 0},
+ {7,16}, {20,16}, {30,16}, {41,16}, {52,16}, {63,16}, {74,16}, {85,16}, {96,16}, {107,16}, {118,16}, {129,16}, {140,16}, {149,16},
+ {7,32}, {21,32}, {32,32}, {43,32}, {54,32}, {65,32}, {76,32}, {87,32}, {98,32}, {109,32}, {120,32}, {132,32}, {142,32},
+ {8,48}, {28,48}, {37,48}, {48,48}, {59,48}, {70,48}, {81,48}, {92,48}, {103,48}, {114,48}, {125,48}, {142,48},
+ {2,64}, {15,64}, {28,64}, {72,64}, {114,64}, {125,64}, {135,64}, {143,64}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1,
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 8, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1,
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1,
+ 1, 1, 1, 4, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/v4_max/ansi/config.h b/keyboards/keychron/v4_max/ansi/config.h
new file mode 100644
index 0000000000..4ef2a2643d
--- /dev/null
+++ b/keyboards/keychron/v4_max/ansi/config.h
@@ -0,0 +1,52 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 61
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36, 0x36 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define CAPS_LOCK_INDEX 28
+# define P24G_INDICATION_LED_MATRIX_INDEX 18
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 15, 16, 17 }
+# define BAT_LEVEL_LED_LIST \
+ { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
+# define LOW_BAT_IND_INDEX \
+ { 56 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v4_max/ansi/keyboard.json b/keyboards/keychron/v4_max/ansi/keyboard.json
new file mode 100644
index 0000000000..7189f699ee
--- /dev/null
+++ b/keyboards/keychron/v4_max/ansi/keyboard.json
@@ -0,0 +1,77 @@
+{
+ "usb": {
+ "pid": "0x0940",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_61": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 6], "x": 6, "y": 0},
+ {"matrix": [0, 7], "x": 7, "y": 0},
+ {"matrix": [0, 8], "x": 8, "y": 0},
+ {"matrix": [0, 9], "x": 9, "y": 0},
+ {"matrix": [0, 10], "x": 10, "y": 0},
+ {"matrix": [0, 11], "x": 11, "y": 0},
+ {"matrix": [0, 12], "x": 12, "y": 0},
+ {"matrix": [0, 13], "x": 13, "y": 0, "w": 2},
+
+ {"matrix": [1, 0], "x": 0, "y": 1, "w": 1.5},
+ {"matrix": [1, 1], "x": 1.5, "y": 1},
+ {"matrix": [1, 2], "x": 2.5, "y": 1},
+ {"matrix": [1, 3], "x": 3.5, "y": 1},
+ {"matrix": [1, 4], "x": 4.5, "y": 1},
+ {"matrix": [1, 5], "x": 5.5, "y": 1},
+ {"matrix": [1, 6], "x": 6.5, "y": 1},
+ {"matrix": [1, 7], "x": 7.5, "y": 1},
+ {"matrix": [1, 8], "x": 8.5, "y": 1},
+ {"matrix": [1, 9], "x": 9.5, "y": 1},
+ {"matrix": [1, 10], "x": 10.5, "y": 1},
+ {"matrix": [1, 11], "x": 11.5, "y": 1},
+ {"matrix": [1, 12], "x": 12.5, "y": 1},
+ {"matrix": [1, 13], "x": 13.5, "y": 1, "w": 1.5},
+
+ {"matrix": [2, 0], "x": 0, "y": 2, "w": 1.75},
+ {"matrix": [2, 1], "x": 1.75, "y": 2},
+ {"matrix": [2, 2], "x": 2.75, "y": 2},
+ {"matrix": [2, 3], "x": 3.75, "y": 2},
+ {"matrix": [2, 4], "x": 4.75, "y": 2},
+ {"matrix": [2, 5], "x": 5.75, "y": 2},
+ {"matrix": [2, 6], "x": 6.75, "y": 2},
+ {"matrix": [2, 7], "x": 7.75, "y": 2},
+ {"matrix": [2, 8], "x": 8.75, "y": 2},
+ {"matrix": [2, 9], "x": 9.75, "y": 2},
+ {"matrix": [2, 10], "x": 10.75, "y": 2},
+ {"matrix": [2, 11], "x": 11.75, "y": 2},
+ {"matrix": [2, 13], "x": 12.75, "y": 2, "w": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3, "w": 2.25},
+ {"matrix": [3, 2], "x": 2.25, "y": 3},
+ {"matrix": [3, 3], "x": 3.25, "y": 3},
+ {"matrix": [3, 4], "x": 4.25, "y": 3},
+ {"matrix": [3, 5], "x": 5.25, "y": 3},
+ {"matrix": [3, 6], "x": 6.25, "y": 3},
+ {"matrix": [3, 7], "x": 7.25, "y": 3},
+ {"matrix": [3, 8], "x": 8.25, "y": 3},
+ {"matrix": [3, 9], "x": 9.25, "y": 3},
+ {"matrix": [3, 10], "x": 10.25, "y": 3},
+ {"matrix": [3, 11], "x": 11.25, "y": 3},
+ {"matrix": [3, 13], "x": 12.25, "y": 3, "w": 2.75},
+
+ {"matrix": [4, 0], "x": 0, "y": 4, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4, "w": 1.25},
+ {"matrix": [4, 2], "x": 2.5, "y": 4, "w": 1.25},
+ {"matrix": [4, 6], "x": 3.75, "y": 4, "w": 6.25},
+ {"matrix": [4, 10], "x": 10, "y": 4, "w": 1.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4, "w": 1.25},
+ {"matrix": [4, 12], "x": 12.5, "y": 4, "w": 1.25},
+ {"matrix": [4, 13], "x": 13.75, "y": 4, "w": 1.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v4_max/ansi/keymaps/default/keymap.c b/keyboards/keychron/v4_max/ansi/keymaps/default/keymap.c
new file mode 100644
index 0000000000..08d6e0c0c7
--- /dev/null
+++ b/keyboards/keychron/v4_max/ansi/keymaps/default/keymap.c
@@ -0,0 +1,72 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ WIN_BASE,
+ _FN1,
+ _FN2,
+ _FN3,
+};
+
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_61(
+ KC_ESC, 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_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_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_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT,
+ KC_LCTL, KC_LOPT, KC_LCMD, KC_SPC, KC_RCMD, MO(_FN1), MO(_FN3), KC_RCTL),
+
+ [WIN_BASE] = LAYOUT_ansi_61(
+ KC_ESC, 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_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_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_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT,
+ KC_LCTL, KC_LGUI, KC_LALT, KC_SPC, KC_RALT, MO(_FN2), MO(_FN3), KC_RCTL),
+
+ [_FN1] = LAYOUT_ansi_61(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTL, KC_LPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, KC_INS, KC_PGUP, KC_HOME, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUD, RGB_SAI, RGB_SPI, _______, _______, KC_UP, KC_SNAP, KC_PGDN, KC_END, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUI, RGB_SAD, RGB_SPD, NK_TOGG, KC_LEFT, KC_DOWN, KC_RIGHT, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [_FN2] = LAYOUT_ansi_61(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, KC_APP, KC_SCRL, KC_INS, KC_PGUP, KC_HOME, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUD, RGB_SAI, RGB_SPI, _______, _______, KC_UP, KC_PSCR, KC_PGDN, KC_END, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUI, RGB_SAD, RGB_SPD, NK_TOGG, KC_LEFT, KC_DOWN, KC_RIGHT, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [_FN3] = LAYOUT_ansi_61(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v4_max/ansi/rules.mk b/keyboards/keychron/v4_max/ansi/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v4_max/ansi/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v4_max/board.h b/keyboards/keychron/v4_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/v4_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/v4_max/config.h b/keyboards/keychron/v4_max/config.h
new file mode 100644
index 0000000000..0bbc2fd69e
--- /dev/null
+++ b/keyboards/keychron/v4_max/config.h
@@ -0,0 +1,77 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(4)
+#define BL_CYCLE_KEY KC_C
+#define BL_TRIG_KEY KC_L
+
+#define P2P4G_CELAR_MASK 0
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/v4_max/halconf.h b/keyboards/keychron/v4_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/v4_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/v4_max/info.json b/keyboards/keychron/v4_max/info.json
new file mode 100644
index 0000000000..d6b63ff366
--- /dev/null
+++ b/keyboards/keychron/v4_max/info.json
@@ -0,0 +1,70 @@
+{
+ "keyboard_name": "Keychron V4 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string" : true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3"],
+ "rows": ["C12", "D2", "B3", "B4", "B5"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch" :{
+ "pins": ["A8"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "dynamic_keymap": {
+ "layer_count": 5
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/v4_max/mcuconf.h b/keyboards/keychron/v4_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/v4_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/v4_max/readme.md b/keyboards/keychron/v4_max/readme.md
new file mode 100644
index 0000000000..1d76668c23
--- /dev/null
+++ b/keyboards/keychron/v4_max/readme.md
@@ -0,0 +1,23 @@
+# Keychron V4 Max
+
+
+
+A customizable keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron V4 Max
+* Hardware Availability: [Keychron V4 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-v4-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/v4_max/ansi:default
+ make keychron/v4_max/iso:default
+
+Flashing example for this keyboard:
+
+ make keychron/v4_max/ansi_encoder:default:flash
+ make keychron/v4_max/iso_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/v4_max/rules.mk b/keyboards/keychron/v4_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/v4_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/v4_max/v4_max.c b/keyboards/keychron/v4_max/v4_max.c
new file mode 100644
index 0000000000..203f7edf87
--- /dev/null
+++ b/keyboards/keychron/v4_max/v4_max.c
@@ -0,0 +1,78 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 1));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ } else {
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/v4_max/via_json/v4_max_ansi.json b/keyboards/keychron/v4_max/via_json/v4_max_ansi.json
new file mode 100644
index 0000000000..b1d3574562
--- /dev/null
+++ b/keyboards/keychron/v4_max/via_json/v4_max_ansi.json
@@ -0,0 +1,229 @@
+{
+ "name": "Keychron V4 Max ANSI",
+ "vendorId": "0x3434",
+ "productId": "0x0940",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 14},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "y": 0.25,
+ "c": "#777777"
+ },
+ "0,0\nESC",
+ {
+ "c": "#cccccc"
+ },
+ "0,1",
+ "0,2",
+ "0,3",
+ "0,4",
+ "0,5",
+ "0,6",
+ "0,7",
+ "0,8",
+ "0,9",
+ "0,10",
+ "0,11",
+ "0,12",
+ {
+ "c": "#aaaaaa",
+ "w": 2
+ },
+ "0,13"
+ ],
+ [
+ {
+ "w": 1.5
+ },
+ "1,0",
+ {
+ "c": "#cccccc"
+ },
+ "1,1",
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5",
+ "1,6",
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11",
+ "1,12",
+ {
+ "w": 1.5,
+ "c":"#aaaaaa"
+ },
+ "1,13"
+ ],
+ [
+ {
+ "w": 1.75
+ },
+ "2,0",
+ {
+ "c": "#cccccc"
+ },
+ "2,1",
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5",
+ "2,6",
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10",
+ "2,11",
+ {
+ "c": "#777777",
+ "w": 2.25
+ },
+ "2,13"
+ ],
+ [
+ {
+ "c": "#aaaaaa",
+ "w": 2.25
+ },
+ "3,0",
+ {
+ "c": "#cccccc"
+ },
+ "3,2",
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6",
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11",
+ {
+ "c": "#aaaaaa",
+ "w": 2.75
+ },
+ "3,13"
+ ],
+ [
+ {
+ "w": 1.25
+ },
+ "4,0",
+ {
+ "w": 1.25
+ },
+ "4,1",
+ {
+ "w": 1.25
+ },
+ "4,2",
+ {
+ "c": "#cccccc",
+ "w": 6.25
+ },
+ "4,6",
+ {
+ "c": "#aaaaaa",
+ "w": 1.25
+ },
+ "4,10",
+ {
+ "w": 1.25
+ },
+ "4,11",
+ {
+ "w": 1.25
+ },
+ "4,12",
+ {
+ "w": 1.25
+ },
+ "4,13"
+ ]
+ ]
+ }
+}
\ No newline at end of file
diff --git a/keyboards/keychron/v5_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/v5_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..948e31c81f
--- /dev/null
+++ b/keyboards/keychron/v5_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,164 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB10_CA6, CB12_CA6, CB11_CA6},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+ {1, CB10_CA5, CB12_CA5, CB11_CA5},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, __, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, __ },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30, 31, 32, 33 },
+ { 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, __, 48, 49, 50, __ },
+ { 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, __, __, 64, 65, 66, 67 },
+ { 68, __, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, __, 80, 81, 82, 83, 84 },
+ { 85, 86, 87, __, __, __, 88, __, __, __, 89, 90, 91, 92, 93, 94, 95, 96, __ }
+ },
+ {
+ // LED Index to Physical Position
+ {0,0}, {24,0}, {36,0}, {48,0}, {60,0}, {78,0}, {90,0}, {102,0}, {106,0}, {133,0}, {145,0}, {157,0}, {169,0}, {185,0}, {195,0}, {207,0},
+ {0,15}, {12,15}, {24,15}, {36,15}, {48,15}, {60,15}, {72,15}, {84,15}, {97,15}, {109,15}, {121,15}, {133,15}, {145,15}, {163,15}, {188,15}, {200,15}, {212,15}, {224,15},
+ {3,26}, {18,26}, {30,26}, {42,26}, {54,26}, {66,26}, {78,26}, {91,26}, {103,26}, {115,26}, {127,26}, {139,26}, {151,26}, {166,26}, {188,26}, {200,26}, {212,26},
+ {5,38}, {21,38}, {33,38}, {45,38}, {57,38}, {69,38}, {81,38}, {94,38}, {106,38}, {118,38}, {130,38}, {142,38}, {161,38}, {188,38}, {200,38}, {212,38}, {224,32},
+ {8,49}, {27,49}, {39,49}, {51,49}, {63,49}, {75,49}, {88,49}, {100,49}, {112,49}, {124,49}, {136,49}, {152,49}, {172,52}, {188,49}, {200,49}, {212,49}, {224,55},
+ {1,61}, {17,61}, {32,61}, {77,61}, {121,61}, {133,61}, {145,61}, {160,64}, {172,64}, {184,64}, {200,61}, {212,61},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 8, 4, 4, 4,
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 8, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 4, 4, 4, 4,
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 1, 4, 4, 4, 4,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/v5_max/ansi_encoder/config.h b/keyboards/keychron/v5_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..5d221da23c
--- /dev/null
+++ b/keyboards/keychron/v5_max/ansi_encoder/config.h
@@ -0,0 +1,51 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 97
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define NUM_LOCK_INDEX 30
+# define CAPS_LOCK_INDEX 51
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+# define LOW_BAT_IND_INDEX \
+ { 88 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v5_max/ansi_encoder/keyboard.json b/keyboards/keychron/v5_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..e3776acb97
--- /dev/null
+++ b/keyboards/keychron/v5_max/ansi_encoder/keyboard.json
@@ -0,0 +1,127 @@
+{
+ "usb": {
+ "pid": "0x0950",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "encoder": true,
+ "encoder_map": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "layouts": {
+ "LAYOUT_ansi_98": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 7], "x": 6.5, "y": 0},
+ {"matrix": [0, 8], "x": 7.5, "y": 0},
+ {"matrix": [0, 9], "x": 8.5, "y": 0},
+ {"matrix": [0, 10], "x": 9.5, "y": 0},
+ {"matrix": [0, 11], "x": 11, "y": 0},
+ {"matrix": [0, 12], "x": 12, "y": 0},
+ {"matrix": [0, 13], "x": 13, "y": 0},
+ {"matrix": [0, 14], "x": 14, "y": 0},
+ {"matrix": [0, 15], "x": 15.25, "y": 0},
+ {"matrix": [0, 16], "x": 16.25, "y": 0},
+ {"matrix": [0, 17], "x": 17.25, "y": 0},
+ {"matrix": [0, 18], "x": 18.5, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 15], "x": 15.5, "y": 1.25},
+ {"matrix": [1, 16], "x": 16.5, "y": 1.25},
+ {"matrix": [1, 17], "x": 17.5, "y": 1.25},
+ {"matrix": [1, 18], "x": 18.5, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 13], "x": 13.5, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 15], "x": 15.5, "y": 2.25},
+ {"matrix": [2, 16], "x": 16.5, "y": 2.25},
+ {"matrix": [2, 17], "x": 17.5, "y": 2.25},
+ {"matrix": [3, 18], "x": 18.5, "y": 2.25, "h": 2},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 15], "x": 15.5, "y": 3.25},
+ {"matrix": [3, 16], "x": 16.5, "y": 3.25},
+ {"matrix": [3, 17], "x": 17.5, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 14], "x": 14.25, "y": 4.5},
+ {"matrix": [4, 15], "x": 15.5, "y": 4.25},
+ {"matrix": [4, 16], "x": 16.5, "y": 4.25},
+ {"matrix": [4, 17], "x": 17.5, "y": 4.25},
+ {"matrix": [4, 18], "x": 18.5, "y": 4.25, "h": 2},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25},
+ {"matrix": [5, 11], "x": 11, "y": 5.25},
+ {"matrix": [5, 12], "x": 12, "y": 5.25},
+ {"matrix": [5, 13], "x": 13.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 14.25, "y": 5.5},
+ {"matrix": [5, 15], "x": 15.25, "y": 5.5},
+ {"matrix": [5, 16], "x": 16.5, "y": 5.25},
+ {"matrix": [5, 17], "x": 17.5, "y": 5.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v5_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/v5_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..e63b6d23bd
--- /dev/null
+++ b/keyboards/keychron/v5_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,74 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_98(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, KC_HOME, KC_END, KC_MUTE,
+ 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_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+ [MAC_FN] = LAYOUT_ansi_98(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+ [WIN_BASE] = LAYOUT_ansi_98(
+ 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_DEL, KC_HOME, KC_END, KC_MUTE,
+ 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_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+ [WIN_FN] = LAYOUT_ansi_98(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+ };
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
+
diff --git a/keyboards/keychron/v5_max/ansi_encoder/rules.mk b/keyboards/keychron/v5_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v5_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v5_max/board.h b/keyboards/keychron/v5_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/v5_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/v5_max/config.h b/keyboards/keychron/v5_max/config.h
new file mode 100644
index 0000000000..1ed26f3081
--- /dev/null
+++ b/keyboards/keychron/v5_max/config.h
@@ -0,0 +1,76 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define P2P4G_CELAR_MASK 0
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/v5_max/halconf.h b/keyboards/keychron/v5_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/v5_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/v5_max/info.json b/keyboards/keychron/v5_max/info.json
new file mode 100644
index 0000000000..e82bbb9417
--- /dev/null
+++ b/keyboards/keychron/v5_max/info.json
@@ -0,0 +1,67 @@
+{
+ "keyboard_name": "Keychron V5 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "nkro" : true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string" : true
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "C9"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch" :{
+ "pins": ["A8"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/v5_max/iso_encoder/config.h b/keyboards/keychron/v5_max/iso_encoder/config.h
new file mode 100644
index 0000000000..55b22bdc87
--- /dev/null
+++ b/keyboards/keychron/v5_max/iso_encoder/config.h
@@ -0,0 +1,51 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 98
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C, 0x2C }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define NUM_LOCK_INDEX 30
+# define CAPS_LOCK_INDEX 51
+# define P24G_INDICATION_LED_MATRIX_INDEX 20
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 17, 18, 19 }
+# define BAT_LEVEL_LED_LIST \
+ { 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 }
+# define LOW_BAT_IND_INDEX \
+ { 89 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v5_max/iso_encoder/iso_encoder.c b/keyboards/keychron/v5_max/iso_encoder/iso_encoder.c
new file mode 100644
index 0000000000..9c068c821b
--- /dev/null
+++ b/keyboards/keychron/v5_max/iso_encoder/iso_encoder.c
@@ -0,0 +1,165 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA12, CB3_CA12, CB2_CA12},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA8, CB3_CA8, CB2_CA8},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB10_CA6, CB12_CA6, CB11_CA6},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB7_CA2, CB9_CA2, CB8_CA2},
+ {1, CB7_CA1, CB9_CA1, CB8_CA1},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+ {1, CB10_CA5, CB12_CA5, CB11_CA5},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, __, 1, 2, 3, 4, __, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, __ },
+ { 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, __, 30, 31, 32, 33 },
+ { 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, __, 48, 49, 50, __ },
+ { 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, __, __, 64, 65, 66, 67 },
+ { 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, __, 81, 82, 83, 84, 85,},
+ { 86, 87, 88, __, __, __, 89, __, __, __, 90, 91, 92, 93, 94, 95, 96, 97, __ }
+ },
+ {
+ // LED Index to Physical Position
+ {0,0}, {24,0}, {36,0}, {48,0}, {60,0}, {78,0}, {90,0}, {102,0}, {106,0}, {133,0}, {145,0}, {157,0}, {169,0}, {185,0}, {195,0}, {207,0},
+ {0,15}, {12,15}, {24,15}, {36,15}, {48,15}, {60,15}, {72,15}, {84,15}, {97,15}, {109,15}, {121,15}, {133,15}, {145,15}, {163,15}, {188,15}, {200,15}, {212,15}, {224,15},
+ {3,26}, {18,26}, {30,26}, {42,26}, {54,26}, {66,26}, {78,26}, {91,26}, {103,26}, {115,26}, {127,26}, {139,26}, {151,26}, {166,32}, {188,26}, {200,26}, {212,26},
+ {5,38}, {21,38}, {33,38}, {45,38}, {57,38}, {69,38}, {81,38}, {94,38}, {106,38}, {118,38}, {130,38}, {142,38}, {154,38}, {188,38}, {200,38}, {212,38}, {224,32},
+ {3,49}, {13,49}, {27,49}, {39,49}, {51,49}, {63,49}, {75,49}, {88,49}, {100,49}, {112,49}, {124,49}, {136,49}, {152,49}, {172,52}, {188,49}, {200,49}, {212,49}, {224,55},
+ {1,61}, {17,61}, {32,61}, {77,61}, {121,61}, {133,61}, {145,61}, {160,64}, {172,64}, {184,64}, {200,61}, {212,61},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 8, 4, 4, 4,
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4,
+ 8, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 4, 4, 4, 4,
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 1, 4, 4, 4, 4,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/v5_max/iso_encoder/keyboard.json b/keyboards/keychron/v5_max/iso_encoder/keyboard.json
new file mode 100644
index 0000000000..993323becb
--- /dev/null
+++ b/keyboards/keychron/v5_max/iso_encoder/keyboard.json
@@ -0,0 +1,128 @@
+{
+ "usb": {
+ "pid": "0x0951",
+ "device_version": "1.0.0"
+ },
+ "features": {
+ "encoder": true,
+ "encoder_map": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "layouts": {
+ "LAYOUT_iso_99": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 2], "x": 2, "y": 0},
+ {"matrix": [0, 3], "x": 3, "y": 0},
+ {"matrix": [0, 4], "x": 4, "y": 0},
+ {"matrix": [0, 5], "x": 5, "y": 0},
+ {"matrix": [0, 7], "x": 6.5, "y": 0},
+ {"matrix": [0, 8], "x": 7.5, "y": 0},
+ {"matrix": [0, 9], "x": 8.5, "y": 0},
+ {"matrix": [0, 10], "x": 9.5, "y": 0},
+ {"matrix": [0, 11], "x": 11, "y": 0},
+ {"matrix": [0, 12], "x": 12, "y": 0},
+ {"matrix": [0, 13], "x": 13, "y": 0},
+ {"matrix": [0, 14], "x": 14, "y": 0},
+ {"matrix": [0, 15], "x": 15.25, "y": 0},
+ {"matrix": [0, 16], "x": 16.25, "y": 0},
+ {"matrix": [0, 17], "x": 17.25, "y": 0},
+ {"matrix": [0, 18], "x": 18.5, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 15], "x": 15.5, "y": 1.25},
+ {"matrix": [1, 16], "x": 16.5, "y": 1.25},
+ {"matrix": [1, 17], "x": 17.5, "y": 1.25},
+ {"matrix": [1, 18], "x": 18.5, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 15], "x": 15.5, "y": 2.25},
+ {"matrix": [2, 16], "x": 16.5, "y": 2.25},
+ {"matrix": [2, 17], "x": 17.5, "y": 2.25},
+ {"matrix": [3, 18], "x": 18.5, "y": 2.25, "h": 2},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25},
+ {"matrix": [2, 13], "x": 13.75, "y": 2.25, "w": 1.25, "h": 2},
+ {"matrix": [3, 15], "x": 15.5, "y": 3.25},
+ {"matrix": [3, 16], "x": 16.5, "y": 3.25},
+ {"matrix": [3, 17], "x": 17.5, "y": 3.25},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4.25, "w": 1.75},
+ {"matrix": [4, 14], "x": 14.25, "y": 4.5},
+ {"matrix": [4, 15], "x": 15.5, "y": 4.25},
+ {"matrix": [4, 16], "x": 16.5, "y": 4.25},
+ {"matrix": [4, 17], "x": 17.5, "y": 4.25},
+ {"matrix": [4, 18], "x": 18.5, "y": 4.25, "h": 2},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25},
+ {"matrix": [5, 11], "x": 11, "y": 5.25},
+ {"matrix": [5, 12], "x": 12, "y": 5.25},
+ {"matrix": [5, 13], "x": 13.25, "y": 5.5},
+ {"matrix": [5, 14], "x": 14.25, "y": 5.5},
+ {"matrix": [5, 15], "x": 15.25, "y": 5.5},
+ {"matrix": [5, 16], "x": 16.5, "y": 5.25},
+ {"matrix": [5, 17], "x": 17.5, "y": 5.25}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v5_max/iso_encoder/keymaps/default/keymap.c b/keyboards/keychron/v5_max/iso_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..8a1beda5b9
--- /dev/null
+++ b/keyboards/keychron/v5_max/iso_encoder/keymaps/default/keymap.c
@@ -0,0 +1,76 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_99(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_DEL, KC_HOME, KC_END, KC_MUTE,
+ 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_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+
+ [MAC_FN] = LAYOUT_iso_99(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+
+ [WIN_BASE] = LAYOUT_iso_99(
+ 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_DEL, KC_HOME, KC_END, KC_MUTE,
+ 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_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_P7, KC_P8, KC_P9, KC_PPLS,
+ 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_P4, KC_P5, KC_P6,
+ 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_P1, KC_P2, KC_P3, KC_PENT,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT ),
+
+ [WIN_FN] = LAYOUT_iso_99(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, _______, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ ),
+ };
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v5_max/iso_encoder/rules.mk b/keyboards/keychron/v5_max/iso_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v5_max/iso_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v5_max/mcuconf.h b/keyboards/keychron/v5_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/v5_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/v5_max/readme.md b/keyboards/keychron/v5_max/readme.md
new file mode 100644
index 0000000000..e33116545f
--- /dev/null
+++ b/keyboards/keychron/v5_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron V5 Max
+
+
+
+A customizable 96% keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron V5 Max
+* Hardware Availability: [Keychron V5 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-v5-max-qmk-via-wireless-custom-mechanical-keyboard?variant=40759400005721)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/v5_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/v5_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/v5_max/rules.mk b/keyboards/keychron/v5_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/v5_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/v5_max/v5_max.c b/keyboards/keychron/v5_max/v5_max.c
new file mode 100644
index 0000000000..d32c5be2e8
--- /dev/null
+++ b/keyboards/keychron/v5_max/v5_max.c
@@ -0,0 +1,84 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 2));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ } else {
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/v5_max/via_json/v5_ansi_encoder.json b/keyboards/keychron/v5_max/via_json/v5_ansi_encoder.json
new file mode 100644
index 0000000000..7e73a1616b
--- /dev/null
+++ b/keyboards/keychron/v5_max/via_json/v5_ansi_encoder.json
@@ -0,0 +1,321 @@
+{
+ "name": "Keychron V5 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0950",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 19},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ "0, 10",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ "0, 14",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 15",
+ "0, 16",
+ "0, 17",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 18\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.5
+ },
+ "1, 15",
+ "1, 16",
+ "1, 17",
+ "1, 18"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 13",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "2, 15",
+ "2, 16",
+ "2, 17",
+ {
+ "h": 2,
+ "c": "#aaaaaa"
+ },
+ "3, 18"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "3, 12",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "3, 15",
+ "3, 16",
+ "3, 17"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 12",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "4, 14",
+ {
+ "x": 0.25,
+ "y": -0.25
+ },
+ "4, 15",
+ "4, 16",
+ "4, 17",
+ {
+ "h": 2,
+ "c": "#aaaaaa"
+ },
+ "4, 18"
+ ],
+ [
+ { "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15",
+ {
+ "x": 0.25,
+ "y": -0.25
+ },
+ "5, 16",
+ "5, 17"
+ ]
+ ]
+ }
+
+}
diff --git a/keyboards/keychron/v5_max/via_json/v5_iso_encoder.json b/keyboards/keychron/v5_max/via_json/v5_iso_encoder.json
new file mode 100644
index 0000000000..1d629bf581
--- /dev/null
+++ b/keyboards/keychron/v5_max/via_json/v5_iso_encoder.json
@@ -0,0 +1,323 @@
+{
+ "name": "Keychron V5 Max ISO Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0951",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 19},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 1,
+ "c": "#cccccc"
+ },
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ "0, 5",
+ {
+ "x": 0.5,
+ "c": "#aaaaaa"
+ },
+ "0, 7",
+ "0, 8",
+ "0, 9",
+ "0, 10",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "0, 11",
+ "0, 12",
+ "0, 13",
+ "0, 14",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 15",
+ "0, 16",
+ "0, 17",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 18\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 0",
+ {
+ "c": "#cccccc"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#aaaaaa"
+ },
+ "1, 13",
+ {
+ "x": 0.5
+ },
+ "1, 15",
+ "1, 16",
+ "1, 17",
+ "1, 18"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#aaaaaa"
+ },
+ "2, 0",
+ {
+ "c": "#cccccc"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "x": 0.25,
+ "w": 1.25,
+ "h": 2,
+ "x2": -0.25,
+ "w2": 1.5,
+ "h2": 1,
+ "c": "#777777"
+ },
+ "2, 13",
+ {
+ "x": 0.5,
+ "c": "#cccccc"
+ },
+ "2, 15",
+ "2, 16",
+ "2, 17",
+ {
+ "h": 2,
+ "c": "#aaaaaa"
+ },
+ "3, 18"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "3, 0",
+ {
+ "c": "#cccccc"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ "3, 12",
+ {
+ "x": 1.75,
+ "c": "#cccccc"
+ },
+ "3, 15",
+ "3, 16",
+ "3, 17"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 0",
+ {
+ "c": "#cccccc"
+ },
+ "4, 1",
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 1.75,
+ "c": "#aaaaaa"
+ },
+ "4, 12",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "4, 14",
+ {
+ "x": 0.25,
+ "y": -0.25
+ },
+ "4, 15",
+ "4, 16",
+ "4, 17",
+ {
+ "h": 2,
+ "c": "#aaaaaa"
+ },
+ "4, 18"
+ ],
+ [
+ { "w": 1.25,
+ "c": "#aaaaaa"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#cccccc"
+ },
+ "5, 6",
+ {
+ "c": "#aaaaaa"
+ },
+ "5, 10",
+ "5, 11",
+ "5, 12",
+ {
+ "x": 0.25,
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "5, 13",
+ "5, 14",
+ "5, 15",
+ {
+ "x": 0.25,
+ "y": -0.25
+ },
+ "5, 16",
+ "5, 17"
+ ]
+ ]
+ }
+
+}
diff --git a/keyboards/keychron/v6_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/v6_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..7b1c61cf12
--- /dev/null
+++ b/keyboards/keychron/v6_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,175 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+ {1, CB10_CA10, CB12_CA10, CB11_CA10},
+ {1, CB10_CA11, CB12_CA11, CB11_CA11},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA8, CB6_CA8, CB5_CA8},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB10_CA5, CB12_CA5, CB11_CA5},
+ {1, CB10_CA6, CB12_CA6, CB11_CA6},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, 14, 15, 16, 17, 18, 19 },
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40 },
+ { 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, __ },
+ { 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, __, __, __, 74, 75, 76, 77 },
+ { 78, __, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, __, __, 90, __, 91, 92, 93, __ },
+ { 94, 95, 96, __, __, __, 97, __, __, __, 98, 99, 100, 101, 102, 103, 104, 105, __, 106, 107 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {13, 0}, {24, 0}, {34, 0}, {45, 0}, {57, 0}, {68, 0}, {78, 0}, {89, 0}, {102, 0}, {112, 0}, {123, 0}, {133, 0}, {159, 0}, {169, 0}, {180, 0}, {193, 0}, {203, 0}, {214, 0}, {224, 0},
+ {0,15}, {10,15}, {21,15}, {31,15}, {42,15}, {52,15}, {63,15}, {73,15}, {83,15}, { 94,15}, {104,15}, {115,15}, {125,15}, {141,15}, {159,15}, {169,15}, {180,15}, {193,15}, {203,15}, {214,15}, {224,15},
+ {3,27}, {16,27}, {26,27}, {36,27}, {47,27}, {57,27}, {68,27}, {78,27}, {89,27}, { 99,27}, {109,27}, {120,27}, {130,27}, {143,27}, {159,27}, {169,27}, {180,27}, {193,27}, {203,27}, {214,27},
+ {4,40}, {18,40}, {29,40}, {39,40}, {50,40}, {60,40}, {70,40}, {81,40}, {91,40}, {102,40}, {112,40}, {123,40}, {139,40}, {193,40}, {203,40}, {214,40}, {224,34},
+ {7,52}, {23,52}, {34,52}, {44,52}, {55,52}, {65,52}, {76,52}, {86,52}, { 96,52}, {107,52}, {117,52}, {137,52}, {169,52}, {193,52}, {203,52}, {214,52},
+ {1,64}, {14,64}, {27,64}, {66,64}, {105,64}, {119,64}, {132,64}, {145,64}, {159,64}, {169,64}, {180,64}, {198,64}, {214,64}, {224,58}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/v6_max/ansi_encoder/config.h b/keyboards/keychron/v6_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..9528b8a672
--- /dev/null
+++ b/keyboards/keychron/v6_max/ansi_encoder/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 108
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define NUM_LOCK_INDEX 37
+# define CAPS_LOCK_INDEX 61
+# define LOW_BAT_IND_INDEX \
+ { 97 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v6_max/ansi_encoder/keyboard.json b/keyboards/keychron/v6_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..0251b79747
--- /dev/null
+++ b/keyboards/keychron/v6_max/ansi_encoder/keyboard.json
@@ -0,0 +1,126 @@
+{
+ "usb": {
+ "pid": "0x0960",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_109": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+ {"matrix": [0, 15], "x": 16.25, "y": 0},
+ {"matrix": [0, 16], "x": 17.25, "y": 0},
+ {"matrix": [0, 17], "x": 18.5, "y": 0},
+ {"matrix": [0, 18], "x": 19.5, "y": 0},
+ {"matrix": [0, 19], "x": 20.5, "y": 0},
+ {"matrix": [0, 20], "x": 21.5, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 15], "x": 16.25, "y": 1.25},
+ {"matrix": [1, 16], "x": 17.25, "y": 1.25},
+ {"matrix": [1, 17], "x": 18.5, "y": 1.25},
+ {"matrix": [1, 18], "x": 19.5, "y": 1.25},
+ {"matrix": [1, 19], "x": 20.5, "y": 1.25},
+ {"matrix": [1, 20], "x": 21.5, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 13], "x": 13.5, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 16.25, "y": 2.25},
+ {"matrix": [2, 16], "x": 17.25, "y": 2.25},
+ {"matrix": [2, 17], "x": 18.5, "y": 2.25},
+ {"matrix": [2, 18], "x": 19.5, "y": 2.25},
+ {"matrix": [2, 19], "x": 20.5, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 17], "x": 18.5, "y": 3.25},
+ {"matrix": [3, 18], "x": 19.5, "y": 3.25},
+ {"matrix": [3, 19], "x": 20.5, "y": 3.25},
+ {"matrix": [3, 20], "x": 21.5, "y": 2.25, "h": 2},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4.25, "w": 2.75},
+ {"matrix": [4, 15], "x": 16.25, "y": 4.25},
+ {"matrix": [4, 17], "x": 18.5, "y": 4.25},
+ {"matrix": [4, 18], "x": 19.5, "y": 4.25},
+ {"matrix": [4, 19], "x": 20.5, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.25},
+ {"matrix": [5, 15], "x": 16.25, "y": 5.25},
+ {"matrix": [5, 16], "x": 17.25, "y": 5.25},
+ {"matrix": [5, 17], "x": 18.5, "y": 5.25, "w": 2},
+ {"matrix": [5, 19], "x": 20.5, "y": 5.25},
+ {"matrix": [5, 20], "x": 21.5, "y": 4.25, "h": 2}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v6_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/v6_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..4cbfe22427
--- /dev/null
+++ b/keyboards/keychron/v6_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,73 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_109(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_MUTE, KC_SNAP, KC_SIRI, RGB_MOD, KC_F13, KC_F14, KC_F15, KC_F16,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+ [MAC_FN] = LAYOUT_ansi_109(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, RGB_TOG, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+ [WIN_BASE] = LAYOUT_ansi_109(
+ 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_MUTE, KC_PSCR, KC_CTANA, RGB_MOD, _______, _______, _______, _______,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+ [WIN_FN] = LAYOUT_ansi_109(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, RGB_TOG, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v6_max/ansi_encoder/rules.mk b/keyboards/keychron/v6_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v6_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v6_max/board.h b/keyboards/keychron/v6_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/v6_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/v6_max/config.h b/keyboards/keychron/v6_max/config.h
new file mode 100644
index 0000000000..a12af92be8
--- /dev/null
+++ b/keyboards/keychron/v6_max/config.h
@@ -0,0 +1,83 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A9
+# define BT_MODE_SELECT_PIN A10
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+
+# define P24G_INDICATION_LED_MATRIX_INDEX 24
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 21, 22, 23 }
+# define BAT_LEVEL_LED_LIST \
+ { 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 }
+
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_1 MO(1)
+#define FN_KEY_2 MO(3)
+
+#define P2P4G_CELAR_MASK 0
+
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/v6_max/halconf.h b/keyboards/keychron/v6_max/halconf.h
new file mode 100644
index 0000000000..0545256c5e
--- /dev/null
+++ b/keyboards/keychron/v6_max/halconf.h
@@ -0,0 +1,31 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/v6_max/info.json b/keyboards/keychron/v6_max/info.json
new file mode 100644
index 0000000000..4368611e35
--- /dev/null
+++ b/keyboards/keychron/v6_max/info.json
@@ -0,0 +1,77 @@
+{
+ "keyboard_name": "Keychron V6 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "lokher",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "nkro" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1", "A2", "A3", "C5", "B10", "C9"],
+ "rows": ["C12", "D2", "B3", "B4", "B5", "B6"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch" :{
+ "pins": ["A8"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/v6_max/iso_encoder/config.h b/keyboards/keychron/v6_max/iso_encoder/config.h
new file mode 100644
index 0000000000..48c394c420
--- /dev/null
+++ b/keyboards/keychron/v6_max/iso_encoder/config.h
@@ -0,0 +1,46 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 109
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28, 0x28 }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indications */
+# define NUM_LOCK_INDEX 37
+# define CAPS_LOCK_INDEX 61
+# define LOW_BAT_IND_INDEX \
+ { 98 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v6_max/iso_encoder/iso_encoder.c b/keyboards/keychron/v6_max/iso_encoder/iso_encoder.c
new file mode 100644
index 0000000000..3320dd5865
--- /dev/null
+++ b/keyboards/keychron/v6_max/iso_encoder/iso_encoder.c
@@ -0,0 +1,176 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+ {0, CB7_CA14, CB9_CA14, CB8_CA14},
+ {0, CB10_CA16, CB12_CA16, CB11_CA16},
+ {0, CB10_CA15, CB12_CA15, CB11_CA15},
+ {0, CB10_CA14, CB12_CA14, CB11_CA14},
+ {0, CB10_CA13, CB12_CA13, CB11_CA13},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA7, CB6_CA7, CB5_CA7},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+ {0, CB10_CA12, CB12_CA12, CB11_CA12},
+ {0, CB10_CA11, CB12_CA11, CB11_CA11},
+ {0, CB10_CA10, CB12_CA10, CB11_CA10},
+ {0, CB10_CA9, CB12_CA9, CB11_CA9},
+ {0, CB10_CA8, CB12_CA8, CB11_CA8},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA7, CB3_CA7, CB2_CA7},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA14, CB3_CA14, CB2_CA14},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+ {0, CB10_CA7, CB12_CA7, CB11_CA7},
+ {0, CB10_CA6, CB12_CA6, CB11_CA6},
+ {0, CB10_CA5, CB12_CA5, CB11_CA5},
+ {0, CB10_CA4, CB12_CA4, CB11_CA4},
+
+ {1, CB7_CA16, CB9_CA16, CB8_CA16},
+ {1, CB7_CA15, CB9_CA15, CB8_CA15},
+ {1, CB7_CA14, CB9_CA14, CB8_CA14},
+ {1, CB7_CA13, CB9_CA13, CB8_CA13},
+ {1, CB7_CA12, CB9_CA12, CB8_CA12},
+ {1, CB7_CA11, CB9_CA11, CB8_CA11},
+ {1, CB7_CA10, CB9_CA10, CB8_CA10},
+ {1, CB7_CA9, CB9_CA9, CB8_CA9},
+ {1, CB7_CA8, CB9_CA8, CB8_CA8},
+ {1, CB7_CA7, CB9_CA7, CB8_CA7},
+ {1, CB7_CA6, CB9_CA6, CB8_CA6},
+ {1, CB7_CA5, CB9_CA5, CB8_CA5},
+ {1, CB7_CA4, CB9_CA4, CB8_CA4},
+ {1, CB10_CA8, CB12_CA8, CB11_CA8},
+ {1, CB10_CA9, CB12_CA9, CB11_CA9},
+ {1, CB10_CA10, CB12_CA10, CB11_CA10},
+ {1, CB10_CA11, CB12_CA11, CB11_CA11},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA15, CB6_CA15, CB5_CA15},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA8, CB6_CA8, CB5_CA8},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA1, CB6_CA1, CB5_CA1},
+ {1, CB10_CA5, CB12_CA5, CB11_CA5},
+ {1, CB10_CA6, CB12_CA6, CB11_CA6},
+ {1, CB10_CA7, CB12_CA7, CB11_CA7},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA14, CB3_CA14, CB2_CA14},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA6, CB3_CA6, CB2_CA6},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA4, CB3_CA4, CB2_CA4},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+ {1, CB10_CA1, CB12_CA1, CB11_CA1},
+ {1, CB10_CA2, CB12_CA2, CB11_CA2},
+ {1, CB10_CA3, CB12_CA3, CB11_CA3},
+ {1, CB10_CA4, CB12_CA4, CB11_CA4},
+};
+
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, 14, 15, 16, 17, 18, 19 },
+ { 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40 },
+ { 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, __ },
+ { 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, __, __, __, __, 74, 75, 76, 77 },
+ { 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, __, __, 91, __, 92, 93, 94, __ },
+ { 95, 96, 97, __, __, __, 98, __, __, __, 99, 100, 101, 102, 103, 104, 105, 106, __, 107, 108 },
+ },
+ {
+ // LED Index to Physical Position
+ {0, 0}, {13, 0}, {24, 0}, {34, 0}, {45, 0}, {57, 0}, {68, 0}, {78, 0}, {89, 0}, {102, 0}, {112, 0}, {123, 0}, {133, 0}, {159, 0}, {169, 0}, {180, 0}, {193, 0}, {203, 0}, {214, 0}, {224, 0},
+ {0,15}, {10,15}, {21,15}, {31,15}, {42,15}, {52,15}, {63,15}, {73,15}, {83,15}, { 94,15}, {104,15}, {115,15}, {125,15}, {141,15}, {159,15}, {169,15}, {180,15}, {193,15}, {203,15}, {214,15}, {224,15},
+ {3,27}, {16,27}, {26,27}, {36,27}, {47,27}, {57,27}, {68,27}, {78,27}, {89,27}, { 99,27}, {109,27}, {120,27}, {130,27}, {145,34}, {159,27}, {169,27}, {180,27}, {193,27}, {203,27}, {214,27},
+ {4,40}, {18,40}, {29,40}, {39,40}, {50,40}, {60,40}, {70,40}, {81,40}, {91,40}, {102,40}, {112,40}, {123,40}, {133,40}, {193,40}, {203,40}, {214,40}, {224,34},
+ {1,52}, {13,52}, {23,52}, {34,52}, {44,52}, {55,52}, {65,52}, {76,52}, {86,52}, { 96,52}, {107,52}, {117,52}, {137,52}, {169,52}, {193,52}, {203,52}, {214,52},
+ {1,64}, {14,64}, {27,64}, {66,64}, {105,64}, {119,64}, {132,64}, {145,64}, {159,64}, {169,64}, {180,64}, {198,64}, {214,64}, {224,58}
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+ }
+};
+#endif
diff --git a/keyboards/keychron/v6_max/iso_encoder/keyboard.json b/keyboards/keychron/v6_max/iso_encoder/keyboard.json
new file mode 100644
index 0000000000..43c06b817e
--- /dev/null
+++ b/keyboards/keychron/v6_max/iso_encoder/keyboard.json
@@ -0,0 +1,127 @@
+{
+ "usb": {
+ "pid": "0x0961",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_iso_110": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0, "y": 0},
+ {"matrix": [0, 1], "x": 1.25, "y": 0},
+ {"matrix": [0, 2], "x": 2.25, "y": 0},
+ {"matrix": [0, 3], "x": 3.25, "y": 0},
+ {"matrix": [0, 4], "x": 4.25, "y": 0},
+ {"matrix": [0, 5], "x": 5.5, "y": 0},
+ {"matrix": [0, 6], "x": 6.5, "y": 0},
+ {"matrix": [0, 7], "x": 7.5, "y": 0},
+ {"matrix": [0, 8], "x": 8.5, "y": 0},
+ {"matrix": [0, 9], "x": 9.75, "y": 0},
+ {"matrix": [0, 10], "x": 10.75, "y": 0},
+ {"matrix": [0, 11], "x": 11.75, "y": 0},
+ {"matrix": [0, 12], "x": 12.75, "y": 0},
+ {"matrix": [0, 13], "x": 14, "y": 0},
+ {"matrix": [0, 14], "x": 15.25, "y": 0},
+ {"matrix": [0, 15], "x": 16.25, "y": 0},
+ {"matrix": [0, 16], "x": 17.25, "y": 0},
+ {"matrix": [0, 17], "x": 18.5, "y": 0},
+ {"matrix": [0, 18], "x": 19.5, "y": 0},
+ {"matrix": [0, 19], "x": 20.5, "y": 0},
+ {"matrix": [0, 20], "x": 21.5, "y": 0},
+
+ {"matrix": [1, 0], "x": 0, "y": 1.25},
+ {"matrix": [1, 1], "x": 1, "y": 1.25},
+ {"matrix": [1, 2], "x": 2, "y": 1.25},
+ {"matrix": [1, 3], "x": 3, "y": 1.25},
+ {"matrix": [1, 4], "x": 4, "y": 1.25},
+ {"matrix": [1, 5], "x": 5, "y": 1.25},
+ {"matrix": [1, 6], "x": 6, "y": 1.25},
+ {"matrix": [1, 7], "x": 7, "y": 1.25},
+ {"matrix": [1, 8], "x": 8, "y": 1.25},
+ {"matrix": [1, 9], "x": 9, "y": 1.25},
+ {"matrix": [1, 10], "x": 10, "y": 1.25},
+ {"matrix": [1, 11], "x": 11, "y": 1.25},
+ {"matrix": [1, 12], "x": 12, "y": 1.25},
+ {"matrix": [1, 13], "x": 13, "y": 1.25, "w": 2},
+ {"matrix": [1, 14], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 15], "x": 16.25, "y": 1.25},
+ {"matrix": [1, 16], "x": 17.25, "y": 1.25},
+ {"matrix": [1, 17], "x": 18.5, "y": 1.25},
+ {"matrix": [1, 18], "x": 19.5, "y": 1.25},
+ {"matrix": [1, 19], "x": 20.5, "y": 1.25},
+ {"matrix": [1, 20], "x": 21.5, "y": 1.25},
+
+ {"matrix": [2, 0], "x": 0, "y": 2.25, "w": 1.5},
+ {"matrix": [2, 1], "x": 1.5, "y": 2.25},
+ {"matrix": [2, 2], "x": 2.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 6], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 7.5, "y": 2.25},
+ {"matrix": [2, 8], "x": 8.5, "y": 2.25},
+ {"matrix": [2, 9], "x": 9.5, "y": 2.25},
+ {"matrix": [2, 10], "x": 10.5, "y": 2.25},
+ {"matrix": [2, 11], "x": 11.5, "y": 2.25},
+ {"matrix": [2, 12], "x": 12.5, "y": 2.25},
+ {"matrix": [2, 14], "x": 15.25, "y": 2.25},
+ {"matrix": [2, 15], "x": 16.25, "y": 2.25},
+ {"matrix": [2, 16], "x": 17.25, "y": 2.25},
+ {"matrix": [2, 17], "x": 18.5, "y": 2.25},
+ {"matrix": [2, 18], "x": 19.5, "y": 2.25},
+ {"matrix": [2, 19], "x": 20.5, "y": 2.25},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 1], "x": 1.75, "y": 3.25},
+ {"matrix": [3, 2], "x": 2.75, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 7.75, "y": 3.25},
+ {"matrix": [3, 8], "x": 8.75, "y": 3.25},
+ {"matrix": [3, 9], "x": 9.75, "y": 3.25},
+ {"matrix": [3, 10], "x": 10.75, "y": 3.25},
+ {"matrix": [3, 11], "x": 11.75, "y": 3.25},
+ {"matrix": [3, 12], "x": 12.75, "y": 3.25},
+ {"matrix": [2, 13], "x": 13.25, "y": 2.75, "h": 2},
+ {"matrix": [3, 17], "x": 18.5, "y": 3.25},
+ {"matrix": [3, 18], "x": 19.5, "y": 3.25},
+ {"matrix": [3, 19], "x": 20.5, "y": 3.25},
+ {"matrix": [3, 20], "x": 21.5, "y": 2.25, "h": 2},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25},
+ {"matrix": [4, 2], "x": 2.25, "y": 4.25},
+ {"matrix": [4, 3], "x": 3.25, "y": 4.25},
+ {"matrix": [4, 4], "x": 4.25, "y": 4.25},
+ {"matrix": [4, 5], "x": 5.25, "y": 4.25},
+ {"matrix": [4, 6], "x": 6.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 8], "x": 8.25, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.25, "y": 4.25},
+ {"matrix": [4, 10], "x": 10.25, "y": 4.25},
+ {"matrix": [4, 11], "x": 11.25, "y": 4.25},
+ {"matrix": [4, 12], "x": 12.25, "y": 4.25, "w": 2.75},
+ {"matrix": [4, 15], "x": 16.25, "y": 4.25},
+ {"matrix": [4, 17], "x": 18.5, "y": 4.25},
+ {"matrix": [4, 18], "x": 19.5, "y": 4.25},
+ {"matrix": [4, 19], "x": 20.5, "y": 4.25},
+
+ {"matrix": [5, 0], "x": 0, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 1], "x": 1.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 2], "x": 2.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 6], "x": 3.75, "y": 5.25, "w": 6.25},
+ {"matrix": [5, 10], "x": 10, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 11], "x": 11.25, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 12], "x": 12.5, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 13], "x": 13.75, "y": 5.25, "w": 1.25},
+ {"matrix": [5, 14], "x": 15.25, "y": 5.25},
+ {"matrix": [5, 15], "x": 16.25, "y": 5.25},
+ {"matrix": [5, 16], "x": 17.25, "y": 5.25},
+ {"matrix": [5, 17], "x": 18.5, "y": 5.25, "w": 2},
+ {"matrix": [5, 19], "x": 20.5, "y": 5.25},
+ {"matrix": [5, 20], "x": 21.5, "y": 4.25, "h": 2}
+ ]
+ }
+ }
+}
diff --git a/keyboards/keychron/v6_max/iso_encoder/keymaps/default/keymap.c b/keyboards/keychron/v6_max/iso_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..07bb6a70ae
--- /dev/null
+++ b/keyboards/keychron/v6_max/iso_encoder/keymaps/default/keymap.c
@@ -0,0 +1,73 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ MAC_FN,
+ WIN_BASE,
+ WIN_FN,
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_iso_110(
+ KC_ESC, KC_BRID, KC_BRIU, KC_MCTRL, KC_LNPAD, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, KC_MUTE, KC_SNAP, KC_SIRI, RGB_MOD, KC_F13, KC_F14, KC_F15, KC_F16,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, KC_RCMMD, KC_ROPTN, MO(MAC_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+ [MAC_FN] = LAYOUT_iso_110(
+ _______, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, RGB_TOG, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+ [WIN_BASE] = LAYOUT_iso_110(
+ 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_MUTE, KC_PSCR, KC_CTANA, RGB_MOD, _______, _______, _______, _______,
+ 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_INS, KC_HOME, KC_PGUP, KC_NUM, KC_PSLS, KC_PAST, KC_PMNS,
+ 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_DEL, KC_END, KC_PGDN, KC_P7, KC_P8, KC_P9,
+ 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_P4, KC_P5, KC_P6, KC_PPLS,
+ 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_P1, KC_P2, KC_P3,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, KC_RALT, KC_RWIN, MO(WIN_FN), KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT, KC_P0, KC_PDOT, KC_PENT),
+ [WIN_FN] = LAYOUT_iso_110(
+ _______, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, RGB_TOG, _______, _______, RGB_TOG, _______, _______, _______, _______,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUI, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUD, RGB_SAD, RGB_SPD, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, BAT_LVL, NK_TOGG, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______)
+};
+
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_FN] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+// clang-format on
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v6_max/iso_encoder/rules.mk b/keyboards/keychron/v6_max/iso_encoder/rules.mk
new file mode 100644
index 0000000000..7ff128fa69
--- /dev/null
+++ b/keyboards/keychron/v6_max/iso_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
\ No newline at end of file
diff --git a/keyboards/keychron/v6_max/mcuconf.h b/keyboards/keychron/v6_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/v6_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/v6_max/readme.md b/keyboards/keychron/v6_max/readme.md
new file mode 100644
index 0000000000..5b1c8d6cbd
--- /dev/null
+++ b/keyboards/keychron/v6_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron V6 Max
+
+
+
+A customizable full-size 100% wireless keyboard.
+
+* Keyboard Maintainer: [Keychron](https://github.com/keychron)
+* Hardware Supported: Keychron V6 Max
+* Hardware Availability: [Keychron V6 Max QMK/VIA Wireless Custom Mechanical Keyboard](https://www.keychron.com/products/keychron-v6-max-qmk-via-wireless-custom-mechanical-keyboard)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/v6_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/v6_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/v6_max/rules.mk b/keyboards/keychron/v6_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/v6_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/v6_max/v6_max.c b/keyboards/keychron/v6_max/v6_max.c
new file mode 100644
index 0000000000..61bc1ca355
--- /dev/null
+++ b/keyboards/keychron/v6_max/v6_max.c
@@ -0,0 +1,84 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 2 : 0));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ } else {
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/v6_max/via_json/v6_max_ansi_encoder.json b/keyboards/keychron/v6_max/via_json/v6_max_ansi_encoder.json
new file mode 100644
index 0000000000..c699330bdf
--- /dev/null
+++ b/keyboards/keychron/v6_max/via_json/v6_max_ansi_encoder.json
@@ -0,0 +1,349 @@
+{
+ "name": "Keychron V6 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0960",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 6, "cols" : 21},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "c": "#777777"
+ },
+ "0, 0",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 1",
+ "0, 2",
+ "0, 3",
+ "0, 4",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 5",
+ "0, 6",
+ "0, 7",
+ "0, 8",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 9",
+ "0, 10",
+ "0, 11",
+ "0, 12",
+ {
+ "x": 0.25,
+ "c": "#cccccc"
+ },
+ "0, 13\n\n\n\n\n\n\n\n\ne0",
+ {
+ "x": 0.25
+ },
+ "0, 14",
+ "0, 15",
+ "0, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "0, 17",
+ "0, 18",
+ "0, 19",
+ "0, 20"
+ ],
+ [
+ {
+ "y": 0.25,
+ "c": "#cccccc"
+ },
+ "1, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "1, 1",
+ "1, 2",
+ "1, 3",
+ "1, 4",
+ "1, 5",
+ "1, 6",
+ "1, 7",
+ "1, 8",
+ "1, 9",
+ "1, 10",
+ "1, 11",
+ "1, 12",
+ {
+ "w": 2,
+ "c": "#cccccc"
+ },
+ "1, 13",
+ {
+ "x": 0.25
+ },
+ "1, 14",
+ "1, 15",
+ "1, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "1, 17",
+ "1, 18",
+ "1, 19",
+ "1, 20"
+ ],
+ [
+ {
+ "w": 1.5,
+ "c": "#cccccc"
+ },
+ "2, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "2, 1",
+ "2, 2",
+ "2, 3",
+ "2, 4",
+ "2, 5",
+ "2, 6",
+ "2, 7",
+ "2, 8",
+ "2, 9",
+ "2, 10",
+ "2, 11",
+ "2, 12",
+ {
+ "w": 1.5,
+ "c": "#cccccc"
+ },
+ "2, 13",
+ {
+ "x": 0.25
+ },
+ "2, 14",
+ "2, 15",
+ "2, 16",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "2, 17",
+ "2, 18",
+ "2, 19",
+ {
+ "h": 2,
+ "c": "#aaaaaa"
+ },
+ "3, 20"
+ ],
+ [
+ {
+ "w": 1.75,
+ "c": "#cccccc"
+ },
+ "3, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "3, 1",
+ "3, 2",
+ "3, 3",
+ "3, 4",
+ "3, 5",
+ "3, 6",
+ "3, 7",
+ "3, 8",
+ "3, 9",
+ "3, 10",
+ "3, 11",
+ {
+ "w": 2.25,
+ "c": "#777777"
+ },
+ "3, 12",
+ {
+ "x": 3.5,
+ "c": "#aaaaaa"
+ },
+ "3, 17",
+ "3, 18",
+ "3, 19"
+ ],
+ [
+ {
+ "w": 2.25,
+ "c": "#cccccc"
+ },
+ "4, 0",
+ {
+ "c": "#aaaaaa"
+ },
+ "4, 2",
+ "4, 3",
+ "4, 4",
+ "4, 5",
+ "4, 6",
+ "4, 7",
+ "4, 8",
+ "4, 9",
+ "4, 10",
+ "4, 11",
+ {
+ "w": 2.75,
+ "c": "#cccccc"
+ },
+ "4, 13",
+ {
+ "x": 1.25,
+ "c": "#aaaaaa"
+ },
+ "4, 15",
+ {
+ "x": 1.25
+ },
+ "4, 17",
+ "4, 18",
+ "4, 19",
+ {
+ "h": 2
+ },
+ "5, 20"
+ ],
+ [
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 0",
+ {
+ "w": 1.25
+ },
+ "5, 1",
+ {
+ "w": 1.25
+ },
+ "5, 2",
+ {
+ "w": 6.25,
+ "c": "#aaaaaa"
+ },
+ "5, 6",
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 10",
+ {
+ "w": 1.25
+ },
+ "5, 11",
+ {
+ "w": 1.25,
+ "c": "#cccccc"
+ },
+ "5, 12",
+ {
+ "w": 1.25
+ },
+ "5, 13",
+ {
+ "x": 0.25,
+ "c": "#aaaaaa"
+ },
+ "5, 14",
+ "5, 15",
+ "5, 16",
+ {
+ "x": 0.25,
+ "w": 2
+ },
+ "5, 18",
+ "5, 19"
+ ]
+ ]
+ }
+ }
diff --git a/keyboards/keychron/v8_max/ansi_encoder/ansi_encoder.c b/keyboards/keychron/v8_max/ansi_encoder/ansi_encoder.c
new file mode 100644
index 0000000000..6427a92a76
--- /dev/null
+++ b/keyboards/keychron/v8_max/ansi_encoder/ansi_encoder.c
@@ -0,0 +1,131 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include "quantum.h"
+
+// clang-format off
+
+#ifdef RGB_MATRIX_ENABLE
+const snled27351_led_t g_snled27351_leds[RGB_MATRIX_LED_COUNT] = {
+/* Refer to SNLED27351 manual for these locations
+ * driver
+ * | R location
+ * | | G location
+ * | | | B location
+ * | | | | */
+ {0, CB7_CA1, CB9_CA1, CB8_CA1},
+ {0, CB7_CA2, CB9_CA2, CB8_CA2},
+ {0, CB7_CA3, CB9_CA3, CB8_CA3},
+ {0, CB7_CA4, CB9_CA4, CB8_CA4},
+ {0, CB7_CA5, CB9_CA5, CB8_CA5},
+ {0, CB7_CA6, CB9_CA6, CB8_CA6},
+ {0, CB7_CA7, CB9_CA7, CB8_CA7},
+ {0, CB7_CA8, CB9_CA8, CB8_CA8},
+ {0, CB7_CA9, CB9_CA9, CB8_CA9},
+ {0, CB7_CA10, CB9_CA10, CB8_CA10},
+ {0, CB7_CA11, CB9_CA11, CB8_CA11},
+ {0, CB7_CA12, CB9_CA12, CB8_CA12},
+ {0, CB7_CA13, CB9_CA13, CB8_CA13},
+ {0, CB7_CA15, CB9_CA15, CB8_CA15},
+ {0, CB7_CA16, CB9_CA16, CB8_CA16},
+
+ {0, CB4_CA1, CB6_CA1, CB5_CA1},
+ {0, CB4_CA2, CB6_CA2, CB5_CA2},
+ {0, CB4_CA3, CB6_CA3, CB5_CA3},
+ {0, CB4_CA4, CB6_CA4, CB5_CA4},
+ {0, CB4_CA5, CB6_CA5, CB5_CA5},
+ {0, CB4_CA6, CB6_CA6, CB5_CA6},
+ {0, CB4_CA8, CB6_CA8, CB5_CA8},
+ {0, CB4_CA9, CB6_CA9, CB5_CA9},
+ {0, CB4_CA10, CB6_CA10, CB5_CA10},
+ {0, CB4_CA11, CB6_CA11, CB5_CA11},
+ {0, CB4_CA12, CB6_CA12, CB5_CA12},
+ {0, CB4_CA13, CB6_CA13, CB5_CA13},
+ {0, CB4_CA14, CB6_CA14, CB5_CA14},
+ {0, CB4_CA15, CB6_CA15, CB5_CA15},
+ {0, CB4_CA16, CB6_CA16, CB5_CA16},
+
+ {0, CB1_CA1, CB3_CA1, CB2_CA1},
+ {0, CB1_CA2, CB3_CA2, CB2_CA2},
+ {0, CB1_CA3, CB3_CA3, CB2_CA3},
+ {0, CB1_CA4, CB3_CA4, CB2_CA4},
+ {0, CB1_CA5, CB3_CA5, CB2_CA5},
+ {0, CB1_CA6, CB3_CA6, CB2_CA6},
+ {0, CB1_CA8, CB3_CA8, CB2_CA8},
+ {0, CB1_CA9, CB3_CA9, CB2_CA9},
+ {0, CB1_CA10, CB3_CA10, CB2_CA10},
+ {0, CB1_CA11, CB3_CA11, CB2_CA11},
+ {0, CB1_CA12, CB3_CA12, CB2_CA12},
+ {0, CB1_CA13, CB3_CA13, CB2_CA13},
+ {0, CB1_CA15, CB3_CA15, CB2_CA15},
+ {0, CB1_CA16, CB3_CA16, CB2_CA16},
+
+ {1, CB4_CA16, CB6_CA16, CB5_CA16},
+ {1, CB4_CA14, CB6_CA14, CB5_CA14},
+ {1, CB4_CA13, CB6_CA13, CB5_CA13},
+ {1, CB4_CA12, CB6_CA12, CB5_CA12},
+ {1, CB4_CA11, CB6_CA11, CB5_CA11},
+ {1, CB4_CA10, CB6_CA10, CB5_CA10},
+ {1, CB4_CA9, CB6_CA9, CB5_CA9},
+ {1, CB4_CA8, CB6_CA8, CB5_CA8},
+ {1, CB4_CA7, CB6_CA7, CB5_CA7},
+ {1, CB4_CA6, CB6_CA6, CB5_CA6},
+ {1, CB4_CA5, CB6_CA5, CB5_CA5},
+ {1, CB4_CA4, CB6_CA4, CB5_CA4},
+ {1, CB4_CA3, CB6_CA3, CB5_CA3},
+ {1, CB4_CA2, CB6_CA2, CB5_CA2},
+
+ {1, CB1_CA16, CB3_CA16, CB2_CA16},
+ {1, CB1_CA15, CB3_CA15, CB2_CA15},
+ {1, CB1_CA13, CB3_CA13, CB2_CA13},
+ {1, CB1_CA11, CB3_CA11, CB2_CA11},
+ {1, CB1_CA10, CB3_CA10, CB2_CA10},
+ {1, CB1_CA9, CB3_CA9, CB2_CA9},
+ {1, CB1_CA7, CB3_CA7, CB2_CA7},
+ {1, CB1_CA5, CB3_CA5, CB2_CA5},
+ {1, CB1_CA3, CB3_CA3, CB2_CA3},
+ {1, CB1_CA2, CB3_CA2, CB2_CA2},
+ {1, CB1_CA1, CB3_CA1, CB2_CA1},
+};
+#define __ NO_LED
+
+led_config_t g_led_config = {
+ {
+ // Key Matrix to LED Index
+ { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, __, 13, __, 14},
+ { 15, 16, 17, 18, 19, 20, __, 21, 22, 23, 24, 25, 26, 27, 28, __, 29},
+ { 30, 31, 32, 33, 34, 35, __, 36, 37, 38, 39, 40, 41, __, 42, __, 43},
+ { 44, __, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, __, 57, __},
+ { 58, 59, __, 60, __, 61, 62, 63, __, 64, __, 65, __, __, 66, 67, 68},
+ },
+ {
+ // LED Index to Physical Position
+ {7,1}, {20,1}, {33,0}, {48,3}, {61,6}, {74,8 }, {87,11}, {106,11}, {119,8}, {132,6}, {145,3}, {160,0}, {173,1}, {193,1}, {220,0},
+ {7,14}, {24,14}, {39,14}, {52,17}, {65,20}, {78,22}, {103,25}, {116,22}, {129,20}, {142,17}, {155,14}, {170,14}, {183,14}, {200,14}, {222,16},
+ {6,27}, {24,27}, {39,28}, {52,30}, {65,33}, {78,36}, {109,37}, {122,34}, {135,32}, {148,29}, {162,27}, {176,27}, {197,27}, {224,29},
+ {7,40}, {28,40}, {43,42}, {56,44}, {69,47}, {82,50}, {102,52}, {115,49}, {128,46}, {141,44}, {154,41}, {169,40}, {187,40}, {209,43},
+ {0,53}, {17,53}, {42,55}, {65,60}, {86,64}, {107,64}, {131,59}, {156,54}, {196,56}, {209,56}, {222,56},
+ },
+ {
+ // RGB LED Index to Flag
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 1,
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1,
+ 8, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 1,
+ 1, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 1, 1,
+ 1, 1, 1, 4, 1, 1, 4, 1, 1, 1, 1,
+ }
+};
+#endif
diff --git a/keyboards/keychron/v8_max/ansi_encoder/config.h b/keyboards/keychron/v8_max/ansi_encoder/config.h
new file mode 100644
index 0000000000..15fe6112ae
--- /dev/null
+++ b/keyboards/keychron/v8_max/ansi_encoder/config.h
@@ -0,0 +1,52 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#ifdef RGB_MATRIX_ENABLE
+/* RGB Matrix driver configuration */
+# define RGB_MATRIX_LED_COUNT 69
+# define DRIVER_CS_PINS \
+ { B8, B9 }
+
+/* Scan phase of led driver */
+# define SNLED27351_PHASE_CHANNEL SNLED27351_SCAN_PHASE_9_CHANNEL
+/* Set LED driver current */
+# define SNLED27351_CURRENT_TUNE \
+ { 0x2c, 0x2c, 0x2c, 0x2c, 0x2c, 0x2c, 0x2c, 0x2c, 0x2c, 0x2c, 0x2c, 0x2c }
+
+/* Set to infinit, which is use in USB mode by default */
+# define RGB_MATRIX_TIMEOUT RGB_MATRIX_TIMEOUT_INFINITE
+/* Allow shutdown of led driver to save power */
+# define RGB_MATRIX_DRIVER_SHUTDOWN_ENABLE
+# define RGB_MATRIX_DRIVER_LOAD_ENABLE
+/* Turn off backlight on low brightness to save power */
+# define RGB_MATRIX_BRIGHTNESS_TURN_OFF_VAL 32
+
+/* Indicator */
+# define CAPS_LOCK_INDEX 30
+# define P24G_INDICATION_LED_MATRIX_INDEX 19
+# define BT_INDCATION_LED_MATRIX_LIST \
+ { 16, 17, 18 }
+# define BAT_LEVEL_LED_LIST \
+ { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
+# define LOW_BAT_IND_INDEX \
+ { 61, 64 }
+
+# define RGB_MATRIX_KEYPRESSES
+# define RGB_MATRIX_FRAMEBUFFER_EFFECTS
+
+#endif
diff --git a/keyboards/keychron/v8_max/ansi_encoder/keyboard.json b/keyboards/keychron/v8_max/ansi_encoder/keyboard.json
new file mode 100644
index 0000000000..79006ed359
--- /dev/null
+++ b/keyboards/keychron/v8_max/ansi_encoder/keyboard.json
@@ -0,0 +1,86 @@
+{
+ "usb": {
+ "pid": "0x0980",
+ "device_version": "1.0.0"
+ },
+ "layouts": {
+ "LAYOUT_ansi_69": {
+ "layout": [
+ {"matrix": [0, 0], "x": 0.75, "y": 0.25},
+ {"matrix": [0, 1], "x": 1.75, "y": 0.25},
+ {"matrix": [0, 2], "x": 2.75, "y": 0},
+ {"matrix": [0, 3], "x": 3.75, "y": 0.25},
+ {"matrix": [0, 4], "x": 4.75, "y": 0.25},
+ {"matrix": [0, 5], "x": 5.75, "y": 0.25},
+ {"matrix": [0, 6], "x": 6.75, "y": 0.25},
+ {"matrix": [0, 7], "x": 9.5, "y": 0.25},
+ {"matrix": [0, 8], "x": 10.5, "y": 0.25},
+ {"matrix": [0, 9], "x": 11.5, "y": 0.25},
+ {"matrix": [0, 10], "x": 12.5, "y": 0.25},
+ {"matrix": [0, 11], "x": 13.5, "y": 0},
+ {"matrix": [0, 12], "x": 14.5, "y": 0.25},
+ {"matrix": [0, 14], "x": 15.5, "y": 0.25, "w": 2},
+ {"matrix": [0, 16], "x": 18, "y": 0},
+
+ {"matrix": [1, 0], "x": 0.5, "y": 1.25, "w": 1.5},
+ {"matrix": [1, 1], "x": 2, "y": 1.25},
+ {"matrix": [1, 2], "x": 3.25, "y": 1.25},
+ {"matrix": [1, 3], "x": 4.25, "y": 1.25},
+ {"matrix": [1, 4], "x": 5.25, "y": 1.25},
+ {"matrix": [1, 5], "x": 6.25, "y": 1.25},
+ {"matrix": [1, 7], "x": 9, "y": 1.25},
+ {"matrix": [1, 8], "x": 10, "y": 1.25},
+ {"matrix": [1, 9], "x": 11, "y": 1.25},
+ {"matrix": [1, 10], "x": 12, "y": 1.25},
+ {"matrix": [1, 11], "x": 13.25, "y": 1.25},
+ {"matrix": [1, 12], "x": 14.25, "y": 1.25},
+ {"matrix": [1, 13], "x": 15.25, "y": 1.25},
+ {"matrix": [1, 14], "x": 16.25, "y": 1.25, "w": 1.5},
+ {"matrix": [1, 16], "x": 18.25, "y": 1.5},
+
+ {"matrix": [2, 0], "x": 0.25, "y": 2.25, "w": 1.75},
+ {"matrix": [2, 1], "x": 2, "y": 2.25},
+ {"matrix": [2, 2], "x": 3.5, "y": 2.25},
+ {"matrix": [2, 3], "x": 4.5, "y": 2.25},
+ {"matrix": [2, 4], "x": 5.5, "y": 2.25},
+ {"matrix": [2, 5], "x": 6.5, "y": 2.25},
+ {"matrix": [2, 7], "x": 9.25, "y": 2.25},
+ {"matrix": [2, 8], "x": 10.25, "y": 2.25},
+ {"matrix": [2, 9], "x": 11.25, "y": 2.25},
+ {"matrix": [2, 10], "x": 12.25, "y": 2.25},
+ {"matrix": [2, 11], "x": 13.75, "y": 2.25},
+ {"matrix": [2, 12], "x": 14.75, "y": 2.25},
+ {"matrix": [2, 14], "x": 15.75, "y": 2.25, "w": 2.25},
+ {"matrix": [2, 16], "x": 18.5, "y": 2.5},
+
+ {"matrix": [3, 0], "x": 0, "y": 3.25, "w": 2.25},
+ {"matrix": [3, 2], "x": 2.25, "y": 3.25},
+ {"matrix": [3, 3], "x": 3.75, "y": 3.25},
+ {"matrix": [3, 4], "x": 4.75, "y": 3.25},
+ {"matrix": [3, 5], "x": 5.75, "y": 3.25},
+ {"matrix": [3, 6], "x": 6.75, "y": 3.25},
+ {"matrix": [3, 7], "x": 8.5, "y": 3.25},
+ {"matrix": [3, 8], "x": 9.5, "y": 3.25},
+ {"matrix": [3, 9], "x": 10.5, "y": 3.25},
+ {"matrix": [3, 10], "x": 11.5, "y": 3.25},
+ {"matrix": [3, 11], "x": 12.5, "y": 3.25},
+ {"matrix": [3, 12], "x": 14.25, "y": 3.25},
+ {"matrix": [3, 13], "x": 15.25, "y": 3.25, "w": 1.75},
+ {"matrix": [3, 15], "x": 17.25, "y": 3.5},
+
+ {"matrix": [4, 0], "x": 0, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 1], "x": 1.25, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 3], "x": 3.75, "y": 4.25, "w": 1.25},
+ {"matrix": [4, 5], "x": 5, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 6], "x": 7.25, "y": 4.25},
+ {"matrix": [4, 7], "x": 8.75, "y": 4.25},
+ {"matrix": [4, 9], "x": 9.75, "y": 4.25, "w": 2.25},
+ {"matrix": [4, 11], "x": 12, "y": 4.25},
+ {"matrix": [4, 14], "x": 16.25, "y": 4.5},
+ {"matrix": [4, 15], "x": 17.25, "y": 4.5},
+ {"matrix": [4, 16], "x": 18.25, "y": 4.5}
+ ]
+ }
+ }
+
+}
\ No newline at end of file
diff --git a/keyboards/keychron/v8_max/ansi_encoder/keymaps/default/keymap.c b/keyboards/keychron/v8_max/ansi_encoder/keymaps/default/keymap.c
new file mode 100644
index 0000000000..2390c62f68
--- /dev/null
+++ b/keyboards/keychron/v8_max/ansi_encoder/keymaps/default/keymap.c
@@ -0,0 +1,81 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#include QMK_KEYBOARD_H
+#include "keychron_common.h"
+
+enum layers {
+ MAC_BASE,
+ WIN_BASE,
+ MAC_FN1,
+ WIN_FN1,
+ _FN2
+};
+// clang-format off
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+ [MAC_BASE] = LAYOUT_ansi_69(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LOPTN, KC_LCMMD, KC_SPC, MO(MAC_FN1), MO(_FN2), KC_SPC, KC_RCMMD, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [WIN_BASE] = LAYOUT_ansi_69(
+ KC_ESC, 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_MUTE,
+ 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_DEL,
+ 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_HOME,
+ KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_RSFT, KC_UP,
+ KC_LCTL, KC_LWIN, KC_LALT, KC_SPC, MO(WIN_FN1), MO(_FN2), KC_SPC, KC_RALT, KC_LEFT, KC_DOWN, KC_RGHT),
+
+ [MAC_FN1] = LAYOUT_ansi_69(
+ KC_GRV, KC_BRID, KC_BRIU, KC_MCTRL,KC_LNPAD,RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUD, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUI, RGB_SAD, RGB_SPD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [WIN_FN1] = LAYOUT_ansi_69(
+ KC_GRV, KC_BRID, KC_BRIU, KC_TASK, KC_FILE, RGB_VAD, RGB_VAI, KC_MPRV, KC_MPLY, KC_MNXT, KC_MUTE, KC_VOLD, KC_VOLU, _______, RGB_TOG,
+ _______, BT_HST1, BT_HST2, BT_HST3, P2P4G, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ RGB_TOG, RGB_MOD, RGB_VAI, RGB_HUD, RGB_SAI, RGB_SPI, _______, _______, _______, _______, _______, _______, _______, KC_END,
+ _______, RGB_RMOD, RGB_VAD, RGB_HUI, RGB_SAD, RGB_SPD, RGB_SPD, NK_TOGG, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+
+ [_FN2] = LAYOUT_ansi_69(
+ KC_TILD, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, BAT_LVL, BAT_LVL, _______, _______, _______, _______, _______, _______, _______,
+ _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______),
+};
+
+// clang-format on
+#if defined(ENCODER_MAP_ENABLE)
+const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][2] = {
+ [MAC_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [WIN_BASE] = {ENCODER_CCW_CW(KC_VOLD, KC_VOLU)},
+ [MAC_FN1] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [WIN_FN1] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+ [_FN2] = {ENCODER_CCW_CW(RGB_VAD, RGB_VAI)},
+};
+#endif // ENCODER_MAP_ENABLE
+
+bool process_record_user(uint16_t keycode, keyrecord_t *record) {
+ if (!process_record_keychron_common(keycode, record)) {
+ return false;
+ }
+ return true;
+}
diff --git a/keyboards/keychron/v8_max/ansi_encoder/rules.mk b/keyboards/keychron/v8_max/ansi_encoder/rules.mk
new file mode 100644
index 0000000000..6e7633bfe0
--- /dev/null
+++ b/keyboards/keychron/v8_max/ansi_encoder/rules.mk
@@ -0,0 +1 @@
+# This file intentionally left blank
diff --git a/keyboards/keychron/v8_max/board.h b/keyboards/keychron/v8_max/board.h
new file mode 100644
index 0000000000..423b39e395
--- /dev/null
+++ b/keyboards/keychron/v8_max/board.h
@@ -0,0 +1,226 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+#include_next
+
+// clang-format off
+
+/* Set GPIOA_SWDIO to INPUT and NOT FLOATING */
+#undef VAL_GPIOA_MODER
+#define VAL_GPIOA_MODER (PIN_MODE_INPUT(GPIOA_BUTTON) | \
+ PIN_MODE_INPUT(GPIOA_PIN1) | \
+ PIN_MODE_INPUT(GPIOA_PIN2) | \
+ PIN_MODE_INPUT(GPIOA_PIN3) | \
+ PIN_MODE_ALTERNATE(GPIOA_CS43L22_LRCK) |\
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SCL) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SD0) | \
+ PIN_MODE_ALTERNATE(GPIOA_L3GD20_SDI) | \
+ PIN_MODE_INPUT(GPIOA_PIN8) | \
+ PIN_MODE_INPUT(GPIOA_VBUS_FS) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_ID) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DM) | \
+ PIN_MODE_ALTERNATE(GPIOA_OTG_FS_DP) | \
+ PIN_MODE_INPUT(GPIOA_SWDIO) | \
+ PIN_MODE_INPUT(GPIOA_SWCLK) | \
+ PIN_MODE_INPUT(GPIOA_PIN15))
+
+#undef VAL_GPIOA_PUPDR
+#define VAL_GPIOA_PUPDR (PIN_PUPDR_FLOATING(GPIOA_BUTTON) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN3) | \
+ PIN_PUPDR_FLOATING(GPIOA_CS43L22_LRCK) |\
+ PIN_PUPDR_FLOATING(GPIOA_L3GD20_SCL) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SD0) | \
+ PIN_PUPDR_PULLUP(GPIOA_L3GD20_SDI) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN8) | \
+ PIN_PUPDR_FLOATING(GPIOA_VBUS_FS) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_ID) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DM) | \
+ PIN_PUPDR_FLOATING(GPIOA_OTG_FS_DP) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWDIO) | \
+ PIN_PUPDR_PULLUP(GPIOA_SWCLK) | \
+ PIN_PUPDR_PULLUP(GPIOA_PIN15))
+
+#undef VAL_GPIOB_MODER
+#define VAL_GPIOB_MODER (PIN_MODE_INPUT(GPIOB_PIN0) | \
+ PIN_MODE_INPUT(GPIOB_PIN1) | \
+ PIN_MODE_INPUT(GPIOB_PIN2) | \
+ PIN_MODE_INPUT(GPIOB_SWO) | \
+ PIN_MODE_INPUT(GPIOB_PIN4) | \
+ PIN_MODE_INPUT(GPIOB_PIN5) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SCL) | \
+ PIN_MODE_INPUT(GPIOB_PIN7) | \
+ PIN_MODE_INPUT(GPIOB_PIN8) | \
+ PIN_MODE_INPUT(GPIOB_LSM303DLHC_SDA) | \
+ PIN_MODE_INPUT(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_MODE_INPUT(GPIOB_PIN11) | \
+ PIN_MODE_INPUT(GPIOB_PIN12) | \
+ PIN_MODE_INPUT(GPIOB_PIN13) | \
+ PIN_MODE_INPUT(GPIOB_PIN14) | \
+ PIN_MODE_INPUT(GPIOB_PIN15))
+
+#undef VAL_GPIOB_PUPDR
+#define VAL_GPIOB_PUPDR (PIN_PUPDR_PULLDOWN(GPIOB_PIN0) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN1) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN2) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_SWO) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN5) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SCL) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN7) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN8) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_LSM303DLHC_SDA) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_MP45DT02_CLK_IN) |\
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN11) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN12) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN13) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN14) | \
+ PIN_PUPDR_PULLDOWN(GPIOB_PIN15))
+
+#undef VAL_GPIOB_AFRL
+#define VAL_GPIOB_AFRL (PIN_AFIO_AF(GPIOB_PIN0, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN1, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN2, 0U) | \
+ PIN_AFIO_AF(GPIOB_SWO, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN4, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN5, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SCL, 0) | \
+ PIN_AFIO_AF(GPIOB_PIN7, 0U))
+
+#undef VAL_GPIOB_AFRH
+#define VAL_GPIOB_AFRH (PIN_AFIO_AF(GPIOB_PIN8, 0U) | \
+ PIN_AFIO_AF(GPIOB_LSM303DLHC_SDA, 0) | \
+ PIN_AFIO_AF(GPIOB_MP45DT02_CLK_IN, 0U) |\
+ PIN_AFIO_AF(GPIOB_PIN11, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN12, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN13, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN14, 0U) | \
+ PIN_AFIO_AF(GPIOB_PIN15, 0U))
+
+/* C5 Need to be pulldown */
+#undef VAL_GPIOC_MODER
+#define VAL_GPIOC_MODER (PIN_MODE_INPUT(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_MODE_INPUT(GPIOC_PIN1) | \
+ PIN_MODE_INPUT(GPIOC_PIN2) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_AIN4x) | \
+ PIN_MODE_INPUT(GPIOC_PIN4) | \
+ PIN_MODE_INPUT(GPIOC_PIN5) | \
+ PIN_MODE_INPUT(GPIOC_PIN6) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_MCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN8) | \
+ PIN_MODE_INPUT(GPIOC_PIN9) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SCLK) | \
+ PIN_MODE_INPUT(GPIOC_PIN11) | \
+ PIN_MODE_INPUT(GPIOC_CS43L22_SDIN) | \
+ PIN_MODE_INPUT(GPIOC_PIN13) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_IN) | \
+ PIN_MODE_INPUT(GPIOC_OSC32_OUT))
+
+#undef VAL_GPIOC_PUPDR
+#define VAL_GPIOC_PUPDR (PIN_PUPDR_PULLUP(GPIOC_OTG_FS_POWER_ON) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_AIN4x) |\
+ PIN_PUPDR_PULLUP(GPIOC_PIN4) | \
+ PIN_PUPDR_PULLDOWN(GPIOC_PIN5) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_MCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SCLK) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOC_CS43L22_SDIN) | \
+ PIN_PUPDR_PULLUP(GPIOC_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_IN) | \
+ PIN_PUPDR_PULLUP(GPIOC_OSC32_OUT))
+
+/* Set all GPIOD pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOD_MODER
+#define VAL_GPIOD_MODER (PIN_MODE_INPUT(GPIOD_PIN0) | \
+ PIN_MODE_INPUT(GPIOD_PIN1) | \
+ PIN_MODE_INPUT(GPIOD_PIN2) | \
+ PIN_MODE_INPUT(GPIOD_PIN3) | \
+ PIN_MODE_INPUT(GPIOD_CS43L22_RESET) | \
+ PIN_MODE_INPUT(GPIOD_OverCurrent) | \
+ PIN_MODE_INPUT(GPIOD_PIN6) | \
+ PIN_MODE_INPUT(GPIOD_PIN7) | \
+ PIN_MODE_INPUT(GPIOD_PIN8) | \
+ PIN_MODE_INPUT(GPIOD_PIN9) | \
+ PIN_MODE_INPUT(GPIOD_PIN10) | \
+ PIN_MODE_INPUT(GPIOD_PIN11) | \
+ PIN_MODE_INPUT(GPIOD_LED4) | \
+ PIN_MODE_INPUT(GPIOD_LED3) | \
+ PIN_MODE_INPUT(GPIOD_LED5) | \
+ PIN_MODE_INPUT(GPIOD_LED6))
+
+#undef VAL_GPIOD_PUPDR
+#define VAL_GPIOD_PUPDR (PIN_PUPDR_PULLUP(GPIOD_PIN0) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN1) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN2) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN3) | \
+ PIN_PUPDR_PULLUP(GPIOD_CS43L22_RESET) |\
+ PIN_PUPDR_PULLUP(GPIOD_OverCurrent) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOD_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED4) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED3) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED5) | \
+ PIN_PUPDR_PULLUP(GPIOD_LED6))
+
+/* Set all GPIOE pins to INPUT & PULLUP to avoid FLOATING */
+#undef VAL_GPIOE_MODER
+#define VAL_GPIOE_MODER (PIN_MODE_INPUT(GPIOE_L3GD20_INT1) | \
+ PIN_MODE_INPUT(GPIOE_L3GD20_INT2) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_MODE_INPUT(GPIOE_L3GD20_CS) | \
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT1) |\
+ PIN_MODE_INPUT(GPIOE_LSM303DLHC_INT2) |\
+ PIN_MODE_INPUT(GPIOE_PIN6) | \
+ PIN_MODE_INPUT(GPIOE_PIN7) | \
+ PIN_MODE_INPUT(GPIOE_PIN8) | \
+ PIN_MODE_INPUT(GPIOE_PIN9) | \
+ PIN_MODE_INPUT(GPIOE_PIN10) | \
+ PIN_MODE_INPUT(GPIOE_PIN11) | \
+ PIN_MODE_INPUT(GPIOE_PIN12) | \
+ PIN_MODE_INPUT(GPIOE_PIN13) | \
+ PIN_MODE_INPUT(GPIOE_PIN14) | \
+ PIN_MODE_INPUT(GPIOE_PIN15))
+
+#undef VAL_GPIOE_PUPDR
+#define VAL_GPIOE_PUPDR (PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT1) | \
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_INT2) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_DRDY) |\
+ PIN_PUPDR_PULLUP(GPIOE_L3GD20_CS) | \
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT1) |\
+ PIN_PUPDR_PULLUP(GPIOE_LSM303DLHC_INT2) |\
+ PIN_PUPDR_PULLUP(GPIOE_PIN6) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN7) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN8) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN9) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN10) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN11) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN12) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN13) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN14) | \
+ PIN_PUPDR_PULLUP(GPIOE_PIN15))
+
diff --git a/keyboards/keychron/v8_max/config.h b/keyboards/keychron/v8_max/config.h
new file mode 100644
index 0000000000..5f618f7e2a
--- /dev/null
+++ b/keyboards/keychron/v8_max/config.h
@@ -0,0 +1,75 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 .
+ */
+
+#pragma once
+
+/* Encoder Configuration */
+#define ENCODER_DEFAULT_POS 0x3
+#define ENCODER_MAP_KEY_DELAY 2
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE) || defined(LK_WIRELESS_ENABLE)
+/* SPI configuration */
+# define SPI_DRIVER SPID1
+# define SPI_SCK_PIN A5
+# define SPI_MISO_PIN A6
+# define SPI_MOSI_PIN A7
+#endif
+
+#if defined(RGB_MATRIX_ENABLE) || defined(LED_MATRIX_ENABLE)
+# define SNLED27351_SDB_PIN B7
+# define SNLED23751_SPI_DIVISOR 16
+#endif
+
+#ifdef LK_WIRELESS_ENABLE
+/* Hardware configuration */
+# define P24G_MODE_SELECT_PIN A10
+# define BT_MODE_SELECT_PIN A9
+
+# define LKBT51_RESET_PIN C4
+# define LKBT51_INT_INPUT_PIN B1
+# define LKBT51_INT_OUTPUT_PIN A4
+
+# define USB_POWER_SENSE_PIN B0
+# define USB_POWER_CONNECTED_LEVEL 0
+
+# define BAT_CHARGING_PIN B13
+# define BAT_CHARGING_LEVEL 0
+
+# define BAT_LOW_LED_PIN B12
+# define BAT_LOW_LED_PIN_ON_STATE 1
+
+# define BT_HOST_DEVICES_COUNT 3
+
+# if defined(RGB_MATRIX_ENABLE)
+/* Backlit disable timeout when keyboard is disconnected(unit: second) */
+# define DISCONNECTED_BACKLIGHT_DISABLE_TIMEOUT 40
+/* Backlit disable timeout when keyboard is connected(unit: second) */
+# define CONNECTED_BACKLIGHT_DISABLE_TIMEOUT 600
+/* Reinit LED driver on tranport changed */
+# define REINIT_LED_DRIVER 1
+# endif
+
+/* Keep USB connection in wireless mode */
+# define KEEP_USB_CONNECTION_IN_WIRELESS_MODE
+
+#endif
+
+/* Factory test keys */
+#define FN_KEY_2 MO(4)
+#define FN_BL_TRIG_KEY KC_END
+
+#define P2P4G_CELAR_MASK 0
+#define MATRIX_IO_DELAY 10
diff --git a/keyboards/keychron/v8_max/halconf.h b/keyboards/keychron/v8_max/halconf.h
new file mode 100644
index 0000000000..44e782f5ca
--- /dev/null
+++ b/keyboards/keychron/v8_max/halconf.h
@@ -0,0 +1,31 @@
+/*Copyright 2024 @ Keychron (https://www.keychron.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
+
+#define _CHIBIOS_HAL_CONF_VER_8_4_
+
+#define HAL_USE_SPI TRUE
+
+#ifdef LK_WIRELESS_ENABLE
+# define HAL_USE_RTC TRUE
+#endif
+
+#if defined(LK_WIRELESS_ENABLE) || defined(ENCODER_ENABLE)
+# define PAL_USE_CALLBACKS TRUE
+#endif
+
+#include_next
diff --git a/keyboards/keychron/v8_max/info.json b/keyboards/keychron/v8_max/info.json
new file mode 100644
index 0000000000..1e7f290813
--- /dev/null
+++ b/keyboards/keychron/v8_max/info.json
@@ -0,0 +1,80 @@
+{
+ "keyboard_name": "Keychron V8 Max",
+ "manufacturer": "Keychron",
+ "url": "https://github.com/Keychron",
+ "maintainer": "123wink",
+ "processor": "STM32F401",
+ "bootloader": "stm32-dfu",
+ "usb": {
+ "vid": "0x3434"
+ },
+ "features": {
+ "bootmagic": true,
+ "extrakey" : true,
+ "mousekey" : true,
+ "dip_switch" : true,
+ "nkro" : true,
+ "encoder": true,
+ "encoder_map": true,
+ "rgb_matrix": true,
+ "raw" : true,
+ "send_string": true
+ },
+ "encoder": {
+ "rotary": [
+ {
+ "pin_a": "B15",
+ "pin_b": "B14"
+ }
+ ]
+ },
+ "dynamic_keymap": {
+ "layer_count": 5
+ },
+ "matrix_pins": {
+ "cols": ["C6", "C7", "C8", "A14", "A15", "C10", "C11", "C13", "C14", "C15", "C0", "C1", "C2", "C3", "A0", "A1","A2"],
+ "rows": ["C12", "D2", "B3", "B4", "B5"]
+ },
+ "diode_direction": "ROW2COL",
+ "dip_switch" :{
+ "pins": ["A8"]
+ },
+ "rgb_matrix": {
+ "driver": "snled27351_spi",
+ "sleep": true,
+ "animations": {
+ "band_spiral_val": true,
+ "breathing": true,
+ "cycle_all": true,
+ "cycle_left_right": true,
+ "cycle_out_in": true,
+ "cycle_out_in_dual": true,
+ "cycle_pinwheel": true,
+ "cycle_spiral": true,
+ "cycle_up_down": true,
+ "digital_rain": true,
+ "dual_beacon": true,
+ "jellybean_raindrops": true,
+ "pixel_rain": true,
+ "rainbow_beacon": true,
+ "rainbow_moving_chevron": true,
+ "solid_reactive_multinexus": true,
+ "solid_reactive_multiwide": true,
+ "solid_reactive_simple": true,
+ "solid_splash": true,
+ "splash": true,
+ "typing_heatmap": true
+ }
+ },
+ "eeprom": {
+ "wear_leveling": {
+ "driver": "embedded_flash",
+ "logical_size": 2048,
+ "backing_size": 4096
+ }
+ },
+ "build": {
+ "debounce_type": "sym_eager_pk"
+ },
+ "debounce": 20
+}
diff --git a/keyboards/keychron/v8_max/mcuconf.h b/keyboards/keychron/v8_max/mcuconf.h
new file mode 100644
index 0000000000..548dfde479
--- /dev/null
+++ b/keyboards/keychron/v8_max/mcuconf.h
@@ -0,0 +1,37 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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_next
+
+#undef STM32_HSECLK
+#define STM32_HSECLK 16000000
+
+#undef STM32_PLLM_VALUE
+#define STM32_PLLM_VALUE 8
+
+#undef STM32_PLLN_VALUE
+#define STM32_PLLN_VALUE 96
+
+#undef STM32_PLLP_VALUE
+#define STM32_PLLP_VALUE 4
+
+#undef STM32_PLLQ_VALUE
+#define STM32_PLLQ_VALUE 4
+
+#undef STM32_SPI_USE_SPI1
+#define STM32_SPI_USE_SPI1 TRUE
diff --git a/keyboards/keychron/v8_max/readme.md b/keyboards/keychron/v8_max/readme.md
new file mode 100644
index 0000000000..07a78f39dd
--- /dev/null
+++ b/keyboards/keychron/v8_max/readme.md
@@ -0,0 +1,21 @@
+# Keychron V8 Max
+
+
+
+A customizable wireless 65% ergonomic keyboard.
+
+* Keyboard Maintainer: [Keychron](https://www.keychron.com/products/keychron-v8-max-alice-layout-qmk-custom-mechanical-keyboard)
+* Hardware Supported: Keychron V8 Max
+* Hardware Availability: [Keychron V8 Max QMK/VIA Wireless Custom Mechanical Keyboard]
+
+Make example for this keyboard (after setting up your build environment):
+
+ make keychron/v8_max/ansi_encoder:default
+
+Flashing example for this keyboard:
+
+ make keychron/v8_max/ansi_encoder:default:flash
+
+**Reset Key**: Toggle mode switch to "Cable", hold down the *Esc* key or reset button underneath space bar while connecting the USB cable,
+
+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).
diff --git a/keyboards/keychron/v8_max/rules.mk b/keyboards/keychron/v8_max/rules.mk
new file mode 100644
index 0000000000..4eaf6820bc
--- /dev/null
+++ b/keyboards/keychron/v8_max/rules.mk
@@ -0,0 +1,4 @@
+include keyboards/keychron/common/wireless/wireless.mk
+include keyboards/keychron/common/keychron_common.mk
+
+VPATH += $(TOP_DIR)/keyboards/keychron
diff --git a/keyboards/keychron/v8_max/v8_max.c b/keyboards/keychron/v8_max/v8_max.c
new file mode 100644
index 0000000000..54d1b0c065
--- /dev/null
+++ b/keyboards/keychron/v8_max/v8_max.c
@@ -0,0 +1,83 @@
+/* Copyright 2024 ~ 2025 @ Keychron (https://www.keychron.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 "quantum.h"
+#include "keychron_task.h"
+#ifdef FACTORY_TEST_ENABLE
+# include "factory_test.h"
+# include "keychron_common.h"
+#endif
+#ifdef LK_WIRELESS_ENABLE
+# include "lkbt51.h"
+# include "wireless.h"
+# include "keychron_wireless_common.h"
+# include "battery.h"
+#endif
+
+#define POWER_ON_LED_DURATION 3000
+static uint32_t power_on_indicator_timer;
+
+#ifdef DIP_SWITCH_ENABLE
+bool dip_switch_update_kb(uint8_t index, bool active) {
+ if (index == 0) {
+ default_layer_set(1UL << (active ? 0 : 1));
+ }
+ dip_switch_update_user(index, active);
+
+ return true;
+}
+#endif
+
+void keyboard_post_init_kb(void) {
+#ifdef LK_WIRELESS_ENABLE
+ palSetLineMode(P24G_MODE_SELECT_PIN, PAL_MODE_INPUT);
+ palSetLineMode(BT_MODE_SELECT_PIN, PAL_MODE_INPUT);
+
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+
+ lkbt51_init(false);
+ wireless_init();
+#endif
+
+ power_on_indicator_timer = timer_read32();
+#ifdef ENCODER_ENABLE
+ encoder_cb_init();
+#endif
+ keyboard_post_init_user();
+}
+
+bool keychron_task_kb(void) {
+ if (power_on_indicator_timer) {
+ if (timer_elapsed32(power_on_indicator_timer) > POWER_ON_LED_DURATION) {
+ power_on_indicator_timer = 0;
+
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, !BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ } else {
+#ifdef LK_WIRELESS_ENABLE
+ gpio_write_pin(BAT_LOW_LED_PIN, BAT_LOW_LED_PIN_ON_STATE);
+#endif
+ }
+ }
+ return true;
+}
+
+#ifdef LK_WIRELESS_ENABLE
+bool lpm_is_kb_idle(void) {
+ return power_on_indicator_timer == 0 && !factory_reset_indicating();
+}
+#endif
diff --git a/keyboards/keychron/v8_max/via_json/v8_max_ansi_encoder.json b/keyboards/keychron/v8_max/via_json/v8_max_ansi_encoder.json
new file mode 100644
index 0000000000..181adcc9a7
--- /dev/null
+++ b/keyboards/keychron/v8_max/via_json/v8_max_ansi_encoder.json
@@ -0,0 +1,351 @@
+{
+ "name": "Keychron V8 Max ANSI Knob",
+ "vendorId": "0x3434",
+ "productId": "0x0980",
+ "keycodes": ["qmk_lighting"],
+ "menus": [
+ {
+ "label": "Lighting",
+ "content": [
+ {
+ "label": "Backlight",
+ "content": [
+ {
+ "label": "Brightness",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_brightness", 3, 1]
+ },
+ {
+ "label": "Effect",
+ "type": "dropdown",
+ "content": ["id_qmk_rgb_matrix_effect", 3, 2],
+ "options": [
+ ["None", 0],
+ ["Solid Color", 1],
+ ["Breathing", 2],
+ ["Band Spiral Val", 3],
+ ["Cycle All", 4],
+ ["Cycle Left Right", 5],
+ ["Cycle Up Down", 6],
+ ["Rainbow Moving Chevron", 7],
+ ["Cycle Out In", 8],
+ ["Cycle Out In Dual", 9],
+ ["Cycle Pinwheel", 10],
+ ["Cycle Spiral", 11],
+ ["Dual Beacon", 12],
+ ["Rainbow Beacon", 13],
+ ["Jellybean Raindrops", 14],
+ ["Pixel Rain", 15],
+ ["Typing Heatmap", 16],
+ ["Digital Rain", 17],
+ ["Reactive Simple", 18],
+ ["Reactive Multiwide", 19],
+ ["Reactive Multinexus", 20],
+ ["Splash", 21],
+ ["Solid Splash", 22]
+ ]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} > 1",
+ "label": "Effect Speed",
+ "type": "range",
+ "options": [0, 255],
+ "content": ["id_qmk_rgb_matrix_effect_speed", 3, 3]
+ },
+ {
+ "showIf": "{id_qmk_rgb_matrix_effect} != 0 && ( {id_qmk_rgb_matrix_effect} < 4 || {id_qmk_rgb_matrix_effect} == 18 || ({id_qmk_rgb_matrix_effect} > 17 && {id_qmk_rgb_matrix_effect} != 21) ) ",
+ "label": "Color",
+ "type": "color",
+ "content": ["id_qmk_rgb_matrix_color", 3, 4]
+ }
+ ]
+ }
+ ]
+ }
+ ],
+ "customKeycodes": [
+ {"name": "Left Option", "title": "Left Option", "shortName": "LOpt"},
+ {"name": "Right Option", "title": "Right Option", "shortName": "ROpt"},
+ {"name": "Left Cmd", "title": "Left Command", "shortName": "LCmd"},
+ {"name": "Right Cmd", "title": "Right Command", "shortName": "RCmd"},
+ {"name": "Misson Control", "title": "Misson Control in Mac", "shortName": "MCtl"},
+ {"name": "Lanuch Pad", "title": "Lanuch Pad in Windows", "shortName": "LPad"},
+ {"name": "Task View", "title": "Task View in Windows", "shortName": "Task"},
+ {"name": "File Explorer", "title": "File Explorer in Windows", "shortName": "File"},
+ {"name": "Screen shot", "title": "Screenshot in macOS", "shortName": "SShot"},
+ {"name": "Cortana", "title": "Cortana in Windows", "shortName": "Cortana"},
+ {"name": "Siri", "title": "Siri in macOS", "shortName": "Siri"},
+ {"name": "Bluetooth Host 1", "title": "Bluetooth Host 1", "shortName": "BTH1"},
+ {"name": "Bluetooth Host 2", "title": "Bluetooth Host 2", "shortName": "BTH2"},
+ {"name": "Bluetooth Host 3", "title": "Bluetooth Host 3", "shortName": "BTH3"},
+ {"name": "2.4G", "title": "2.4G", "shortName": "2.4G"},
+ {"name": "Battery Level", "title": "Show battery level", "shortName": "Batt"}
+ ],
+ "matrix": {"rows": 5, "cols" : 17},
+ "layouts": {
+ "keymap": [
+ [
+ {
+ "x":2.75,
+ "y":0.5
+ },
+ "0,2",
+ {
+ "x":8.7
+ },
+
+ "0,11",
+ {
+ "x":3.5,
+ "c":"#777777"
+ },
+ "0,16\n\n\n\n\n\n\n\n\ne0"
+ ],
+ [
+ {
+ "y":-0.85,
+ "x":0.75
+ },
+ "0,0\nESC",
+ {
+ "c":"#cccccc"
+ },
+ "0,1",
+ {
+ "x":10.75
+
+ },
+ "0,12",
+ {
+ "w":2,
+ "c":"#777777"
+ },
+ "0,14"
+ ],
+ [
+ {
+ "x":0.5,
+ "w":1.5
+ },
+ "1,0",
+ {
+ "c":"#aaaaaa"
+ },
+ "1,1",
+ {
+ "x":10.2
+ },
+ "1,12",
+ "1,13",
+ {
+ "w":1.5
+
+ },
+ "1,14"
+
+ ],
+ [
+ {
+ "y":-0.9,
+ "x":17.5,
+ "c":"#777777"
+ },
+ "1,16"
+ ],
+ [
+ {
+ "x":0.25,
+ "y":-0.1,
+ "w":1.75
+ },
+ "2,0",
+ {
+ "c":"#aaaaaa"
+ },
+ "2,1",
+ {
+ "x":9.9
+ },
+ "2,11",
+ "2,12",
+ {
+ "c":"#777777",
+ "w":2.25
+ },
+ "2,14"
+ ],
+ [
+ {
+ "y":-0.9,
+ "x":17.7
+
+ },
+ "2,16"
+ ],
+ [
+ {
+ "x":0.15,
+ "y":-0.1,
+ "w":2.25
+ },
+ "3,0",
+ {
+ "c":"#aaaaaa"
+ },
+ "3,2",
+ {
+ "x":9.75
+ },
+ "3,12",
+ {
+ "w":1.5,
+ "c":"#777777"
+ },
+ "3,13"
+ ],
+ [
+ {
+ "y":-0.65,
+ "x":16,
+ "c":"#cccccc"
+ },
+ "3,15"
+ ],
+ [
+ {
+ "x":0.15,
+ "y":-0.35,
+ "w":1.25,
+ "c":"#777777"
+ },
+ "4,0",
+ {
+ "w":1.25
+ },
+ "4,1"
+ ],
+ [
+ {
+ "x":15,
+ "y":-0.65,
+ "c":"#cccccc"
+ },
+ "4,14",
+ "4,15",
+ "4,16"
+
+ ],
+ [
+ {
+ "r":10,
+ "y":-6,
+ "x":4
+ },
+ "0,3",
+ "0,4",
+ "0,5",
+ "0,6"
+ ],
+ [
+ {
+ "x":3.5
+ },
+ "1,2",
+ "1,3",
+ "1,4",
+ "1,5"
+ ],
+ [
+ {
+ "x":3.8
+ },
+ "2,2",
+ "2,3",
+ "2,4",
+ "2,5"
+ ],
+ [
+ {
+ "x":4.25
+ },
+ "3,3",
+ "3,4",
+ "3,5",
+ "3,6"
+ ],
+ [
+ {
+ "x":4.25,
+ "c":"#777777",
+ "w":1.25
+ },
+ "4,3",
+ {
+ "w":2.25
+ },
+ "4,5",
+
+ "4,6"
+ ],
+ [
+ {
+ "r":-10,
+ "y":-2.2,
+ "x":8,
+ "c":"#aaaaaa"
+ },
+ "0,7",
+ "0,8",
+ "0,9",
+ "0,10"
+ ],
+ [
+ {
+ "x":7.5
+ },
+ "1,7",
+ "1,8",
+ "1,9",
+ "1,10",
+ "1,11"
+ ],
+ [
+ {
+ "x":7.9
+ },
+ "2,7",
+ "2,8",
+ "2,9",
+ "2,10"
+ ],
+ [
+ {
+ "x":7.1
+ },
+ "3,7",
+ "3,8",
+ "3,9",
+ "3,10",
+ "3,11"
+ ],
+ [
+ {
+ "x":7.1,
+ "c":"#777777"
+ },
+ "4,7",
+ {
+ "w":2.25
+
+ },
+ "4,9",
+ {
+ "x":-0.05
+
+ },
+ "4,11"
+ ]
+ ]
+ }
+}