marbastlib 项目使用教程

marbastlib 项目使用教程

marbastlib A library collecting MX and Choc style footprints, as well as various other parts used to design custom keyboards 项目地址: https://gitcode.com/gh_mirrors/ma/marbastlib

1. 项目介绍

marbastlib 是一个开源的 KiCad 库，专门用于收集 MX 和 Choc 风格的键盘开关脚印以及其他用于设计自定义键盘的各种部件。该项目由 ebastler 和 MarvFPV 维护，旨在为键盘设计师提供一个方便的资源库，包含多种开关、LED、控制器等的符号和脚印。

2. 项目快速启动

安装步骤

1. 打开 KiCad：启动 KiCad 软件。
2. 打开插件和内容管理器：在 KiCad 中，打开“插件和内容管理器”（Plugin and Content Manager，简称 PCM）。
3. 添加新仓库：点击“管理”按钮，然后点击加号（+）添加新仓库。
4. 粘贴仓库 URL：在弹出的窗口中，粘贴以下 URL：

   https://raw.githubusercontent.com/ebastler/ebastler-KiCad-repository/main/repository.json
   

5. 安装 marbastlib：在 PCM 中选择“ebastler KiCad repository”，然后找到并安装 marbastlib。

使用示例

以下是一个简单的示例，展示如何在 KiCad 中使用 marbastlib 库中的符号和脚印：

# 创建一个新的 KiCad 项目
mkdir my_keyboard_project
cd my_keyboard_project
kicad-cli project new my_keyboard_project

# 打开项目并添加 marbastlib 库
kicad-cli project open my_keyboard_project
kicad-cli library add marbastlib

# 在原理图中使用 marbastlib 符号
kicad-cli schematic add symbol marbastlib:MX_SW_solder
kicad-cli schematic add symbol marbastlib:MX_Stab

# 在 PCB 设计中使用 marbastlib 脚印
kicad-cli pcb add footprint marbastlib:SW_MX
kicad-cli pcb add footprint marbastlib:Stab_MX

3. 应用案例和最佳实践

应用案例

• 自定义机械键盘：marbastlib 提供了多种机械键盘开关的脚印和符号，适用于设计各种自定义机械键盘。
• LED 矩阵：库中包含多种 LED 的符号和脚印，适合用于设计 LED 矩阵或背光键盘。
• 控制器集成：提供了多种控制器的符号，如 Arduino Pro Micro、Elite-C 等，方便集成到键盘设计中。

最佳实践

• 版本管理：建议使用最新版本的 KiCad 和 marbastlib，以确保兼容性和最新的功能。
• 测试和反馈：在使用实验性库（如 marbastlib-xp-choc）时，务必进行充分测试，并及时向项目维护者反馈问题。
• 符号和脚印匹配：确保使用的符号和脚印来自同一个库，以避免因引脚编号不一致导致的错误。

4. 典型生态项目

• KiCad：marbastlib 是基于 KiCad 的开源电子设计自动化（EDA）软件开发的。
• QMK Firmware：QMK 是一个开源的键盘固件，常与 marbastlib 结合使用，用于自定义键盘的固件编程。
• ZMK Firmware：ZMK 是另一个开源的键盘固件，支持蓝牙和 USB，适合与 marbastlib 结合使用。

通过以上步骤和示例，您可以快速上手使用 marbastlib 进行自定义键盘的设计和开发。

marbastlib A library collecting MX and Choc style footprints, as well as various other parts used to design custom keyboards 项目地址: https://gitcode.com/gh_mirrors/ma/marbastlib