Piantor 键盘项目教程
1. 项目的目录结构及介绍
Piantor 键盘项目的目录结构如下:
piantor/
├── Keebio-Parts.pretty/
├── KiCad-RP-Pico/
├── case/
├── docs/
├── keyswitches.pretty/
├── pcb/
├── .gitmodules
├── LICENSE
├── README.md
目录介绍:
- Keebio-Parts.pretty/: 包含 Keebio 部件的 KiCad 库文件。
- KiCad-RP-Pico/: 包含 Raspberry Pi Pico 的 KiCad 库文件。
- case/: 包含键盘外壳的设计文件。
- docs/: 包含项目的文档,如构建指南和预编译固件。
- keyswitches.pretty/: 包含键开关的 KiCad 库文件。
- pcb/: 包含键盘 PCB 的设计文件。
- .gitmodules: Git 子模块配置文件。
- LICENSE: 项目的开源许可证文件。
- README.md: 项目的介绍和基本信息。
2. 项目的启动文件介绍
Piantor 键盘项目的启动文件主要是固件文件。项目支持多种固件,如 QMK、Vial、KMK 等。启动文件通常位于 docs/
目录下的预编译固件文件中。
启动文件路径:
docs/
├── build_guide.md
├── precompiled_firmware/
│ ├── qmk_firmware/
│ ├── vial_firmware/
│ ├── kmk_firmware/
│ └── ...
└── ...
启动文件介绍:
- qmk_firmware/: 包含 QMK 固件的预编译文件。
- vial_firmware/: 包含基于 QMK 的 Vial 固件的预编译文件。
- kmk_firmware/: 包含 KMK 固件的预编译文件。
3. 项目的配置文件介绍
Piantor 键盘项目的配置文件主要用于定义键盘的布局、键位映射等。配置文件通常位于固件项目的根目录或特定目录下。
配置文件路径:
qmk_firmware/
├── keyboards/
│ ├── piantor/
│ │ ├── config.h
│ │ ├── rules.mk
│ │ ├── keymaps/
│ │ │ ├── default/
│ │ │ │ ├── config.h
│ │ │ │ ├── keymap.c
│ │ │ └── ...
│ │ └── ...
│ └── ...
└── ...
配置文件介绍:
- config.h: 包含键盘的基本配置,如键位数量、布局等。
- rules.mk: 包含编译规则和选项。
- keymaps/: 包含不同键位映射的配置文件。
- default/: 默认键位映射配置。
- config.h: 键位映射的配置文件。
- keymap.c: 键位映射的实现文件。
- default/: 默认键位映射配置。
通过以上配置文件,用户可以自定义键盘的布局和功能。