InteractiveHtmlBom 项目常见问题解决方案

InteractiveHtmlBom 项目常见问题解决方案

InteractiveHtmlBom Interactive HTML BOM generation plugin for KiCad, EasyEDA, Eagle, Fusion360 and Allegro PCB designer 项目地址: https://gitcode.com/gh_mirrors/in/InteractiveHtmlBom

项目基础介绍

InteractiveHtmlBom 是一个用于生成交互式 HTML BOM（Bill of Materials）表的插件，支持 KiCad、EasyEDA、Eagle、Fusion360 和 Allegro PCB 设计工具。该插件的主要功能是生成一个方便的 BOM 列表，用户可以通过视觉关联和搜索快速找到组件及其在 PCB 上的位置。这对于手工焊接原型特别有用，因为它允许用户快速找到组件组在板上的位置。此外，用户还可以通过点击板上的焊盘进行反向查找。

该项目主要使用 Python 语言编写，利用 Pcbnew 的 Python API 读取 PCB 数据并渲染丝印、制造层、焊盘、文本和绘图。BOM 表的字段和分组是完全可配置的，用户可以根据需要添加额外的列，如制造商 ID。

新手使用注意事项及解决方案

1. 安装插件时遇到依赖问题

问题描述：新手在安装 InteractiveHtmlBom 插件时，可能会遇到依赖库缺失或版本不匹配的问题，导致插件无法正常运行。

解决步骤：

1. 检查 Python 环境：确保系统中已安装 Python 3.x 版本，并且已配置好环境变量。
2. 安装依赖库：使用 pip 命令安装所需的依赖库。例如：

   pip install -r requirements.txt
   

   如果项目根目录下没有 requirements.txt 文件，可以手动安装以下常用库：

   pip install pcbnew
   pip install lxml
   

3. 验证安装：在命令行中运行插件的测试脚本，确保所有依赖库都已正确安装。

2. 生成的 BOM 表格式不正确

问题描述：新手在使用插件生成 BOM 表时，可能会发现生成的 HTML 文件格式不正确，如表格错位、字体不一致等问题。

解决步骤：

1. 检查配置文件：确保在生成 BOM 表之前，已正确配置插件的设置文件（如 settings.ini）。配置文件中应包含正确的 BOM 表字段和分组设置。
2. 调整 CSS 样式：如果生成的 HTML 文件样式有问题，可以手动调整 CSS 文件中的样式设置。通常，CSS 文件位于插件的 static 目录下。
3. 重新生成 BOM 表：在调整配置和样式后，重新运行插件生成 BOM 表，检查是否解决了格式问题。

3. 插件无法识别 PCB 文件

问题描述：新手在尝试使用插件读取 PCB 文件时，可能会遇到插件无法识别或加载 PCB 文件的问题。

解决步骤：

1. 检查文件路径：确保 PCB 文件的路径正确，并且文件格式为插件支持的格式（如 .kicad_pcb）。
2. 更新插件版本：如果使用的是较旧版本的插件，可能会存在兼容性问题。建议更新到最新版本的插件，以确保支持最新的 PCB 文件格式。
3. 手动加载 PCB 文件：在 KiCad 中手动加载 PCB 文件，确保文件没有损坏或格式错误。然后再次尝试使用插件生成 BOM 表。

通过以上步骤，新手可以更好地理解和使用 InteractiveHtmlBom 插件，解决常见的问题，顺利生成交互式 BOM 表。

InteractiveHtmlBom Interactive HTML BOM generation plugin for KiCad, EasyEDA, Eagle, Fusion360 and Allegro PCB designer 项目地址: https://gitcode.com/gh_mirrors/in/InteractiveHtmlBom