Chocofi 开源项目安装与配置指南

Chocofi 开源项目安装与配置指南

chocofi Split 36-key keyboard 项目地址: https://gitcode.com/gh_mirrors/ch/chocofi

1. 项目基础介绍

Chocofi 是一个开源的键盘项目，包括键盘盾板和3D打印的外壳，用于与 Arduino ProMicro 类型的控制器配合使用。该键盘为分体式设计，每半边有3行5列共15个按键，加上每半边的3个拇指键，总共36个键。键盘设计考虑了小指列的错位，灵感来源于 Fifi 键盘。本项目使用的是双面电路板，可以分别作为左半边或右半边使用，与 Pro Micro 兼容，且易于打印的FDM友好两款外壳。

项目主要编程语言：C/C++（用于键盘固件编程）。

2. 项目使用的关键技术和框架

• 键盘固件：使用 QMK (Quantum Mechanical Keyboard) 或 ZMK (Zephyr Mechanical Keyboard) 作为键盘固件。
• 电路设计：使用 KiCad 进行电路设计。
• 3D建模：外壳设计使用 CAD 软件进行，文件格式为 STL。
• 编程工具：Arduino IDE 或其他支持 AVR 微控制器的开发环境。

3. 项目安装和配置准备工作

在开始安装和配置之前，请确保您的计算机上安装以下软件和驱动：

• Arduino IDE：用于编译和上传键盘固件，请从官方下载并安装最新版本。
• KiCad：如果需要查看电路板设计或修改，可以从官方下载并安装。
• 3D建模软件：如 Fusion 360 或其他可以打开 STL 文件的软件，用于查看或修改外壳设计。
• 热键切换软件：如 AutoHotkey，用于模拟键盘按键。

详细安装步骤

步骤 1：安装 Arduino IDE

1. 访问 Arduino 官方网站，下载并安装 Arduino IDE。
2. 安装完成后，打开 Arduino IDE，前往“文件”>“首选项”，确保已勾选“显示编译器和上传选项”。
3. 在“工具”>“板”中，选择与你键盘所使用的微控制器相匹配的板型。

步骤 2：安装键盘固件

1. 从 Chocofi 项目中下载固件源代码。
2. 在 Arduino IDE 中，打开下载的固件文件夹中的 .ino 文件。
3. 根据您的键盘配置和按键映射，修改源代码中的相关设置。
4. 使用 Arduino IDE 编译并上传固件到键盘。

步骤 3：安装和配置外壳

1. 下载项目的 STL 文件。
2. 使用 3D 打印机打印外壳部件。
3. 按照项目说明将打印的外壳部件与电路板组合。

步骤 4：配置热键切换软件（可选）

1. 安装 AutoHotkey 或其他热键切换软件。
2. 编写脚本，将键盘的按键映射到计算机上的功能键。

完成以上步骤后，您就可以开始使用您自己组装的 Chocofi 键盘了。如果有任何问题，可以参考项目文档或向项目维护者寻求帮助。

chocofi Split 36-key keyboard 项目地址: https://gitcode.com/gh_mirrors/ch/chocofi