PolyKybd 开源键盘项目搭建与配置指南

PolyKybd 开源键盘项目搭建与配置指南

PolyKybd PolyKybd 项目地址: https://gitcode.com/gh_mirrors/po/PolyKybd

1. 项目目录结构及介绍

PolyKybd 是一个开源的机械键盘项目，特别是其独特的 Split72 设计，每个键帽内嵌有 OLED 显示屏。以下是对该项目主要目录结构的解析：

• poly_kybd: 包含了PCB相关的设计文件，如KiCad项目，用于制作电路板。
  • Gerber: 存放了PCB制造所需的Gerber文件，包括左右两边的电路板设计。
  • Plate: 提供了铝制键盘板的Gerber文件，适合通过PCB制造商生产。
• case: 包含了键盘外壳的3D打印或CNC加工所需模型文件（STL格式），以及用来确保适当间距的spacer模型。
• LICENSE: 许可证文件，表明项目遵循CERN-OHL-W-2.0许可。
• README.md: 项目的主要读我文件，包含了项目简介、硬件需求、构建指导和如何获取套件的信息。
• gitignore: Git忽略文件，定义了哪些文件不应被版本控制系统跟踪。
• 其他辅助文件: 如图片、说明文档等。

2. 项目的启动文件介绍

本项目不直接有一个“启动”文件来运行软件，因为硬件项目与传统意义上的软件启动不同。但关键入口点可以视作是物理构建过程的起点，即从下载代码和设计文件开始：

• 对于希望编译和调整固件的人来说，重要的是找到对应的QMK固件仓库（位于 https://github.com/thpoll83/qmk_firmware/tree/PolyKeyboard），这是控制键盘逻辑的核心部分。
• 构建硬件时，首要步骤是从poly_kybd目录中获取最新版的PCB Gerber文件，这些文件用于制造电路板。

3. 项目的配置文件介绍

配置过程更多地体现在硬件组装和固件定制上，而非独立的配置文件。

固件配置

• QMK固件: 虽不是直接在PolyKybd仓库中，但要自定义键盘的行为，需编辑QMK固件中的.ino文件或使用QMK Configurator在线工具来设置按键映射和其他功能。
• 硬件配置:
  • 在实际构建过程中，用户可能需要修改Gerber文件以适应特定的需求，比如更改LED配置或添加额外的功能。
  • 配置还包括选择合适的部件，如键帽、开关以及显示屏，并根据提供的物料清单(BOM)准备所有必需的电子元件。

为了更深入地配置和构建这个项目，用户应详细阅读仓库中的README.md文件，了解如何获取套件、如何准备必要的零件，以及如何进行固件的个性化设置。固件的调整通常意味着进入QMK固件仓库进行相应的修改和编译，然后将编译好的固件烧录到硬件中，完成项目的激活和定制。

PolyKybd PolyKybd 项目地址: https://gitcode.com/gh_mirrors/po/PolyKybd