btrfld 项目使用与启动教程

btrfld 项目使用与启动教程

btrfld a folding, tenting wireless keyboard 项目地址: https://gitcode.com/gh_mirrors/bt/btrfld

1. 项目介绍

btrfld 是一个开源项目，旨在打造一款可折叠、便携式的键盘，名为“butter-fold”。该项目包含两种版本：标准版 btrfld 和超薄版 btrfld ulp。btrfld 标准版采用 choc 开关，厚度约为 22.5 毫米；而 btrfld ulp 版本则采用 Cherry MX ULP 开关，厚度仅为 15.5 毫米。两款键盘都具备以下特点：

• 5 键 dactyl-manuform-mini 拇指集群
• 平坦、可帐篷式折叠的 qwerty 键盘
• 6 个可映射的额外按键
• 可选蓝牙功能
• 可折叠设计，便于携带

2. 项目快速启动

硬件材料准备

• 2 x btrfld_pcb
• 1 x btrfld_pcb_center
• 2 x btrfld_pcb_thumb
• 46 个 choc v1 开关或 46 个 Cherry MX ULP 开关
• 1N4148W SOD-323F 二极管
• 3mm 直径不锈钢棒（不同长度多根）
• 1.27mm 扁平 ribbon cable
• 9 芯线缆 2 x 13cm，6 芯线缆 2 x 9.6cm
• nicenano 或 bluemicro840 控制器（若不需要蓝牙，也可选择 promicro）

软件与工具

• KiCad（用于 PCB 设计）
• FreeCAD（用于 3D 设计）
• ZMK 固件（用于键盘固件编译与烧录）

快速启动步骤

1. 根据项目提供的 CAD 文件，使用 FreeCAD 打印出所需的 3D 零件。
2. 使用 KiCad 完成 PCB 设计，并制作出所需的电路板。
3. 焊接开关、二极管、平行线等组件到电路板上。
4. 连接控制器和中心电路板，使用扁平 ribbon cable 连接左右手部分。
5. 烧录 ZMK 固件到控制器上，完成键盘配置。

3. 应用案例和最佳实践

案例一：便携式办公

btrfld 键盘由于其可折叠的设计，非常适合作为便携式办公设备。无论是在咖啡店、图书馆还是户外，用户都可以快速展开键盘，开始高效工作。

案例二：露营与户外活动

在户外露营时，携带一个传统的键盘显得笨重且不实用。btrfld 键盘轻巧便携，可以在户外环境下为用户提供舒适的打字体验。

最佳实践

• 在使用前，确保所有连接都已正确焊接，且无短路或断路现象。
• 使用时，保持键盘平稳，避免在键盘折叠处施加过多压力。
• 定期清理键盘，保持键帽清洁，以延长使用寿命。

4. 典型生态项目

btrfld 项目可以与其他开源项目结合，形成更加丰富的生态。例如，可以配合开源的操作系统如 Linux 使用，或者集成到开源的智能家居系统中，作为控制终端。此外，btrfld 项目还可以与其他开源硬件项目如 Raspberry Pi 结合，为用户提供更多可能性。

btrfld a folding, tenting wireless keyboard 项目地址: https://gitcode.com/gh_mirrors/bt/btrfld