uConfig 项目使用教程

1. 项目介绍

uConfig 是一个用于从 PDF 数据手册中提取引脚映射并创建 Kicad 原理图的开源工具。它能够直接保存为 Kicad 库文件，并且适用于处理大量引脚的情况。uConfig 还提供了一个名为 pinruler 的工具，用于根据一组名为 KSS（Kicad Style Sheet）的规则重新组织引脚布局。KSS 文件类似于 CSS 文件，允许用户定义原理图组件的主题。

2. 项目快速启动

2.1 安装依赖

在 Ubuntu 或 Debian 上安装依赖：

sudo apt install qt5-default qttools5-dev-tools libpoppler-qt5-dev

在 macOS 上安装依赖：

brew install qt poppler

2.2 下载并编译项目

git clone https://github.com/Robotips/uConfig.git
cd uConfig
git submodule init
git submodule update
mkdir build
cd build
qmake ../src/uConfig.pro
make -j4

2.3 运行项目

在 Linux 或 macOS 上运行：

./uconfig_gui

在 macOS 上运行（打包为应用程序）：

cd ../bin
macdeployqt uconfig_gui.app -libpath=/

3. 应用案例和最佳实践

3.1 从 PDF 数据手册中提取组件

假设你有一个名为 datasheet.pdf 的数据手册，并且你希望从中提取组件并保存为 Kicad 库文件：

uconfig datasheet.pdf -o lib1.lib -r microchip.kss

这将把所有在 datasheet.pdf 中找到的组件保存到 lib1.lib 文件中，并使用 microchip.kss 文件中的规则进行格式化。

3.2 使用 KSS 文件自定义组件样式

你可以创建一个名为 custom.kss 的文件，定义你自己的样式规则。例如：

pin {
    color: red;
    font-size: 12px;
}

然后在提取组件时应用这个 KSS 文件：

uconfig datasheet.pdf -o lib1.lib -r custom.kss

4. 典型生态项目

4.1 Kicad

Kicad 是一个开源的电子设计自动化（EDA）工具，广泛用于电路设计和 PCB 布局。uConfig 与 Kicad 紧密集成，可以直接生成 Kicad 库文件，方便用户在 Kicad 中使用。

4.2 Poppler

Poppler 是一个用于处理 PDF 文件的库，uConfig 使用 Poppler 从 PDF 数据手册中提取文本块，并根据这些文本块生成引脚映射。

4.3 Qt

Qt 是一个跨平台的 C++ 框架，uConfig 使用 Qt 构建其图形用户界面（GUI），使得用户可以方便地从 PDF 文件中提取和组织引脚信息。

通过这些工具和库的结合，uConfig 提供了一个强大的解决方案，帮助电子工程师从复杂的数据手册中快速提取和整理引脚信息。