rootiest 41195cbdde feat(k17_max): enable Keychron RGB and fix EEPROM persistence
Port the Keychron RGB EEPROM persistence work from the Q5 Max (PR #18)
to the K17 Max ANSI Encoder RGB variant.

- Add KEYCHRON_RGB_ENABLE = yes to rules.mk
- Define default_per_key_led[] (red Esc/CapsLock, yellow modifiers and
  numpad, blue alpha keys) and default_region[] for the 103-LED layout
  in ansi_encoder/rgb/rgb.c; both are extern'd by keychron_rgb.c
- Add wireless_enter_connected_kb() hook and eeconfig_init_custom_rgb()
  call in keyboard_post_init_kb() in k17_max.c, matching the Q5 Max
  pattern for boot-time and transport-change RGB persistence
- Define VIA_EEPROM_MAGIC_ADDR 552 in ansi_encoder/rgb/config.h to pin
  VIA keymap storage past the Keychron EEPROM data region end (540 for
  K17 with 103 LEDs); prevents keymap corruption if the KB data block
  grows in future
- Define RGB_MATRIX_DEFAULT_MODE RGB_MATRIX_TYPING_HEATMAP to set the
  compile-time fallback mode consistently with the Q5 Max
2026-04-13 13:19:00 -04:00
2023-12-04 12:04:21 +11:00
2023-11-27 05:36:45 +11:00
2024-08-21 11:20:44 +08:00
2023-09-01 09:26:48 +10:00
2022-02-11 20:00:34 -08:00
2026-04-09 00:12:20 -04:00
2026-04-10 14:19:59 -04:00
2024-08-21 11:20:44 +08:00
2023-11-28 07:53:43 +11:00
2019-09-07 07:58:41 -07:00
2023-11-28 15:56:54 +11:00
2022-04-13 18:00:18 +10:00

Quantum Mechanical Keyboard Firmware

Current Version Discord Docs Status GitHub contributors GitHub forks

This is a keyboard firmware based on the tmk_keyboard firmware with some useful features for Atmel AVR and ARM controllers, and more specifically, the OLKB product line, the ErgoDox EZ keyboard, and the Clueboard product line.

Documentation

The docs are powered by Docsify and hosted on GitHub. They are also viewable offline; see Previewing the Documentation for more details.

You can request changes by making a fork and opening a pull request, or by clicking the "Edit this page" link at the bottom of any page.

Supported Keyboards

The project also includes community support for lots of other keyboards.

Maintainers

QMK is developed and maintained by Jack Humbert of OLKB with contributions from the community, and of course, Hasu. The OLKB product firmwares are maintained by Jack Humbert, the Ergodox EZ by ZSA Technology Labs, the Clueboard by Zach White, and the Atreus by Phil Hagelberg.

Official Website

qmk.fm is the official website of QMK, where you can find links to this page, the documentation, and the keyboards supported by QMK.

S
Description
No description provided
Readme 284 MiB
Languages
C 84.4%
C++ 10.9%
Python 2.7%
Makefile 1.7%
Shell 0.2%