硬件开发嵌入式【免费下载链接】crkbdCorne keyboard, a split keyboard with 3x6 column staggered keys and 3 thumb keys.项目地址https://gitcode.com/gh_mirrors/cr/crkbd点击查看免费下载Corne Classiccrkbd rev1是 Corne 系列的经典焊接版分体键盘采用 3x6 列交错配列与每侧 3 枚拇指键兼容 Cherry MX 类轴体与 ProMicro 主控。本文以 docs/corne-classic/buildguide_jp.md 为主体结合仓库中的英文版指南与 rev1 固件文档完整讲解从零件采购、二极管/LED/ProMicro 焊接、ProMicro 插座化、动作确认到固件刷写与故障排查的全流程读完后即可独立完成一台 Corne Classic 的组装与点亮。一、Corne Classic 在项目中的定位根据 README.md 的描述Corne 是一款基于 Helix 的分体键盘split keyboard拥有 3x6 列交错主键区加每侧 3 枚拇指键单侧 21 键、双侧共 42 键。Corne Classic 属于旧版本Old versions系列对应 v1 焊接版Soldering专为 Cherry MX 兼容轴设计是 Corne 家族中结构最简单、最适合作为入门焊接练习的版本。后续的 corne-cherry / corne-chocolate / corne-light 版本在 PCB 布局、热插拔Hotswap支持与低轮廓low profile适配上有明显演进本文所有内容仅适用于rev1 对应的 corne-classic 焊接版使用其他型号如 v2/v3/v4 热插拔版时请以对应目录下的构建指南为准。二、零件清单必须零件| 名称 | 数量 | 备注 | |:-|:-|:-| | PCB | 2 枚 | 左右各一 | | 定位板Plate | 2 套 | | | ProMicro | 2 枚 | 左右各一 | | TRRS 插孔 | 2 个 | | | TRS3 极线缆 | 1 根 | TRRS4 极线缆亦可 | | 轻触开关复位用 | 2 个 | | | 二极管 | 42 个 | 低轮廓low profile方案仅可使用表面贴装SMD型 | | 键开关 | 42 个 | 对应 42 键 | | 键帽 | 42 个 | 1u × 40、1.5u × 2 | | 铜柱 M2 7.5mm | 10 根 | 低轮廓方案改用 4.5mm | | 铜柱 M2 9mm 或 11mm | 4 根 | 用于 OLED 高度的适配 | | 螺丝 M2 | 28 个 | 14 根铜柱每根 2 个螺丝 | | 防滑橡胶脚垫 | 10 个 | |其中 42 个二极管、42 个键开关与 42 个键帽正好对应键盘双侧共 42 键10 根 7.5mm 铜柱加 4 根 9/11mm 铜柱共 14 根配合 28 个 M2 螺丝用于固定上下板。可选零件| 名称 | 数量 | 备注 | |:-|:-|:-| | OLED 模块 | 1 ~ 2 枚 | | | 4 连引脚排针公 | 2 个 | 使用 OLED 模块时需要 | | 4 连引脚插座母 | 2 个 | 使用 OLED 模块时需要 | | SK6812MINI LED | 54 个 | 向上安装 42 个、向下安装 12 个 | | 可寻址 LED 灯带 | 2 根 | 与 SK6812MINI 方案互斥不可同时使用 |SK6812MINI 的分配逻辑与 PCB 上的 LED 编号对应每侧 27 个 LED 中编号 7~27共 21 个为键位背光、编号 1~6共 6 个为底光underglow两侧合计恰好 54 个。三、事前准备先搭建固件构建环境自建固件需要安装 QMK 工具链、交叉编译环境等耗时较长日文指南明确建议在拿到元件之前最先着手避免焊接完成后被环境搭建拖延。固件构建与刷写的完整说明见 docs/firmware/rev1/firmware_jp.md如果不打算自建固件也可以直接使用预编译固件见后文“固件刷写”章节这样就不需要在本阶段搭建环境。四、组装焊接步骤PCB 是可逆reversible设计两块 PCB 完全相同组装前需先决定哪一块作为左手侧、哪一块作为右手侧。后续所有焊接均按这一分配进行。4.1 二极管不使用低轮廓键开关标准 Cherry MX 方案按丝印位置焊接二极管。二极管可以装在任意一面但若要安装底光underglowLED为避免干涉建议将二极管装在表面front side。即使不用低轮廓键开关使用表面贴装型二极管也完全没有问题。二极管具有极性必须对准 PCB 丝印的方向焊反会导致该键无法触发。仓库的 KiCad 封装库 pcbs/common/kbd/kicad-footprints/kbd.pretty 中提供了二极管1N4148与轴座的封装对应 3D 模型含 1N4148.step可用来核对安装方向。使用低轮廓键开关low profile 方案若改用低轮廓键开关必须使用表面贴装型二极管并且必须安装在背面back side如果装到表面二极管会与顶板top plate发生干涉。SMD 二极管同样有极性丝印的横线一侧需对准 PCB 丝印的横线一侧。4.2 LED可选编号 7 ~ 27键位背光安装在键开关下方光面朝上表面方向发光编号 1 ~ 6底光安装在背面实现 underglow 效果。安装位置与编号布局以 PCB 丝印为准。对于 7~27 号 LED统一从背面back side安装以丝印的“○”标记为基准确定方向——有些版本 PCB如 corne-cherry v2把“○”标记替换为某个焊盘周围的白框但定位原理相同。1~6 号底光 LED 的焊接较为特殊需要把器件侧面微微露出的引脚照片中粉色标识的图案与 PCB 上的焊盘图案蓝色标识焊接在一起。技巧是先涂助焊剂再用烙铁蘸取少量焊锡按压在图案的接缝处即可完成桥接。LED 点灯检查各 LED 按照照片上的编号串联连接如果点亮到中途停止故障点大概率出在未能点亮的那个 LED 或它前一个 LED的安装上可按此方向排查。注意默认固件中 LED 是关闭的测试前需先在固件中开启方法见后文“LED 点亮”章节。4.3 OLED 模块的跳线可选使用 OLED 模块时需要按图短接jumperPCB 上的跳线焊盘。务必注意只在表面front side短接背面不可短接否则会导致 OLED 或主控供电异常。4.4 TRRS 插孔、复位开关、OLED 引脚插座可选按照片位置焊接 TRRS 插孔与复位轻触开关使用 OLED 时同时焊接 4 连引脚插座母座。TRRS 插孔用于左右手之间的通信复位开关用于将 ProMicro 切入 bootloader 模式以刷写固件。4.5 ProMicro 主控先把引脚排针pin header焊接到 PCB 表面白色边框内的孔位然后将 ProMicro背面朝上压入排针焊接。照片示例为右手侧左手侧方法完全相同白色边框内焊排针、ProMicro 背面朝上。焊接前务必确认是白色边框内那组孔而非邻近孔位因为 ProMicro 拆焊非常困难也建议在焊接前先确认 ProMicro 本身工作正常可先刷入固件再上板。ProMicro 的封装与 3D 模型均包含在仓库通用封装库中ProMicro.kicad_mod 与 ProMicro.step排针 1x4 的模型见 pin-header-1x4.step。4.6 OLED 模块将引脚排针焊到 OLED 模块上再把 OLED 插入 PCB 上的引脚插座。铜柱高度需要根据引脚插座与排针的总高度调节照片示例使用市面上常见的引脚插座 排针 11mm 铜柱组合。若使用更矮的排针如随 OLED 附带的矮排针可换用 9mm 铜柱以获得更薄的整机高度。4.7 ProMicro 的插座化可选把 ProMicro 做成“可插拔”可以显著降低维修成本——主控损坏时无需拆焊整块 ProMicro直接替换即可。日文指南介绍了两种方案。方案 A使用弹簧针排针Spring Loaded Header弹簧针排针是一种特殊的可插拔排针其使用方式可参考 Helix 键盘的构建指南Pro Micro 一节。在日本市场游舎工房Yusha-Kobo有售“弹簧针排针 ProMicro”套装。若同时使用游舎工房销售的 OLED 附带的矮排针则 ProMicro 与 OLED 可以无缝隙整齐收纳并可使用9mm 铜柱整体更薄。方案 B使用低矮引脚插座使用秋月电子等商店可购得的低矮引脚插座如 12 连引脚插座商品编号 C-03138需要少量手工准备 2 个 12 连引脚插座固定在面包板breadboard等基座上用 ProMicro 自带的排针将 ProMicro 夹住排针与 ProMicro 上下夹持从上方用力插入引脚插座将排针与 ProMicro 焊接牢固后剪掉多余的排针引脚即完成。两种方案对比从高度上看弹簧针排针方案整体更矮配合 9mm 铜柱两种方案的成品高度差异可直接对比。此外游舎工房随 OLED 附带的排针比普通排针矮这是 OLED 装配能更薄的关键。4.8 动作确认焊接后、装轴前必做强烈建议在安装键开关之前完成动作确认——装轴之后再发现问题返工难度极大。流程如下先按后文“固件刷写”章节把 crkbd 固件刷入 ProMicro使用默认键映射时OLED 会实时显示被按下按键的信息用镊子或一小段焊锡丝短接键开关的焊接焊盘OLED 上应出现对应的按键触发信息若安装了 LED确认所有 LED 均能点亮。英文版指南 docs/corne-classic/buildguide_en.md 进一步说明OLED 会显示按下的行列坐标例如1x5、0x2逐个短接每个开关焊盘并确认显示变化若有按键无响应记下失效的“行 x 列”坐标对后续排查非常有帮助。4.9 键开关与顶板在键开关与 PCB 之间夹入顶板top plate然后从表面安装键开关并焊接。顶板的作用是固定轴体并决定按键手感与外观本仓库提供了多种顶板设计文件见文末“仓库资源导航”。4.10 底板先安装铜柱低轮廓方案使用 4.5mm 铜柱其他方案使用 7.5mm 铜柱英文版指南记载低轮廓为 3mm具体以所购套件说明为准随后安装底板。最后在底板四角等位置贴上6 个防滑橡胶脚垫。4.11 键帽最后安装键帽1u × 40、1.5u × 2即完成全部组装。五、固件刷写固件刷写的完整步骤见 docs/firmware/rev1/firmware_jp.md适用于 Corne v1~v3 / rev1 硬件即本文的 corne-classic。左右两块 PCB 都需要分别刷写固件。5.1 通过 Remap 刷写推荐最简便且被官方推荐的方案是使用 Remap 在线工具选择crkbd:via固件进行刷写连接 ProMicro 到电脑进入刷写模式后按页面指引完成然后对另一侧重复同样操作。5.2 通过 QMK Toolbox 刷写使用 QMK Toolbox 桌面工具获取 VIA 版固件crkbd_rev1_via.hex预编译产物可在项目配套的 kbd_firmware 固件仓库获取在 QMK Toolbox 中通过 “Open” 指定该文件将键盘通过 USB 连接到电脑按下复位开关或短接 ProMicro 的 GND 与 RST 引脚进入 bootloader观察到写入成功信息即完成然后对另一侧重复。5.3 使用 VIA 修改键映射刷入 VIA 版固件后即可通过 VIA 网页应用直接修改键位映射无需重新编译固件适合日常按键自定义。5.4 自行构建固件可选自建固件需要搭建 QMK 环境工作量较大这也是日文指南建议“提前准备”的原因。自建方式可参考项目配套的 kbd_firmware 固件仓库构建完成后同样需要为左右两侧各刷写一次。六、LED 点亮与常见故障排查6.1 开启 LED 背光如前述默认固件中 LED 处于关闭状态。据 docs/corne-classic/buildguide_en.md 记载需要在固件工程的keyboards/crkbd/keymaps/default/rules.mk文件顶部加入RGBLIGHT_ENABLE yes然后重新编译并刷写两侧。焊接无误时所有 LED 应点亮并呈现红色若默认固件下 LED 呈现其他颜色说明 LED 数据链路在某处损坏应检查最先变色的那颗 LED 之前的链路。6.2 所有 LED 不亮先确认固件中已开启 LED 功能若已开启仍全灭问题大概率出在第一颗 LED上按下一节方法检查。6.3 部分 LED 不亮排查第一颗不亮的 LED 或其前一颗 LED重点检查LED 是否焊接正确、焊盘连接是否可靠LED 方向是否装反对照丝印“○”标记由于第一颗 LED 是背对 PCB 焊接的可先借助 7~27 号 LED 的朝向确认正误若上述均正常可能是焊接过程损坏了 LED可直接替换或用万用表的二极管档对比其他正常 LED 的四个焊盘引脚测量值测量同一引脚组合读数不一致即为损坏或虚焊。6.4 整行 / 整列按键失效整行整列失效基本可以断定是PCB 与 ProMicro 之间的连接出了问题检查焊接质量、确认 ProMicro 焊接在正确的白色框孔位若焊接无误可能是 ProMicro 损坏。可用一段导线直接短接 ProMicro 的行引脚与列引脚来排除 PCB 走线、二极管的问题——行引脚与列引脚短接应能触发对应按键部分 PCB 丝印会标注行/列引脚。6.5 随机个别按键失效个别按键失效通常意味着按键与 ProMicro 之间存在断点可能出现在键开关与 PCB 之间、键开关与热插拔座之间若用、热插拔座与 PCB 之间、按键到 ProMicro 路径上的二极管、PCB 内部走线。排查顺序已装轴则检查轴体焊点热插拔座检查是否有弯脚、插座焊接是否可靠目视检查 PCB从 ProMicro 到二极管到按键的走线如有划伤或破损可用导线飞线绕过损坏段例如直接把 ProMicro 连到二极管第一脚验证若飞线后按键恢复可保留飞线或修复走线刮开破损两侧阻焊、酒精清洁后补焊PCB 正常则检查二极管先看焊接再用万用表二极管档比对正常键位二极管读数注意二极管有极性无万用表时可用镊子/焊锡丝短接二极管两侧焊盘若此时按键能触发说明该二极管或焊接有问题重新焊接或更换二极管。七、仓库资源导航组装指南本文件docs/corne-classic/buildguide_jp.md日文、docs/corne-classic/buildguide_en.md英文含 LED 开启与详细故障排查固件指南docs/firmware/rev1/firmware_jp.md、docs/firmware/rev1/firmware_en.md适用于 v1~v3 / rev1docs/firmware/rev4 适用于 v4 系列定位板设计PCB 版含 Cherry MX 与 ALPS 两种轴型的顶板/底板见 plates/3x6/pcb可输出 Gerber 文件的加工包见 plates/3x6/pcb/jlcpcb/production_files矢量图含泡沫垫层见 plates/3x6/svgKiCad 通用封装库pcbs/common/kbd/kicad-footprints/kbd.pretty含 ProMicro.kicad_mod、keyswitch_cherrymx_alps_1u.kicad_mod、LED_WS2812B-PLCC4.kicad_mod 等、3D 模型见 pcbs/common/kbd/kicad-packages3D/kbd.3dshapes、原理图符号见 pcbs/common/kbd/kicad-symbols/kbd.kicad_sym综上Corne Classic 的组装核心可概括为先搭固件环境、严格按极性焊二极管、区分正反面焊 LED、ProMicro 白色框内背面朝上安装、装轴前务必动作确认最后为两侧分别刷入固件。掌握以上流程后结合本文的排查清单即使出现焊接问题也能系统定位修复。赞分享硬件开发嵌入式【免费下载链接】crkbdCorne keyboard, a split keyboard with 3x6 column staggered keys and 3 thumb keys.项目地址https://gitcode.com/gh_mirrors/cr/crkbd点击查看免费下载相关推荐Corne Light v1 分体键盘组装指南从零件清单到固件刷写的完整手工焊接教程Corne Light v1 分体键盘组装指南从零件清单到固件刷写的完整手工焊接教程 本指南依据 docs/corne light/v1/buildguide硬件开发嵌入式Corne Cherry v3 热插拔分体键盘完整组装指南从元件清单、焊接工艺到固件刷写Corne Cherry v3 热插拔分体键盘完整组装指南从元件清单、焊接工艺到固件刷写 Corne Cherry v3 是 crkbdCorne Keyb硬件开发嵌入式Corne Cherry v2 组装指南Cherry MX 热插拔分体键盘的完整焊接与固件刷写实战Corne Cherry v2 组装指南Cherry MX 热插拔分体键盘的完整焊接与固件刷写实战 Corne Cherry v2Hotswap是 Cor硬件开发嵌入式上一篇Picovoice快速入门5分钟搭建你的第一个离线语音交互应用下一篇Popsicle高效并行的USB设备烧录工具创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考