【DigiKey好物畅享】+Adafruit+RP2040 MacroPad+QMK固件编译+开启VIA改键
前言
最近借助得捷的晒单活动入手了 Adafruit MacroPad RP2040,这块板子性能强劲且自带 OLED 屏幕,非常适合用来做客制化小键盘。虽然默认固件能用,但为了追求极致的自定义体验(改键、宏、灯光),我决定为它重新编译 QMK 固件,并开启 VIA 支持。
本文将带你从零开始:搭建环境 → 编译固件 → 定制 OLED 图案 → 开启 VIA 支持。
第一步:搭建 QMK 编译环境
工欲善其事,必先利其器。我们首先需要配置 QMK 的编译环境。
1.下载工具: 前往 GitHub 下载最新的 QMK MSYS 安装包(Windows 用户选择 .exe 文件)。
链接:Release 1.12.0 · qmk/qmk_distro_msys-自行百度,得捷不允许粘贴多个链接
2.初始化环境: 安装完成后打开 QMK MSYS 终端,输入以下命令并回车:
qmk setup
Tips: 第一次配置环境最好开启魔法(梯子),否则拉取依赖库的速度会非常慢 。等待进度条跑完,出现 “QMK is ready to go” 即表示环境配置完成 。
2. 创建工程与编译器优化
2.1 新建键盘配置
在你的主目录下,进入固件目录并新建一个属于你的 Keymap(配置):
Bash
cd qmk_firmware
qmk new-keymap -kb adafruit/macropad -km jerry_macropad
这行命令的意思是基于 adafruit/macropad 模板,创建一个名为 jerry_macropad 的新配置 。
2.2 使用 VS Code 编辑
推荐使用 VS Code 打开以下路径进行编辑:
C:\Users\你的用户名\qmk_firmware\keyboards\adafruit\macropad
你会在 keymaps 文件夹下看到 jerry_macropad 文件夹,里面包含核心文件 keymap.c 和 rules.mk 。
建议在 VS Code 中为 QMK 创建一个独立的配置文件,避免插件冲突 。


