拓冰网站定制 
QMK Firmware 实战Ishi 80 Mk 0 键盘的 Elite-C 扩展版固件mk0_avr_extra编译、刷写与定制指南【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmwareIshi 80 Mk 0 是一款配备 SouthPaw左手方向键位与镜像小键盘Mirrored Numpad的 60% 布局客制化键盘。本指南围绕 QMK Firmware 仓库中该键盘的mk0_avr_extra固件变体展开讲解其硬件兼容性前提、构建与刷写命令、Bootloader 进入方式并结合仓库内的keyboard.json、默认键位与编码器映射源码深入解析矩阵定义、功能开关、旋钮与 OLED 扩展的底层实现。读完本文你将掌握如何为本键盘编译、刷写固件并能按需定制键位层、编码器动作与开机 Logo。硬件与固件变体背景Ishi 80 Mk 0 在 QMK 仓库中以argo_works/ishi/80为键盘目录包含两个固件变体mk0_avr面向标准 Pro Micro 引脚兼容子板不支持编码器与 OLED 功能mk0_avr_extra本文主题面向拥有底部 5 个额外引脚的 ATMega32U4 子板如 Elite-C额外支持旋转编码器与 OLED 显示屏。mk0_avr_extra的 readme.md 中明确给出了关键兼容性警告本固件仅适用于基于 ATMega32U4 且底部带 5 个额外引脚的子板如 Elite-C与标准 Pro Micro 引脚布局的子板不兼容。选购或改装子板时务必核对引脚定义避免烧录后按键矩阵或扩展功能失效。其余基础信息键盘维护者MaintainerJason Devadossjasonj2232该信息同时写入 keyboard.json 的maintainer字段硬件支持Ishi 80 Mk 0 Elite-C 引脚布局子板硬件购买渠道官方文档标注为未公开Hardware Availability:-。编译与刷写在搭建好 QMK 构建环境后编译默认键位固件make argo_works/ishi/80/mk0_avr_extra:default刷写固件到子板make argo_works/ishi/80/mk0_avr_extra:default:flash其中argo_works/ishi/80/mk0_avr_extra是键盘在仓库中的完整路径default是目标键位keymap名称对应仓库中的 keymaps/default。构建时 QMK 会依据该键盘目录下的 keyboard.json 自动生成矩阵扫描、USB 描述符与功能开关配置无需手写config.h与rules.mk除默认键位目录下的个别选项外。数据驱动的键盘配置解析mk0_avr_extra采用 QMK 的数据驱动配置Data-Driven Configuration模式全部硬件参数集中在 keyboard.json 中USB 标识与开发板development_board: elite_c, pin_compatible: elite_c, usb: { device_version: 0.0.1, pid: 0x4930, vid: 0x4157 }development_board/pin_compatible声明使用 Elite-C 引脚映射这也是本变体与 Pro Micro 版 mk0_avrdevelopment_board: promicro在配置层最直观的差异USB VID/PID 为0x4157/0x4930设备版本0.0.1编译后固件以此标识枚举为键盘设备。矩阵引脚与二极管方向diode_direction: COL2ROW, matrix_pins: { cols: [D3, F4, F5, F6, F7, D7, C6, D4, D2], rows: [B3, B1, B6, B2, F0, F1, B5, B4, E6] }矩阵为 9 列 × 9 行采用 COL2ROW列扫描、行读入二极管方向。对比标准版 mk0_avr 的矩阵配置可以发现扩展版将第 4、5 行的引脚从D1/D0调整为F0/F1——这正对应 Elite-C 与 Pro Micro 在底部额外引脚上的差异也是两个固件变体必须分开维护的直接原因。功能开关featuresfeatures: { bootmagic: true, extrakey: true, mousekey: true, nkro: true, encoder: true, oled: true, wpm: true }相比标准版mk0_avr_extra额外启用了encoder旋转编码器、oledOLED 显示屏与wpm打字速度统计三项功能extrakey与mousekey分别提供多媒体键与鼠标键能力nkro启用无冲N-Key Rollover。这些功能开关决定了最终固件中会链接哪些量子模块quantum/与驱动代码。Bootmagic 矩阵位置bootmagic: { matrix: [1, 0] }本键盘将 Bootmagic 触发键设置在矩阵坐标[1, 0]即键位布局中左上角第一颗键位于 x0,y0默认键位下为小键盘的KC_PMNS键与 keyboard.json 中LAYOUT布局第一条记录{matrix: [1, 0], x: 0, y: 0}完全对应。文档中所述“Bootmagic reset 需按住矩阵 (0,0) 处的键”是基于通用说明的近似描述实际以本键盘配置的[1, 0]为准。旋转编码器定义encoder: { rotary: [ {pin_a: B7, pin_b: D5} ] }编码器 A/B 相分别接在B7与D5引脚上。编码器的行为映射并不在此定义而是由键位目录中的编码器映射Encoder Map决定详见下文。默认键位与层结构默认键位源码位于 keymaps/default/keymap.c定义了BLBase Layer基础层与ULUpper Layer上层两个自定义层基础层BLSouthPaw 镜像小键盘左侧小键盘区KC_PMNS、KC_PAST、KC_PSLS、KC_NUM、KC_PPLS、KC_P9~KC_P1、KC_PENT、KC_PDOT、KC_P0等完整小键盘键位镜像排布在键盘左侧主键区KC_ESC与数字行KC_1~KC_0、KC_MINS、KC_EQL、KC_BSPC字母区KC_Q~KC_P、KC_A~KC_QUOT、KC_Z~KC_SLSH修饰与特殊键KC_CAPS_LOCK、KC_LSFT/KC_RSFT、KC_LCTL、KC_LGUI、KC_RALT、KC_RGUI、KC_APP、KC_RCTL层切换键空格左侧使用LT(1, KC_LALT)——按住进入 UL 层并透传左 Alt单击则仍输出 Alt实现层切换与按键复用多媒体键最右侧为KC_AUDIO_MUTE静音。上层UL功能键层[UL] LAYOUT( KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_GRAVE, KC_F1, KC_F2, ... KC_TRNS, ..., KC_PSCR, KC_SCRL, KC_PAUS, ... ... KC_TRNS, ..., KC_UP, KC_TRNS, ..., KC_TRNS, KC_LEFT, KC_DOWN, KC_RIGHT, KC_MPLY ),主键区与字母区全部为KC_TRNS透传沿用基础层行为数字行映射为KC_F1~KC_F12配合KC_GRAVE反引号与KC_DEL提供笔记本式功能键体验右侧小键盘区补全KC_PSCR、KC_SCRL、KC_PAUS方向键集中在右下角KC_UP、KC_LEFT、KC_DOWN、KC_RIGHT最右侧为KC_MPLY播放/暂停。编码器映射Encoder Map默认键位目录下的 rules.mk 仅一行用于开启编码器映射ENCODER_MAP_ENABLE yes开启后keymap.c 中通过ENCODER_MAP_ENABLE条件编译块按层定义旋钮行为const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][NUM_DIRECTIONS] { [BL] { ENCODER_CCW_CW(KC_VOLD, KC_VOLU) }, [UL] { ENCODER_CCW_CW(KC_BRID, KC_BRIU) }, };基础层BL逆时针旋转减小音量KC_VOLD顺时针增大音量KC_VOLU上层UL逆时针降低屏幕亮度KC_BRID顺时针提高亮度KC_BRIU。通过这种“按键复用层切换 按层切换编码器行为”的组合单个旋钮即可在不同层中承担音量与亮度两种职责是 60% 小配列键盘常见的扩展思路。OLED 开机 Logo 的实现mk0_avr_extra目录下的 mk0_avr_extra.c 是键盘级keyboard-levelC 代码在OLED_ENABLE条件下实现开机 Logo 渲染使用static const char PROGMEM raw_logo[]存放预生成的位图数据通过oled_write_raw_P(raw_logo, sizeof(raw_logo))直接写入显存避免逐像素绘图带来的性能开销重写oled_task_kb()键盘级任务钩子先调用oled_task_user()键位级用户钩子在其返回false时立即退出表示用户层已接管渲染否则渲染 Logo 并返回true。这种“kb 钩子委托 user 钩子”的写法是 QMK OLED 扩展的标准协作模式用户可在自己的 keymap 中覆盖oled_task_user()增加自定义内容而无需改动键盘级代码。进入 Bootloader 的三种方式mk0_avr_extra的 readme.md 提供了三种进入刷写模式Bootloader的方法Bootmagic 复位按住矩阵坐标[1, 0]处的按键布局左上角第一颗键的同时插入 USB 线供电。注意本键盘的 Bootmagic 矩阵位置在 keyboard.json 中被显式配置为[1, 0]物理复位按键短按 PCB 背面的复位按钮部分 PCB 没有实体按钮需要用镊子短接对应焊盘键位中的复位键码在键位中放置QK_BOOT旧称RESET键码并按下。默认键位未包含该键码可在自定义 keymap 中自行加入。刷写固件时使用前文给出的make argo_works/ishi/80/mk0_avr_extra:default:flash配合 QMK 的自动复位流程即可完成烧录。拓展与定制建议更换键位复制keymaps/default目录创建自己的 keymap修改层定义与编码器映射后以make argo_works/ishi/80/mk0_avr_extra:你的键位名编译旋钮行为如需新增功能如KC_MUTE、翻页、缩放等保持ENCODER_MAP_ENABLE yes在encoder_map中替换ENCODER_CCW_CW(...)的参数即可OLED 内容在个人 keymap 中实现oled_task_user()自定义显示内容键位状态、WPM 等mk0_avr_extra.c中的键盘级实现会自动让位于用户级渲染子板选型务必使用 Elite-C 引脚兼容的 ATMega32U4 子板若使用标准 Pro Micro 引脚子板请改用同目录下的 mk0_avr 固件变体并注意该变体不支持编码器与 OLED。以上所有配置与代码均可直接在仓库中查看keyboard.json、keymaps/default/keymap.c、keymaps/default/rules.mk 与 mk0_avr_extra.c可作为理解 QMK 数据驱动配置、Elite-C 扩展引脚利用、编码器映射与 OLED 键盘级渲染的完整参考案例。【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 QMK Firmware 实战：Ishi 80 Mk 0 键盘的 Elite-C 扩展版固件（mk0_avr_extra）编译、刷写与定制指南
QMK Firmware 实战Ishi 80 Mk 0 键盘的 Elite-C 扩展版固件mk0_avr_extra编译、刷写与定制指南【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmwareIshi 80 Mk 0 是一款配备 SouthPaw左手方向键位与镜像小键盘Mirrored Numpad的 60% 布局客制化键盘。本指南围绕 QMK Firmware 仓库中该键盘的mk0_avr_extra固件变体展开讲解其硬件兼容性前提、构建与刷写命令、Bootloader 进入方式并结合仓库内的keyboard.json、默认键位与编码器映射源码深入解析矩阵定义、功能开关、旋钮与 OLED 扩展的底层实现。读完本文你将掌握如何为本键盘编译、刷写固件并能按需定制键位层、编码器动作与开机 Logo。硬件与固件变体背景Ishi 80 Mk 0 在 QMK 仓库中以argo_works/ishi/80为键盘目录包含两个固件变体mk0_avr面向标准 Pro Micro 引脚兼容子板不支持编码器与 OLED 功能mk0_avr_extra本文主题面向拥有底部 5 个额外引脚的 ATMega32U4 子板如 Elite-C额外支持旋转编码器与 OLED 显示屏。mk0_avr_extra的 readme.md 中明确给出了关键兼容性警告本固件仅适用于基于 ATMega32U4 且底部带 5 个额外引脚的子板如 Elite-C与标准 Pro Micro 引脚布局的子板不兼容。选购或改装子板时务必核对引脚定义避免烧录后按键矩阵或扩展功能失效。其余基础信息键盘维护者MaintainerJason Devadossjasonj2232该信息同时写入 keyboard.json 的maintainer字段硬件支持Ishi 80 Mk 0 Elite-C 引脚布局子板硬件购买渠道官方文档标注为未公开Hardware Availability:-。编译与刷写在搭建好 QMK 构建环境后编译默认键位固件make argo_works/ishi/80/mk0_avr_extra:default刷写固件到子板make argo_works/ishi/80/mk0_avr_extra:default:flash其中argo_works/ishi/80/mk0_avr_extra是键盘在仓库中的完整路径default是目标键位keymap名称对应仓库中的 keymaps/default。构建时 QMK 会依据该键盘目录下的 keyboard.json 自动生成矩阵扫描、USB 描述符与功能开关配置无需手写config.h与rules.mk除默认键位目录下的个别选项外。数据驱动的键盘配置解析mk0_avr_extra采用 QMK 的数据驱动配置Data-Driven Configuration模式全部硬件参数集中在 keyboard.json 中USB 标识与开发板development_board: elite_c, pin_compatible: elite_c, usb: { device_version: 0.0.1, pid: 0x4930, vid: 0x4157 }development_board/pin_compatible声明使用 Elite-C 引脚映射这也是本变体与 Pro Micro 版 mk0_avrdevelopment_board: promicro在配置层最直观的差异USB VID/PID 为0x4157/0x4930设备版本0.0.1编译后固件以此标识枚举为键盘设备。矩阵引脚与二极管方向diode_direction: COL2ROW, matrix_pins: { cols: [D3, F4, F5, F6, F7, D7, C6, D4, D2], rows: [B3, B1, B6, B2, F0, F1, B5, B4, E6] }矩阵为 9 列 × 9 行采用 COL2ROW列扫描、行读入二极管方向。对比标准版 mk0_avr 的矩阵配置可以发现扩展版将第 4、5 行的引脚从D1/D0调整为F0/F1——这正对应 Elite-C 与 Pro Micro 在底部额外引脚上的差异也是两个固件变体必须分开维护的直接原因。功能开关featuresfeatures: { bootmagic: true, extrakey: true, mousekey: true, nkro: true, encoder: true, oled: true, wpm: true }相比标准版mk0_avr_extra额外启用了encoder旋转编码器、oledOLED 显示屏与wpm打字速度统计三项功能extrakey与mousekey分别提供多媒体键与鼠标键能力nkro启用无冲N-Key Rollover。这些功能开关决定了最终固件中会链接哪些量子模块quantum/与驱动代码。Bootmagic 矩阵位置bootmagic: { matrix: [1, 0] }本键盘将 Bootmagic 触发键设置在矩阵坐标[1, 0]即键位布局中左上角第一颗键位于 x0,y0默认键位下为小键盘的KC_PMNS键与 keyboard.json 中LAYOUT布局第一条记录{matrix: [1, 0], x: 0, y: 0}完全对应。文档中所述“Bootmagic reset 需按住矩阵 (0,0) 处的键”是基于通用说明的近似描述实际以本键盘配置的[1, 0]为准。旋转编码器定义encoder: { rotary: [ {pin_a: B7, pin_b: D5} ] }编码器 A/B 相分别接在B7与D5引脚上。编码器的行为映射并不在此定义而是由键位目录中的编码器映射Encoder Map决定详见下文。默认键位与层结构默认键位源码位于 keymaps/default/keymap.c定义了BLBase Layer基础层与ULUpper Layer上层两个自定义层基础层BLSouthPaw 镜像小键盘左侧小键盘区KC_PMNS、KC_PAST、KC_PSLS、KC_NUM、KC_PPLS、KC_P9~KC_P1、KC_PENT、KC_PDOT、KC_P0等完整小键盘键位镜像排布在键盘左侧主键区KC_ESC与数字行KC_1~KC_0、KC_MINS、KC_EQL、KC_BSPC字母区KC_Q~KC_P、KC_A~KC_QUOT、KC_Z~KC_SLSH修饰与特殊键KC_CAPS_LOCK、KC_LSFT/KC_RSFT、KC_LCTL、KC_LGUI、KC_RALT、KC_RGUI、KC_APP、KC_RCTL层切换键空格左侧使用LT(1, KC_LALT)——按住进入 UL 层并透传左 Alt单击则仍输出 Alt实现层切换与按键复用多媒体键最右侧为KC_AUDIO_MUTE静音。上层UL功能键层[UL] LAYOUT( KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_GRAVE, KC_F1, KC_F2, ... KC_TRNS, ..., KC_PSCR, KC_SCRL, KC_PAUS, ... ... KC_TRNS, ..., KC_UP, KC_TRNS, ..., KC_TRNS, KC_LEFT, KC_DOWN, KC_RIGHT, KC_MPLY ),主键区与字母区全部为KC_TRNS透传沿用基础层行为数字行映射为KC_F1~KC_F12配合KC_GRAVE反引号与KC_DEL提供笔记本式功能键体验右侧小键盘区补全KC_PSCR、KC_SCRL、KC_PAUS方向键集中在右下角KC_UP、KC_LEFT、KC_DOWN、KC_RIGHT最右侧为KC_MPLY播放/暂停。编码器映射Encoder Map默认键位目录下的 rules.mk 仅一行用于开启编码器映射ENCODER_MAP_ENABLE yes开启后keymap.c 中通过ENCODER_MAP_ENABLE条件编译块按层定义旋钮行为const uint16_t PROGMEM encoder_map[][NUM_ENCODERS][NUM_DIRECTIONS] { [BL] { ENCODER_CCW_CW(KC_VOLD, KC_VOLU) }, [UL] { ENCODER_CCW_CW(KC_BRID, KC_BRIU) }, };基础层BL逆时针旋转减小音量KC_VOLD顺时针增大音量KC_VOLU上层UL逆时针降低屏幕亮度KC_BRID顺时针提高亮度KC_BRIU。通过这种“按键复用层切换 按层切换编码器行为”的组合单个旋钮即可在不同层中承担音量与亮度两种职责是 60% 小配列键盘常见的扩展思路。OLED 开机 Logo 的实现mk0_avr_extra目录下的 mk0_avr_extra.c 是键盘级keyboard-levelC 代码在OLED_ENABLE条件下实现开机 Logo 渲染使用static const char PROGMEM raw_logo[]存放预生成的位图数据通过oled_write_raw_P(raw_logo, sizeof(raw_logo))直接写入显存避免逐像素绘图带来的性能开销重写oled_task_kb()键盘级任务钩子先调用oled_task_user()键位级用户钩子在其返回false时立即退出表示用户层已接管渲染否则渲染 Logo 并返回true。这种“kb 钩子委托 user 钩子”的写法是 QMK OLED 扩展的标准协作模式用户可在自己的 keymap 中覆盖oled_task_user()增加自定义内容而无需改动键盘级代码。进入 Bootloader 的三种方式mk0_avr_extra的 readme.md 提供了三种进入刷写模式Bootloader的方法Bootmagic 复位按住矩阵坐标[1, 0]处的按键布局左上角第一颗键的同时插入 USB 线供电。注意本键盘的 Bootmagic 矩阵位置在 keyboard.json 中被显式配置为[1, 0]物理复位按键短按 PCB 背面的复位按钮部分 PCB 没有实体按钮需要用镊子短接对应焊盘键位中的复位键码在键位中放置QK_BOOT旧称RESET键码并按下。默认键位未包含该键码可在自定义 keymap 中自行加入。刷写固件时使用前文给出的make argo_works/ishi/80/mk0_avr_extra:default:flash配合 QMK 的自动复位流程即可完成烧录。拓展与定制建议更换键位复制keymaps/default目录创建自己的 keymap修改层定义与编码器映射后以make argo_works/ishi/80/mk0_avr_extra:你的键位名编译旋钮行为如需新增功能如KC_MUTE、翻页、缩放等保持ENCODER_MAP_ENABLE yes在encoder_map中替换ENCODER_CCW_CW(...)的参数即可OLED 内容在个人 keymap 中实现oled_task_user()自定义显示内容键位状态、WPM 等mk0_avr_extra.c中的键盘级实现会自动让位于用户级渲染子板选型务必使用 Elite-C 引脚兼容的 ATMega32U4 子板若使用标准 Pro Micro 引脚子板请改用同目录下的 mk0_avr 固件变体并注意该变体不支持编码器与 OLED。以上所有配置与代码均可直接在仓库中查看keyboard.json、keymaps/default/keymap.c、keymaps/default/rules.mk 与 mk0_avr_extra.c可作为理解 QMK 数据驱动配置、Elite-C 扩展引脚利用、编码器映射与 OLED 键盘级渲染的完整参考案例。【免费下载链接】qmk_firmwareOpen-source keyboard firmware for Atmel AVR and Arm USB families项目地址: https://gitcode.com/GitHub_Trending/qm/qmk_firmware创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考