从零构建 ATSET AT16基于 QMK 的 4×4 十六键小键盘固件编译、刷写与 Bootloader 指南【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmwareATSET AT16 是一款由 QMK 驱动的特殊 16 键小键盘采用 4×4 正交阵列与 ATmega32U4 主控硬件尚处 Interest Check 阶段。本篇以仓库中的 AT16 支持文档 为主体结合 keyboard.json 与默认键位 keymap.c 的源码细节完整讲解固件编译、刷写以及三种进入 Bootloader 的方式读完即可在本地环境中亲手构建并烧录该键盘的固件。键盘速览硬件与软件事实AT16 在 QMK 仓库中的全部定义位于keyboards/atset/at16/目录核心事实如下Keyboard Maintainer维护者ATSET仓库 readme 中指向维护者个人主页仓库内不包含二次开发所需的其他作者信息Hardware Supported硬件支持ATmega32U4Hardware Availability硬件可用性Interest Check意向调查阶段尚未量产发售从 keyboard.json 可以确认其底层配置处理器processoratmega32u4Bootloaderatmel-dfuATmega32U4 常见的 DFU 引导程序USB 标识VID0xFEED、PID0x6060、设备版本0.0.1矩阵结构4 列 × 4 行共 16 键列引脚B6/B5/B4/B2行引脚D3/D2/D1/D0二极管方向COL2ROW布局声明了社区通用布局ortho_4x4即 4×4 正交布局值得一提的是ATSET 系列在仓库中还包含 AT1、AT3、AT6、AT9、AT12 等同族键盘见 keyboards/atset 目录它们共享相同的 ATmega32U4 平台、相同的 USB VID/PID 与特性开关只是键数与矩阵规模不同。AT16 正是该系列中键位最多的 4×4 型号其布局宏LAYOUT_ortho_4x4是community_layouts中声明与键盘定义一致的社区布局。编译固件make atset/at16:default在完成构建环境搭建之后编译该键盘默认键位固件的命令为make atset/at16:default命令格式为make 键盘路径:键位名atset/at16对应键盘目录default对应 keymaps/default 下的默认键位。需要特别注意AT16 的官方文档原文中给出的示例命令为make atset/at3:default这明显是模板残留与 AT3 的文档完全相同实际编译 AT16 固件时应使用make atset/at16:default。同理刷写命令应为make atset/at16:default:flash。编译产物会包含 AVR 固件镜像hex 文件等供后续通过 DFU 方式写入主控。构建环境准备QMK 构建环境涉及编译器工具链、Python 依赖与 QMK CLI。仓库内相关说明文档包括newbs.md面向新手的完整入门指南涵盖环境搭建的第一步getting_started_make_guide.mdmake命令的详细用法包括目标target与键位keymap的选择方式newbs_flashing.md刷写固件的完整流程说明faq_build.md常见编译问题的排查清单若尚未搭建环境建议按上述文档顺序依次阅读先安装 QMK CLI 与工具链再执行编译与刷写。刷写固件make atset/at16:default:flash在编译命令后追加:flash目标即可编译并自动进入刷写流程make atset/at16:default:flash由于该键盘的 Bootloader 配置为atmel-dfuQMK 会调用配套的 DFU 刷写工具如dfu-programmer完成固件写入。刷写前需确保键盘已进入 Bootloader 模式见下文并确认系统已正确安装 DFU 驱动Windows 下可参考 driver_installation_zadig.md 使用 Zadig 安装驱动。三种进入 Bootloader 的方式AT16 支持以下三种进入 Bootloader 的方式官方文档原文完整列出Bootmagic resetBootmagic 复位按住矩阵中(0,0)位置的按键通常是左上角键或 Esc 键的同时插入 USB 线。Physical reset button物理复位按键短按 PCB 背面的复位按钮部分 PCB 可能没有独立按键而是需要短接的焊盘。Keycode in layout布局中的键码按下映射了QK_BOOT键码的按键前提是该键位存在于当前布局中。其中QK_BOOT是 QMK 内置的 Bootloader 跳转键码可在键位映射中直接使用。默认键位 keymap.c 中并未放置QK_BOOT因此实际使用中主要依赖前两种硬件方式Bootmagic 或物理复位或自行修改键位添加该键码。bootmagic功能默认启用这在 keyboard.json 的features中有明确声明bootmagic: true这也是第 1 种方式能够生效的前提。默认键位剖析F 键与数字键的实用组合默认键位定义在 keymaps/default/keymap.c采用LAYOUT_ortho_4x4宏共声明了 3 个图层但仅第 0 层填充了实际按键第 1、2 层全部为KC_NO空按键第 0 层默认层键位分布行 \ 列Col 0Col 1Col 2Col 3Row 0KC_F10KC_F11KC_F12KC_F5Row 1KC_7KC_8KC_9KC_F1Row 2KC_4KC_5KC_6KC_F2Row 3KC_1KC_2KC_3KC_F3这一布局将 1~9 数字键与 F1~F3、F5、F10~F12 功能键组合在一起非常适合作为宏键盘、数字输入面板或媒体/快捷键辅助板使用。KC_*是 QMK 的标准键码对应 HID 键盘用法可参考 keycodes.md 与 keycodes_basic.md 查询完整键码表。特性配置解析keyboard.json 中的功能开关keyboard.json 的features段集中声明了该键盘启用的功能bootmagicBootmagic 复位/配置功能支持通过按住特定键开机进入特殊模式commandQMK 命令行调试功能开机时通过LSHIFTRSHIFT组合进入可用于调试与配置console控制台输出功能配合printf调试信息与 faq_debug.md 使用extrakey多媒体/系统控制键支持音量、播放、电源等mousekey鼠标键支持通过键盘模拟鼠标移动与点击nkroN 键无冲NKRO支持同时按下多个按键且不产生冲突此外qmk.locking段声明了enabled: true与resync: true启用 QMK 的锁定键Caps Lock/Num Lock/Scroll Lock状态跟踪与重同步支持。这些特性均以 contenteditable="false">【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
