# KICAD_LIB

**Repository Path**: zeruns/kicad_-lib

## Basic Information

- **Project Name**: KICAD_LIB
- **Description**: Zeruns的KICAD元器件原理图和封装库
- **Primary Language**: Unknown
- **License**: CC-BY-SA-4.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-02
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# KiCad 元器件库 (Zeruns.KiCad_Lib)

## 📖 项目简介

**Zeruns.KiCad_Lib** 是一个专注于电子设计的 KiCad 元器件库，包含了常用的原理图符号库、PCB 封装库和 3D 模型。本库由 Zeruns 创建和维护，致力于为电子爱好者和工程师提供高质量、经过验证的元器件封装。

KiCad 是一款开源的电子设计自动化(EDA)工具套件，用于绘制电路原理图和设计 PCB 版图。本库旨在补充 KiCad 默认库，提供更多实用和常见的封装选择。

## 📁 项目结构

```
KICAD_LIB/
├── README.md              # 中文说明文档
├── README.en.md           # 英文说明文档
├── LICENSE                # GPL-3.0 开源许可证
├── symbols/               # 原理图符号库
│   ├── Zeruns.kicad_sym   # 原理图符号库文件
│   └── Zeruns.bak         # 符号库备份文件
├── footprints/            # PCB 封装库
│   └── Zeruns.pretty/     # PCB 封装库目录
│       ├── DFN-10_L2.0-W2.0-P0.40-BL-EP.kicad_mod
│       └── DFN-8_L3.0-W3.0-P0.65-BL-4.kicad_mod
└── 3dmodels/              # 3D 模型库
    ├── XT30PW-F.step      # XT30 母头 3D 模型
    └── XT30PW-M.step      # XT30 公头 3D 模型
```

## ✨ 主要特性

- **开源免费**：完全免费使用，无需商业授权
- **高质量封装**：所有封装都经过实际验证
- **标准化命名**：采用 KiCad 标准命名规范
- **3D 模型支持**：提供器件 3D 模型，方便 PCB 布局检查
- **持续更新**：根据实际项目需求不断完善
- **兼容性好**：与最新版本 KiCad 兼容

## 🔧 支持的封装类型

### DFN/QFN 封装

| 封装类型 | 尺寸 (mm) | 引脚间距 (mm) | 特性 |
|---------|----------|--------------|------|
| DFN-10 | 2.0 × 2.0 | 0.40 | 底部散热焊盘 (EP) |
| DFN-8 | 3.0 × 3.0 | 0.65 | 底部散热焊盘 |

### 3D 模型

- **XT30PW-F**：XT30 母头连接器 3D 模型
- **XT30PW-M**：XT30 公头连接器 3D 模型

> XT30 是款 Micro 接口的平衡充电连接器，广泛应用于无人机、航模电池等领域。

### 适用场景

- 电源管理 IC
- 运算放大器
- DC-DC 转换器
- LED 驱动芯片
- 各类模拟和数字 IC
- 电池连接器 (XT30)

## 📥 安装和使用

### 安装方法

1. **克隆仓库**
   ```bash
   git clone https://gitee.com/zeruns/kicad_-lib.git
   ```

2. **KiCad 中添加库**
   - 打开 KiCad → 偏好设置 → 管理符号库
   - 添加 `symbols/Zeruns.kicad_sym`
   - 打开 KiCad → 偏好设置 → 管理封装库
   - 添加 `footprints/Zeruns.pretty`

3. **配置 3D 模型路径**
   - 在封装编辑器中设置 3D 模型路径指向 `3dmodels/` 目录

### 使用方法

在 KiCad 的 Eeschema（原理图编辑器）或 PcbNew（PCB 编辑器）中：
- 搜索 "Zeruns" 即可找到本库中的元器件
- 使用 DRC 功能验证封装正确性

## 🤝 贡献指南

欢迎社区成员贡献新的封装和符号库！

### 贡献步骤

1. **Fork 本仓库**
   - 访问 [Gitee 仓库](https://gitee.com/zeruns/kicad_-lib)
   - 点击 Fork 按钮创建您自己的副本

2. **创建功能分支**
   ```bash
   git checkout -b feat_new_component
   ```

3. **添加您的贡献**
   - 按照项目结构添加新的 `.kicad_mod` 文件
   - 添加对应的 3D 模型 (`.step` 或 `.wrl` 格式)
   - 或更新现有的符号库

4. **提交更改**
   ```bash
   git add .
   git commit -m "feat: 添加新的DFN封装"
   ```

5. **推送并创建 Pull Request**
   - 将您的更改推送到 Gitee
   - 创建 Pull Request 请求合并到主分支

### 贡献规范

- **命名规范**：采用 `封装类型_尺寸_引脚间距.kicad_mod` 格式
- **封装验证**：建议使用 KiCad 的 DRC 功能验证封装
- **3D 模型**：推荐使用 `.step` 格式的 3D 模型
- **文档更新**：请同步更新本 README 文件
- **代码风格**：遵循 KiCad 官方封装设计指南

## 📄 许可证

本项目采用 **GPL-3.0** 开源许可证。

您可以：
- ✅ 自由使用、修改和分发
- ✅ 商业使用
- ✅ 二次开发

须遵守：
- ❗ 必须开源衍生作品
- ❗ 必须保留原始许可证声明

详细信息请参阅 [LICENSE](LICENSE) 文件。

## 📞 联系方式

- **作者**：Zeruns
- **Gitee 主页**：[https://gitee.com/zeruns](https://gitee.com/zeruns)
- **项目地址**：[https://gitee.com/zeruns/kicad_-lib](https://gitee.com/zeruns/kicad_-lib)
- **作者博客地址**：[https://blog.zeruns.com](https://blog.zeruns.com)
- **问题反馈**：如有封装问题或建议，请在 Gitee Issues 中提交

## 🙏 致谢

感谢所有为开源社区做出贡献的开发者！