QMK 固件指南1upkeyboards pi60 可焊 60% 键盘的构建、刷写与多布局配置【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware本指南以 QMK 仓库中 1upkeyboards/pi60 的 readme 为主体结合 keyboard.json、默认键位映射 与 矩阵图 等仓库源码系统讲解 pi60 这块可焊 60% PCB 的固件构建、刷写、进入 Bootloader 以及底层布局配置。读完本文你将能独立完成 pi60 固件的编译与烧录并理解其 ANSI/ISO/tsangan、Split Space、三位置编码器等核心配置的实现方式。板卡概览可焊 60% PCB 的多布局能力pi60 是 1upkeyboards 出品的一块可焊solderable60% PCB其核心卖点是数百万种配置组合——除了常见的 ANSI、ISO、tsangan 标准布局外还支持多种 split-shift 与 split-space 配置并预留了三个可能的编码器位置。板载21 颗 RGB 底灯underglow并兼容众多 o-ring mount硅胶减震挂装外壳。在连接方式上PCB 提供三种形态标准 USB、外部 I2C 连接器用于外接扩展设备以及daughterboard 连接器子板式 USB-C 接口常见于许多客制化外壳。相关链接pi60 官方说明文档 与 pi60 矩阵图同一目录下。硬件信息速查来自 keyboard.json从 keyboard.json 可以提取出官方声明的主要硬件参数项目值制造商1upkeyboards维护者ziptyze主控 MCURP2040板型GENERIC_RP_RP2040Bootloaderrp2040RP2040 原生 USB 引导USB VID / PID0x6F75/0x5604设备版本1.0.0二极管方向COL2ROW列驱动、行扫描RGB 灯条WS2812引脚 GP17vendor 驱动共 21 颗支持睡眠动态键位层数10 层dynamic_keymap.layer_count: 10编码器3 个旋转编码器位置GP4/GP3、GP22/GP2、GP23/GP24固件层面启用的特性包括bootmagicBootmagic 键位功能、encoder旋转编码器、extrakey媒体/系统键、mousekey鼠标键与rgb_matrixRGB 矩阵并开启了 QMK locking含 resync支持未启用 NKROnkro: false。构建固件make 命令与键位目标在搭建好 QMK 构建环境后为 pi60 编译默认键位固件的命令是make 1upkeyboards/pi60:default其中1upkeyboards/pi60是键盘在 QMK 仓库中的路径对应 keyboards/1upkeyboards/pi60 目录default是该键盘下 keymaps/default 目录中的默认键位方案。若需构建自定义键位只需把default替换为你自己的 keymap 目录名例如make 1upkeyboards/pi60:mykeymap。刷写固件编译并直接烧录到键盘使用:flash后缀make 1upkeyboards/pi60:default:flash由于 pi60 使用 RP2040 主控与rp2040bootloaderQMK 会采用 RP2040 的 USB 引导流程进入 Bootloader 后表现为可拖拽固件的 USB 存储设备具体工具链由 QMK CLI 依据 bootloader 类型自动选择。若你是 QMK 新手建议先阅读仓库内的 构建环境搭建指南本仓库中对应 docs/getting_started_introduction.md 与 docs/newbs.md 也提供了从零开始的入门指引以及 make 命令使用说明。进入 Bootloader 的两种方式pi60 的 readme 明确给出了两种进入引导模式的方法Bootmagic resetBootmagic 复位按住矩阵 (0,0) 位置对应的键通常是左上角第一个键或 Escape的同时插入 USB 线。从 matrix_diagram.md 可以看到矩阵坐标00正是第一行第一列的位置与默认键位 keymap.c 中KC_ESC的绑定一致这与 readme 中通常是 Escape 键的描述互相印证。Bootloader 按钮按住 PCB 背面的实体按钮再插入 USB 线。两种方式都要求按住后插入电源属于上电瞬间触发的引导模式适用于刷写失败后强制恢复的场景。布局体系从 LAYOUT_all 到 11 种社区布局pi60 支持极为丰富的配列keyboard.json 中声明了 11 种 community layouts60_ansi、60_ansi_arrow、60_ansi_split_bs_rshift、60_ansi_tsangan、 60_ansi_tsangan_split_bs_rshift、60_hhkb、60_iso、60_iso_arrow、 60_iso_split_bs_rshift、60_iso_tsangan、60_iso_tsangan_split_bs_rshift同时通过layout_aliases将LAYOUT_60_tsangan_hhkb指向LAYOUT_60_ansi_tsangan_split_bs_rshift方便兼容旧命名。超级布局 LAYOUT_all除了上述社区布局keyboard.json 中还定义了覆盖所有焊盘的LAYOUT_all超级布局其矩阵行/列被完整标注列colsGP5, GP8, GP11, GP6, GP7, GP0, GP26, GP10, GP9, GP1, GP18, GP20, GP21, GP27, GP28, GP19共 16 列行rowsGP12, GP13, GP16, GP25, GP29共 5 行LAYOUT_all覆盖了含 split backspace、split right shift、split space1U/0.75U 间隙/多段空格以及 ISO 双键位在内的全部焊点位置可焊板用户可按需焊接任意组合。以默认键位 keymap.c 为例其第 0 层使用LAYOUT_all实现了标准的 ANSI 主键区并预留了KC_TRNS透明占位说明该层布局可按焊盘配置裁剪。三位置旋转编码器引脚与默认键位映射pi60 支持3 个旋转编码器位置在 keyboard.json 的encoder.rotary中声明编码器A 引脚B 引脚位置 1GP4GP3位置 2GP22GP2位置 3GP23GP24编码器需要固件支持因此在 keymaps/default/rules.mk 中显式开启ENCODER_MAP_ENABLE yes开启后keymap.c 通过ENCODER_MAP_ENABLE条件编译段定义encoder_map三个编码器在第 0 层统一映射为音量控制[0] { ENCODER_CCW_CW(KC_VOLD, KC_VOLU), ENCODER_CCW_CW(KC_VOLD, KC_VOLU), ENCODER_CCW_CW(KC_VOLD, KC_VOLU) },其余层保持KC_TRNS透明方便用户在各层自定义编码器行为。这套encoder_map机制由 QMK 的编码器模块quantum/encoder驱动属于 QMK 通用能力pi60 只是按硬件位置声明了引脚并开启特性。21 颗 RGB 底灯ws2812 引脚与动画配置底灯数据通过GP17以 vendor厂商驱动的 WS2812 协议输出keyboard.json 中rgb_matrix.layout按 x/y 坐标列出了 21 颗 LED 的物理位置并开启sleep睡眠时自动熄灭。同时启用了 26 种 RGB 矩阵动画包括渐变类gradient_up_down、gradient_left_right、breathing波段类band_sat、band_val、band_pinwheel_sat、band_pinwheel_val、band_spiral_sat、band_spiral_val循环类cycle_all、cycle_left_right、cycle_up_down、cycle_out_in、cycle_out_in_dual、cycle_pinwheel、cycle_spiral信标/雨滴类dual_beacon、rainbow_beacon、rainbow_pinwheels、raindrops、jellybean_raindrops、pixel_rain、pixel_flow色相类hue_breathing、hue_pendulum、hue_wave从默认键位的第 2 层可以看到这些动画的调用入口——keymap.c 在第 2 层将RM_TOGG、RM_NEXT、RM_HUEU/RM_HUED、RM_SATU/RM_SATD、RM_VALU/RM_VALD、RM_SPDU/RM_SPDD以及RGB_M_P、RGB_M_B、RGB_M_R、RGB_M_SW、RGB_M_SN、RGB_M_K、RGB_M_X、RGB_M_G等 RGB 控制键位安排在中排与下排实现了免刷固件的开关、切模式、调色相/饱和度/亮度/速度等操作。这些RM_*键码由rgb_matrix特性quantum/rgb_matrix提供。矩阵接线图解读matrix_diagram.md 以 ASCII 图形式标出了全部焊点与矩阵坐标的对应关系第一行00 ~ 0E共 15 个位置其中0D支持 2U 退格Backspace或 1U1U 的 split backspace0D与0E分别为两个 1U 键0E同时可作编码器位第二行10 ~ 1D其中1D可作编码器位第三行2F为 Caps 位置2C/2D支持 ISO Enter 或 1U/1.25U 的 split enter 两种焊接方式第四行3F为 2.25U 左 Shift3B/3C/3E可组成 1U/1.75U/1U 的 split right shift或 1U/0.75U 间隙/1U 的变体3E亦可作编码器位底部行4F/41/42为左 Ctrl/Win/Alt 区支持 6U、6.25U、7U、10U 多种空格长度——7U 空格对应 tsangan/WKL 风格底排10U 空格则对应 HHKB 风格无左/右 Win。这张图是理解LAYOUT_all中每个 matrix 坐标含义的关键也是用户自行焊接不同配列时的直接依据。总结pi60 是 QMK 社区中典型的多配列可焊 60%方案以 RP2040 为主控通过 5 行 16 列矩阵承载包括 split backspace、split right shift、split space、ISO/ANSI/tsangan 在内的全部常见焊盘组合辅以 3 个可选的旋转编码器与 21 颗 WS2812 底灯。构建与刷写仅需两条 make 命令进入 Bootloader 则有 Bootmagic 与背板按钮两种手段。对于想深入了解其底层实现的用户keyboard.json 与 矩阵图 是查阅坐标、引脚与布局定义的第一手资料。【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 QMK 固件指南：1upkeyboards pi60 可焊 60% 键盘的构建、刷写与多布局配置
QMK 固件指南1upkeyboards pi60 可焊 60% 键盘的构建、刷写与多布局配置【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware本指南以 QMK 仓库中 1upkeyboards/pi60 的 readme 为主体结合 keyboard.json、默认键位映射 与 矩阵图 等仓库源码系统讲解 pi60 这块可焊 60% PCB 的固件构建、刷写、进入 Bootloader 以及底层布局配置。读完本文你将能独立完成 pi60 固件的编译与烧录并理解其 ANSI/ISO/tsangan、Split Space、三位置编码器等核心配置的实现方式。板卡概览可焊 60% PCB 的多布局能力pi60 是 1upkeyboards 出品的一块可焊solderable60% PCB其核心卖点是数百万种配置组合——除了常见的 ANSI、ISO、tsangan 标准布局外还支持多种 split-shift 与 split-space 配置并预留了三个可能的编码器位置。板载21 颗 RGB 底灯underglow并兼容众多 o-ring mount硅胶减震挂装外壳。在连接方式上PCB 提供三种形态标准 USB、外部 I2C 连接器用于外接扩展设备以及daughterboard 连接器子板式 USB-C 接口常见于许多客制化外壳。相关链接pi60 官方说明文档 与 pi60 矩阵图同一目录下。硬件信息速查来自 keyboard.json从 keyboard.json 可以提取出官方声明的主要硬件参数项目值制造商1upkeyboards维护者ziptyze主控 MCURP2040板型GENERIC_RP_RP2040Bootloaderrp2040RP2040 原生 USB 引导USB VID / PID0x6F75/0x5604设备版本1.0.0二极管方向COL2ROW列驱动、行扫描RGB 灯条WS2812引脚 GP17vendor 驱动共 21 颗支持睡眠动态键位层数10 层dynamic_keymap.layer_count: 10编码器3 个旋转编码器位置GP4/GP3、GP22/GP2、GP23/GP24固件层面启用的特性包括bootmagicBootmagic 键位功能、encoder旋转编码器、extrakey媒体/系统键、mousekey鼠标键与rgb_matrixRGB 矩阵并开启了 QMK locking含 resync支持未启用 NKROnkro: false。构建固件make 命令与键位目标在搭建好 QMK 构建环境后为 pi60 编译默认键位固件的命令是make 1upkeyboards/pi60:default其中1upkeyboards/pi60是键盘在 QMK 仓库中的路径对应 keyboards/1upkeyboards/pi60 目录default是该键盘下 keymaps/default 目录中的默认键位方案。若需构建自定义键位只需把default替换为你自己的 keymap 目录名例如make 1upkeyboards/pi60:mykeymap。刷写固件编译并直接烧录到键盘使用:flash后缀make 1upkeyboards/pi60:default:flash由于 pi60 使用 RP2040 主控与rp2040bootloaderQMK 会采用 RP2040 的 USB 引导流程进入 Bootloader 后表现为可拖拽固件的 USB 存储设备具体工具链由 QMK CLI 依据 bootloader 类型自动选择。若你是 QMK 新手建议先阅读仓库内的 构建环境搭建指南本仓库中对应 docs/getting_started_introduction.md 与 docs/newbs.md 也提供了从零开始的入门指引以及 make 命令使用说明。进入 Bootloader 的两种方式pi60 的 readme 明确给出了两种进入引导模式的方法Bootmagic resetBootmagic 复位按住矩阵 (0,0) 位置对应的键通常是左上角第一个键或 Escape的同时插入 USB 线。从 matrix_diagram.md 可以看到矩阵坐标00正是第一行第一列的位置与默认键位 keymap.c 中KC_ESC的绑定一致这与 readme 中通常是 Escape 键的描述互相印证。Bootloader 按钮按住 PCB 背面的实体按钮再插入 USB 线。两种方式都要求按住后插入电源属于上电瞬间触发的引导模式适用于刷写失败后强制恢复的场景。布局体系从 LAYOUT_all 到 11 种社区布局pi60 支持极为丰富的配列keyboard.json 中声明了 11 种 community layouts60_ansi、60_ansi_arrow、60_ansi_split_bs_rshift、60_ansi_tsangan、 60_ansi_tsangan_split_bs_rshift、60_hhkb、60_iso、60_iso_arrow、 60_iso_split_bs_rshift、60_iso_tsangan、60_iso_tsangan_split_bs_rshift同时通过layout_aliases将LAYOUT_60_tsangan_hhkb指向LAYOUT_60_ansi_tsangan_split_bs_rshift方便兼容旧命名。超级布局 LAYOUT_all除了上述社区布局keyboard.json 中还定义了覆盖所有焊盘的LAYOUT_all超级布局其矩阵行/列被完整标注列colsGP5, GP8, GP11, GP6, GP7, GP0, GP26, GP10, GP9, GP1, GP18, GP20, GP21, GP27, GP28, GP19共 16 列行rowsGP12, GP13, GP16, GP25, GP29共 5 行LAYOUT_all覆盖了含 split backspace、split right shift、split space1U/0.75U 间隙/多段空格以及 ISO 双键位在内的全部焊点位置可焊板用户可按需焊接任意组合。以默认键位 keymap.c 为例其第 0 层使用LAYOUT_all实现了标准的 ANSI 主键区并预留了KC_TRNS透明占位说明该层布局可按焊盘配置裁剪。三位置旋转编码器引脚与默认键位映射pi60 支持3 个旋转编码器位置在 keyboard.json 的encoder.rotary中声明编码器A 引脚B 引脚位置 1GP4GP3位置 2GP22GP2位置 3GP23GP24编码器需要固件支持因此在 keymaps/default/rules.mk 中显式开启ENCODER_MAP_ENABLE yes开启后keymap.c 通过ENCODER_MAP_ENABLE条件编译段定义encoder_map三个编码器在第 0 层统一映射为音量控制[0] { ENCODER_CCW_CW(KC_VOLD, KC_VOLU), ENCODER_CCW_CW(KC_VOLD, KC_VOLU), ENCODER_CCW_CW(KC_VOLD, KC_VOLU) },其余层保持KC_TRNS透明方便用户在各层自定义编码器行为。这套encoder_map机制由 QMK 的编码器模块quantum/encoder驱动属于 QMK 通用能力pi60 只是按硬件位置声明了引脚并开启特性。21 颗 RGB 底灯ws2812 引脚与动画配置底灯数据通过GP17以 vendor厂商驱动的 WS2812 协议输出keyboard.json 中rgb_matrix.layout按 x/y 坐标列出了 21 颗 LED 的物理位置并开启sleep睡眠时自动熄灭。同时启用了 26 种 RGB 矩阵动画包括渐变类gradient_up_down、gradient_left_right、breathing波段类band_sat、band_val、band_pinwheel_sat、band_pinwheel_val、band_spiral_sat、band_spiral_val循环类cycle_all、cycle_left_right、cycle_up_down、cycle_out_in、cycle_out_in_dual、cycle_pinwheel、cycle_spiral信标/雨滴类dual_beacon、rainbow_beacon、rainbow_pinwheels、raindrops、jellybean_raindrops、pixel_rain、pixel_flow色相类hue_breathing、hue_pendulum、hue_wave从默认键位的第 2 层可以看到这些动画的调用入口——keymap.c 在第 2 层将RM_TOGG、RM_NEXT、RM_HUEU/RM_HUED、RM_SATU/RM_SATD、RM_VALU/RM_VALD、RM_SPDU/RM_SPDD以及RGB_M_P、RGB_M_B、RGB_M_R、RGB_M_SW、RGB_M_SN、RGB_M_K、RGB_M_X、RGB_M_G等 RGB 控制键位安排在中排与下排实现了免刷固件的开关、切模式、调色相/饱和度/亮度/速度等操作。这些RM_*键码由rgb_matrix特性quantum/rgb_matrix提供。矩阵接线图解读matrix_diagram.md 以 ASCII 图形式标出了全部焊点与矩阵坐标的对应关系第一行00 ~ 0E共 15 个位置其中0D支持 2U 退格Backspace或 1U1U 的 split backspace0D与0E分别为两个 1U 键0E同时可作编码器位第二行10 ~ 1D其中1D可作编码器位第三行2F为 Caps 位置2C/2D支持 ISO Enter 或 1U/1.25U 的 split enter 两种焊接方式第四行3F为 2.25U 左 Shift3B/3C/3E可组成 1U/1.75U/1U 的 split right shift或 1U/0.75U 间隙/1U 的变体3E亦可作编码器位底部行4F/41/42为左 Ctrl/Win/Alt 区支持 6U、6.25U、7U、10U 多种空格长度——7U 空格对应 tsangan/WKL 风格底排10U 空格则对应 HHKB 风格无左/右 Win。这张图是理解LAYOUT_all中每个 matrix 坐标含义的关键也是用户自行焊接不同配列时的直接依据。总结pi60 是 QMK 社区中典型的多配列可焊 60%方案以 RP2040 为主控通过 5 行 16 列矩阵承载包括 split backspace、split right shift、split space、ISO/ANSI/tsangan 在内的全部常见焊盘组合辅以 3 个可选的旋转编码器与 21 颗 WS2812 底灯。构建与刷写仅需两条 make 命令进入 Bootloader 则有 Bootmagic 与背板按钮两种手段。对于想深入了解其底层实现的用户keyboard.json 与 矩阵图 是查阅坐标、引脚与布局定义的第一手资料。【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考