十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

QMK CU24 键盘固件完全指南:24 键小键盘的布局、RGB 灯效与编译刷写

QMK CU24 键盘固件完全指南:24 键小键盘的布局、RGB 灯效与编译刷写 QMK CU24 键盘固件完全指南24 键小键盘的布局、RGB 灯效与编译刷写【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmwareCU24 是 CapsUnlocked 推出的一款 24 键小键盘keypad支持多种布局、RGB 底灯underglow、按键背光backlight并提供铝、黄铜、尼龙等多种外壳材质。本指南以 QMK 仓库中 CU24 的 readme 为核心结合 keyboard.json 数据驱动配置 与 默认键位映射完整讲解其硬件特性、数据驱动配置结构、两种官方布局定义、默认键位功能以及从编译到刷写的完整流程帮助你快速上手并自由定制自己的 CU24。CU24 是什么一款多布局的 24 键小键盘根据官方 readme 的描述CU24 是一款奢华luxurious的 24 键小键盘其核心卖点可以归纳为24 键紧凑布局形似数字键盘numpad适合输入数字、媒体控制与宏操作RGB 底灯RGB underglow与按键背光backlight双重灯效多种外壳材质铝aluminium、黄铜brass与尼龙nylon可选硬件版本PCB v1.0主控为ATmega32U4AVR 架构维护者MaintainerYiancar同时维护 CapsUnlocked 系列的 CU7、CU65、CU75、CU80 等键盘见 keyboards/capsunlocked 目录硬件购买渠道caps-unlocked.com仓库仅记录该事实购买情况以官方渠道为准。在 QMK 仓库中CU24 是一个**纯数据驱动data-driven**配置的键盘keyboards/capsunlocked/cu24/目录下只有keyboard.json、默认键位与 readme没有传统的手写config.h/rules.mk头文件全部硬件参数集中在 keyboard.json 中声明。这与 QMK 社区推广的数据驱动配置规范详见 docs/data_driven_config.md完全一致。硬件与引脚配置从 keyboard.json 读懂 PCBCU24 的全部硬件信息都定义在 keyboard.json 中它也是 QMK 数据驱动配置的核心载体。下面逐项拆解关键字段。USB 标识与芯片usb: { vid: 0xFEED, pid: 0x0000, device_version: 0.0.1 }, processor: atmega32u4, bootloader: atmel-dfuVID/PID0xFEED:0x0000这是 QMK 生态中常见的厂商 IDQMK 官方在多个键盘上使用 0xFEED用于系统识别设备processoratmega32u4即 8 位 AVR 主控带原生 USB与 readme 中uses a 32u4的说法一致bootloaderatmel-dfu刷写时使用 DFU 协议详见下文刷写章节。矩阵引脚与二极管方向matrix_pins: { cols: [F0, F1, D0, D1], rows: [E6, F5, B4, B6, C6, C7] }, diode_direction: ROW2COLCU24 采用6 行 × 4 列的矩阵共 24 个按键位6×424。diode_direction: ROW2COL表示二极管从行指向列即行信号输出、列信号读取这是矩阵扫描方向的硬件定义影响按键扫描逻辑矩阵工作原理可参考 docs/how_a_matrix_works.md。背光Backlight配置backlight: { pin: B5, levels: 5, breathing: true }背光挂在PB5引脚上支持 5 级亮度levels: 5并启用了呼吸灯效果breathing: true。注意ATmega32U4 的 PB5 也是芯片内置 LED 所在引脚QMK 默认将背光 PWM 输出复用在该引脚上这正是 CU24 按键背光的实现方式。RGB 底灯RGBLIGHT与 WS2812 灯带rgblight: { led_count: 5, animations: { ... } }, ws2812: { pin: F4 }ws2812.pinF4底灯灯带的数据引脚灯珠为 WS2812 系列RGB 可编程 LEDrgblight.led_count5即 5 颗 RGB LED 组成底灯animations启用了包括breathing呼吸、rainbow_mood彩虹流动、rainbow_swirl彩虹漩涡、snake贪吃蛇、knight骑士、christmas圣诞、static_gradient静态渐变、rgb_testRGB 测试、alternating交替与twinkle闪烁在内的 10 种动画效果均可通过键位在 Fn 层中切换。功能特性开关features: { backlight: true, bootmagic: false, extrakey: true, mousekey: true, nkro: true, rgblight: true }backlight/rgblight启用上面两套灯效系统extrakey启用多媒体/系统按键如KC_MPLY、KC_MUTE、KC_VOLD、KC_VOLU这是默认键位中媒体控制的基础mousekey启用鼠标键nkro启用 N 键无冲突N-Key Rolloverbootmagic关闭默认键位因此不需要 Bootmagic 相关的组合键另有qmk.locking含resync等 AVR 键盘的锁定键支持配置。两种官方布局LAYOUT_grid 与 LAYOUT_numpadCU24 的亮点之一是various layouts多种布局。keyboard.json中声明了两个布局宏它们共用同一 6×4 矩阵但对按键的物理位置进行了不同定义从而支持用户以不同形状组装键盘配合不同外壳或键帽方案。LAYOUT_grid标准 4×6 网格LAYOUT_grid按矩阵顺序把 24 个按键排成 4 列 × 6 行的整齐网格每个键位都是 1×1 大小LAYOUT_grid: { layout: [ {matrix: [0, 0], x: 0, y: 0}, {matrix: [0, 1], x: 1, y: 0}, ... {matrix: [5, 3], x: 3, y: 5} ] }每个条目中的matrix: [row, col]指定该物理位置对应的矩阵交叉点x/y定义其在键盘可视化与键位编辑工具中的坐标。从源码可见LAYOUT_grid覆盖了矩阵全部 24 个交叉点。LAYOUT_numpad经典数字小键盘布局LAYOUT_numpad则按照传统数字小键盘的物理形状排布最明显的差异是{matrix: [2, 3], x: 3, y: 2, h: 2}键纵向占两行h: 2{matrix: [4, 3], x: 3, y: 4, h: 2}Enter键纵向占两行{matrix: [5, 1], x: 0, y: 5, w: 2}底部0键横向占两列w: 2剩余键位为标准的7 8 9、4 5 6、1 2 3数字排布。这种w宽度与h高度属性正是 QMK 布局系统中描述非标准尺寸按键的方式让同一个矩阵既能支持规则网格外壳也能支持小键盘形状外壳。从仓库内容看当前默认键位只使用了LAYOUT_gridLAYOUT_numpad作为已声明的官方布局可供自定义键位直接调用你可以在自己的 keymap 中以LAYOUT_numpad(...)引用它。默认键位媒体键 数字小键盘 Fn 灯效层默认键位位于 keymaps/default/keymap.c其配套说明见 keymaps/default/readme.md出厂固件预装的布局和普通小键盘一样所有 LED 自定义功能都放在 Fn 层。第 0 层Base基础层媒体控制 小键盘[0] LAYOUT_grid( /* Base */ KC_MPLY, KC_MUTE, KC_VOLD, KC_VOLU, // 播放/暂停、静音、音量减、音量加 MO(1) , KC_PSLS, KC_PAST, KC_PMNS, // 按住进入 Fn 层、除、乘、减 KC_P7 , KC_P8 , KC_P9 , KC_PPLS, // 数字 7/8/9、加 KC_P4 , KC_P5 , KC_P6 , KC_PPLS, // 数字 4/5/6、加 KC_P1 , KC_P2 , KC_P3 , KC_PENT, // 数字 1/2/3、回车 KC_P0 , KC_P0 , KC_PDOT, KC_PENT // 0双键位、小数点、回车 ),第一行是媒体控制KC_MPLY播放/暂停、KC_MUTE静音、KC_VOLD/KC_VOLU音量加减依赖features.extrakey的开启。其余区域是标准数字小键盘数字 0–9、四则运算符号、小数点与回车其中0和Enter各占两个矩阵位保证网格布局下左右两侧都方便按到。第 1 层Fn 层RGB 与背光控制[1] LAYOUT_grid( /* FN */ UG_TOGG, UG_NEXT, BL_STEP, BL_BRTG, // RGB 开关/下一模式、背光步进/呼吸 KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, UG_HUEU, UG_SATU, UG_VALU, KC_TRNS, // 色调/饱和度/亮度 UG_HUED, UG_SATD, UG_VALD, KC_TRNS, // 色调/饱和度/亮度 - KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, QK_BOOT, KC_TRNS // QK_BOOT 进入刷写模式 ),第一行与第三、四行覆盖了 RGB 与背光的常用调节UG_TOGGQK_UNDERGLOW_TOGGLE开关 RGB 底灯UG_NEXTQK_UNDERGLOW_MODE_NEXT切换到下一个 RGB 动画模式对应上面启用的 10 种动画UG_HUEU/UG_HUED色相Hue增加/减小UG_SATU/UG_SATD饱和度Saturation增加/减小UG_VALU/UG_VALD亮度Value增加/减小BL_STEPQK_BACKLIGHT_STEP背光亮度步进配合levels: 5的 5 级亮度BL_BRTGQK_BACKLIGHT_TOGGLE_BREATHING开关背光呼吸效果QK_BOOT进入 DFU 刷写模式见下文。这些键码的定义集中在 quantum/keycodes.h如UG_TOGG QK_UNDERGLOW_TOGGLE、BL_STEP QK_BACKLIGHT_STEP其底层实现分别位于 quantum/rgblight/rgblight.crgblight_toggle()、rgblight_step()、rgblight_increase_hue()、rgblight_decrease_hue()、rgblight_increase_sat()、rgblight_decrease_sat()、rgblight_increase_val()、rgblight_decrease_val()等函数以及量子键处理代码中键位层中大量KC_TRNS透明则保证 Fn 层未定义的按键直接沿用底层功能。提示默认键位使用的 RGB 键码是UG_*前缀旧名为RGB_*现已重命名查阅键码时以 quantum/keycodes.h 为准。从编译到刷写CU24 的完整使用流程1. 搭建构建环境QMK 官方推荐使用qmk setup初始化环境CLI 用法详见 docs/cli.md 与 docs/newbs_getting_started.md。CU24 的 readme 给出的构建入口与仓库中所有键盘一致先完成 构建环境搭建再参考 make 使用指南。2. 编译默认固件在仓库根目录执行make capsunlocked/cu24:default这是 readme 给出的标准命令make 键盘路径:键位名。由于 CU24 是数据驱动键盘编译系统会自动从 keyboard.json 生成config.h/rules.mk等中间配置相关机制见 builddefs/build_keyboard.mk 与 docs/data_driven_config.md。3. 自定义键位并编译自定义键位的标准做法是复制默认键位# 将默认键位复制为自己的键位如 mykeymap qmk new-keymap -kb capsunlocked/cu24 # 然后编辑对应 keymap.c 并编译 make capsunlocked/cu24:mykeymap编辑时可以使用LAYOUT_grid(...)或LAYOUT_numpad(...)两种宏若想自己新增一个键位目录参考 keymaps/default/keymap.c 的结构先#include QMK_KEYBOARD_H再定义keymaps[][MATRIX_ROWS][MATRIX_COLS]数组即可。4. 刷写固件CU24 使用atmel-dfu引导程序刷写命令make capsunlocked/cu24:default:flash刷写前先将键盘置于 DFU 模式按住 Fn 层中的QK_BOOT键默认键位第 1 层右下区域或短接 PCB 上的 RESET 触点然后系统会枚举出 DFU 设备make ...:flash会自动调用dfu-programmer完成擦除与写入。详细刷写步骤见 docs/newbs_flashing.md。延伸CU24 在 CapsUnlocked 家族中的定位CU24 只是 CapsUnlocked由 Yiancar 维护系列中的一款。同一keyboards/capsunlocked目录下还有CU77 键迷你小键盘keyboards/capsunlocked/cu7CU6565% 布局键盘含 ANSI、ISO、ISO 分裂退格等多种键位keyboards/capsunlocked/cu65CU7575% 布局键盘含post_rules.mk等额外构建逻辑keyboards/capsunlocked/cu75CU80 v1 / v280% 布局键盘v2 分 ANSI/ISO 两个版本keyboards/capsunlocked/cu80。如果你的目标是数字输入、媒体控制或宏面板CU24 的 24 键小键盘配合双布局与完整灯效控制是一个容易上手且扩展空间充足的起点。【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表