QMK 固件中的 Boardrun Bizarre正交线性 65% 键盘的布局设计与构建指南【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmwareBoardrun Bizarre 是 QMK 固件仓库qmk_firmware中一款支持正交线性ortholinear配列、带列间错位columnar stagger的 65% 键盘。它以 Alice 布局为灵感、从 Boardwalk 配列演化而来独特之处在于采用标准错位键帽套装即可在正交网格上完成组装同时提供 ANSI、ISO、分离退格等多种布局宏。本文将以 keyboards/boardrun/bizarre/readme.md 为主体结合 keyboard.json 与默认键位图源码讲解其设计理念、硬件配置、布局宏差异以及编译刷写方法帮助你快速上手或移植该键盘。Boardrun 家族从 Boardwalk 演化而来的正交线性配列Boardrun 是一个键盘家族包含Classic与Bizarre两款成员共享正交线性 列间错位的核心设计并都借鉴了 Alice 布局的思路Classic60% 配列为兼容 Ergodox 键帽套装而设计Bizarre65% 配列改用标准错位键帽即可在正交排列中使用键帽兼容性更广。按 readme 的说明Boardrun 是 Boardwalk 配列的进化Boardwalk 证明了 Ergodox 键帽可以适配更紧凑、布局更灵活的键盘而 Boardrun 在此基础上综合了当前错位设计的趋势、Ergodox 键帽布局以及 Boardwalk 最流行的配列最终确定了带**字母区旋转alpha rotation**的列错位正交线性布局并采用了 Boardwalk 的 HHKB 方案。最终形成两个既舒适、熟悉又与主流键帽套装兼容性极好的配列。仓库中两个型号共享同一套工程结构keyboards/boardrun/bizarre/Bizarrekeyboards/boardrun/classic/Classic每款都采用数据驱动的keyboard.json描述硬件配合keymaps/default/keymap.c提供默认键位。硬件规格从 keyboard.json 看 Bizarre 的实现细节Bizarre 的硬件全部由 keyboards/boardrun/bizarre/keyboard.json 声明核心信息如下配置项值说明keyboard_nameBoardrun Bizarre键盘名称manufacturershensmobile制造商maintainerQMK Community维护者processoratmega32u4AVR 主控QMK 支持的 Atmel AVR 系列bootloaderatmel-dfu刷写引导方式VID / PID0xCDCD / 0x5339USB 标识Classic 为 0xCDCD:0x5338debounce10去抖动毫秒数matrix_pins17 列 × 5 行矩阵引脚映射diode_directionCOL2ROW二极管方向列到行ws2812.pinB7RGB 灯带数据引脚rgblight.led_count15RGB 灯珠数量矩阵采用 5 行F0, F1, F4, F5, F6× 17 列F7, C7, C6, B6, B5, B4, D7, D6, D4, D5, D3, D2, D1, D0, B3, B2, B1的 COL2ROW 结构这与 Classic 完全一致说明两款 PCB 使用了相同的扫描骨架差异主要在键位布局宏层面。在功能特性上keyboard.json默认启用了bootmagic上电时通过快捷键进入刷写模式等魔法功能command调试命令extrakey多媒体/系统键支持nkro全键无冲rgblightRGB 灯效并打开了breathing、rainbow_mood、rainbow_swirl、snake、knight、christmas、static_gradient、rgb_test、alternating、twinkle等 10 种动画同时qmk.locking开启并启用resyncCaps Lock 等锁定键状态同步。注意mousekey被显式关闭若需要鼠标键功能可在键位工程或rules.mk中另行启用。四种布局宏all / ansi / split_bs / isoBizarre 在keyboard.json的layouts中定义了 4 个布局宏分别对应不同键帽配列习惯LAYOUT_all最完整形态包含所有物理键位右 Shift 与方向键共存、分离退格等默认键位图即使用此宏LAYOUT_ansi标准 ANSI 回车、2.25u 左 Shift、2u 退格LAYOUT_split_bs分离退格两个键代替单个退格LAYOUT_isoISO 回车w:1.25, h:2的 Enter、#/\ISO 键与 1.25u 左 Shift。同一物理键位在不同宏中拥有不同的x/y坐标与w/h宽度/高度属性这正是正交物理布局 不同键帽配列得以实现的关键矩阵坐标决定电路连接而视觉坐标只影响配列呈现。例如 row 2 的右端在LAYOUT_all中为 1u 的[2,13]键在 ANSI 变体中则合并为 2.25u 宽的单键见 keyboard.json 中LAYOUT_ansi第 191 行附近的[2,14]。从物理网格看字母区明显分为左右两块中间空出 2.5 个单位宽度这与 Alice 风格的双手内倾设计一致左半区x从 0 到 7.75右半区x从 10.25 到 20中间留白正好容纳大拇指区/空格。默认键位图解析两层布局的实际用法默认键位位于 keyboards/boardrun/bizarre/keymaps/default/keymap.c包含两层_BIZARRE基础层采用LAYOUT_all_FNBIZARRE功能层通过MO(_FNBIZARRE)按住进入。基础层亮点KC_HOME/KC_END被安排在左上角传统 65% 上的功能键位置KC_LSFT旁保留KC_NUBS\键、KC_NUHS#键以覆盖 ISO 用户需求空格拆分为左KC_SPC与右KC_SPC两个键位右下角布置KC_LEFT / KC_DOWN / KC_RGHT方向键。这与 Classic 的方向键置于右下思路一脉相承。功能层则提供F1–F12功能键QK_BOOT复位进引导加载程序见左上角与W键下方KC_INS、KC_PSCR、KC_SCRL、KC_PAUS、KC_MENU等编辑/系统键KC_PGUP / KC_PGDN / KC_HOME / KC_END翻页与光标定位键。QK_BOOT的键位随 PCB 刷写版本可能不同因此 readme 提示无论固件里是否配置了QK_BOOT都可以通过 PCB 底部的复位按键进入刷写模式。作为对比Classic 的默认键位keyboards/boardrun/classic/keymaps/default/keymap.c展示了 Ergodox 键帽兼容方案的风格使用了RSFT_T(KC_ENT)右 Shift 兼回车、LSFT_T(KC_NUBS)、RALT_T(KC_SPC)等层间/组合键技巧而 Bizarre 因采用标准键帽键位更接近主流 65% 习惯。编译与刷写一行命令烧录固件在配置好 QMK 构建环境后Bizarre 的编译命令为make boardrun/bizarre:default刷写命令为make boardrun/bizarre:default:flash其中boardrun/bizarre是键盘目录路径对应 keyboards/boardrun/bizarre/:default指默认键位工程keymaps/default。atmel-dfu引导加载程序配合make ...:flash即可将固件写入主控。进入刷写模式有两种途径按 PCB 底部的复位按键触发固件中配置的QK_BOOT快捷键默认键位图功能层已提供。若你持有的是 Boardrun Classic则对应执行make boardrun/classic:default与make boardrun/classic:default:flash。相关资源键盘 readmekeyboards/boardrun/bizarre/readme.md硬件定义keyboards/boardrun/bizarre/keyboard.json默认键位keyboards/boardrun/bizarre/keymaps/default/keymap.c家族兄弟型号keyboards/boardrun/classic/构建环境与 make 说明docs/getting_started_make_guide.md、docs/newbs_building_firmware.md如果希望在 Bizarre 上自定义配列可以参照默认键位复制一份 keymap或在LAYOUT_all基础上按需切换到LAYOUT_ansi/LAYOUT_split_bs/LAYOUT_iso宏从而在不改动 PCB 的前提下适配不同键帽套装。【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
QMK 固件中的 Boardrun Bizarre正交线性 65% 键盘的布局设计与构建指南【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmwareBoardrun Bizarre 是 QMK 固件仓库qmk_firmware中一款支持正交线性ortholinear配列、带列间错位columnar stagger的 65% 键盘。它以 Alice 布局为灵感、从 Boardwalk 配列演化而来独特之处在于采用标准错位键帽套装即可在正交网格上完成组装同时提供 ANSI、ISO、分离退格等多种布局宏。本文将以 keyboards/boardrun/bizarre/readme.md 为主体结合 keyboard.json 与默认键位图源码讲解其设计理念、硬件配置、布局宏差异以及编译刷写方法帮助你快速上手或移植该键盘。Boardrun 家族从 Boardwalk 演化而来的正交线性配列Boardrun 是一个键盘家族包含Classic与Bizarre两款成员共享正交线性 列间错位的核心设计并都借鉴了 Alice 布局的思路Classic60% 配列为兼容 Ergodox 键帽套装而设计Bizarre65% 配列改用标准错位键帽即可在正交排列中使用键帽兼容性更广。按 readme 的说明Boardrun 是 Boardwalk 配列的进化Boardwalk 证明了 Ergodox 键帽可以适配更紧凑、布局更灵活的键盘而 Boardrun 在此基础上综合了当前错位设计的趋势、Ergodox 键帽布局以及 Boardwalk 最流行的配列最终确定了带**字母区旋转alpha rotation**的列错位正交线性布局并采用了 Boardwalk 的 HHKB 方案。最终形成两个既舒适、熟悉又与主流键帽套装兼容性极好的配列。仓库中两个型号共享同一套工程结构keyboards/boardrun/bizarre/Bizarrekeyboards/boardrun/classic/Classic每款都采用数据驱动的keyboard.json描述硬件配合keymaps/default/keymap.c提供默认键位。硬件规格从 keyboard.json 看 Bizarre 的实现细节Bizarre 的硬件全部由 keyboards/boardrun/bizarre/keyboard.json 声明核心信息如下配置项值说明keyboard_nameBoardrun Bizarre键盘名称manufacturershensmobile制造商maintainerQMK Community维护者processoratmega32u4AVR 主控QMK 支持的 Atmel AVR 系列bootloaderatmel-dfu刷写引导方式VID / PID0xCDCD / 0x5339USB 标识Classic 为 0xCDCD:0x5338debounce10去抖动毫秒数matrix_pins17 列 × 5 行矩阵引脚映射diode_directionCOL2ROW二极管方向列到行ws2812.pinB7RGB 灯带数据引脚rgblight.led_count15RGB 灯珠数量矩阵采用 5 行F0, F1, F4, F5, F6× 17 列F7, C7, C6, B6, B5, B4, D7, D6, D4, D5, D3, D2, D1, D0, B3, B2, B1的 COL2ROW 结构这与 Classic 完全一致说明两款 PCB 使用了相同的扫描骨架差异主要在键位布局宏层面。在功能特性上keyboard.json默认启用了bootmagic上电时通过快捷键进入刷写模式等魔法功能command调试命令extrakey多媒体/系统键支持nkro全键无冲rgblightRGB 灯效并打开了breathing、rainbow_mood、rainbow_swirl、snake、knight、christmas、static_gradient、rgb_test、alternating、twinkle等 10 种动画同时qmk.locking开启并启用resyncCaps Lock 等锁定键状态同步。注意mousekey被显式关闭若需要鼠标键功能可在键位工程或rules.mk中另行启用。四种布局宏all / ansi / split_bs / isoBizarre 在keyboard.json的layouts中定义了 4 个布局宏分别对应不同键帽配列习惯LAYOUT_all最完整形态包含所有物理键位右 Shift 与方向键共存、分离退格等默认键位图即使用此宏LAYOUT_ansi标准 ANSI 回车、2.25u 左 Shift、2u 退格LAYOUT_split_bs分离退格两个键代替单个退格LAYOUT_isoISO 回车w:1.25, h:2的 Enter、#/\ISO 键与 1.25u 左 Shift。同一物理键位在不同宏中拥有不同的x/y坐标与w/h宽度/高度属性这正是正交物理布局 不同键帽配列得以实现的关键矩阵坐标决定电路连接而视觉坐标只影响配列呈现。例如 row 2 的右端在LAYOUT_all中为 1u 的[2,13]键在 ANSI 变体中则合并为 2.25u 宽的单键见 keyboard.json 中LAYOUT_ansi第 191 行附近的[2,14]。从物理网格看字母区明显分为左右两块中间空出 2.5 个单位宽度这与 Alice 风格的双手内倾设计一致左半区x从 0 到 7.75右半区x从 10.25 到 20中间留白正好容纳大拇指区/空格。默认键位图解析两层布局的实际用法默认键位位于 keyboards/boardrun/bizarre/keymaps/default/keymap.c包含两层_BIZARRE基础层采用LAYOUT_all_FNBIZARRE功能层通过MO(_FNBIZARRE)按住进入。基础层亮点KC_HOME/KC_END被安排在左上角传统 65% 上的功能键位置KC_LSFT旁保留KC_NUBS\键、KC_NUHS#键以覆盖 ISO 用户需求空格拆分为左KC_SPC与右KC_SPC两个键位右下角布置KC_LEFT / KC_DOWN / KC_RGHT方向键。这与 Classic 的方向键置于右下思路一脉相承。功能层则提供F1–F12功能键QK_BOOT复位进引导加载程序见左上角与W键下方KC_INS、KC_PSCR、KC_SCRL、KC_PAUS、KC_MENU等编辑/系统键KC_PGUP / KC_PGDN / KC_HOME / KC_END翻页与光标定位键。QK_BOOT的键位随 PCB 刷写版本可能不同因此 readme 提示无论固件里是否配置了QK_BOOT都可以通过 PCB 底部的复位按键进入刷写模式。作为对比Classic 的默认键位keyboards/boardrun/classic/keymaps/default/keymap.c展示了 Ergodox 键帽兼容方案的风格使用了RSFT_T(KC_ENT)右 Shift 兼回车、LSFT_T(KC_NUBS)、RALT_T(KC_SPC)等层间/组合键技巧而 Bizarre 因采用标准键帽键位更接近主流 65% 习惯。编译与刷写一行命令烧录固件在配置好 QMK 构建环境后Bizarre 的编译命令为make boardrun/bizarre:default刷写命令为make boardrun/bizarre:default:flash其中boardrun/bizarre是键盘目录路径对应 keyboards/boardrun/bizarre/:default指默认键位工程keymaps/default。atmel-dfu引导加载程序配合make ...:flash即可将固件写入主控。进入刷写模式有两种途径按 PCB 底部的复位按键触发固件中配置的QK_BOOT快捷键默认键位图功能层已提供。若你持有的是 Boardrun Classic则对应执行make boardrun/classic:default与make boardrun/classic:default:flash。相关资源键盘 readmekeyboards/boardrun/bizarre/readme.md硬件定义keyboards/boardrun/bizarre/keyboard.json默认键位keyboards/boardrun/bizarre/keymaps/default/keymap.c家族兄弟型号keyboards/boardrun/classic/构建环境与 make 说明docs/getting_started_make_guide.md、docs/newbs_building_firmware.md如果希望在 Bizarre 上自定义配列可以参照默认键位复制一份 keymap或在LAYOUT_all基础上按需切换到LAYOUT_ansi/LAYOUT_split_bs/LAYOUT_iso宏从而在不改动 PCB 的前提下适配不同键帽套装。【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
