InteractiveHtmlBom项目中Allegro导出JSON时底部层Value显示异常问题分析

问题现象描述

在使用InteractiveHtmlBom工具处理Allegro 17.4设计的PCB板时，用户发现一个特殊的显示问题：当尝试隐藏"Value"选项时，只有顶部(Top)层的元件值被成功隐藏，而底部(Bottom)层的元件值仍然可见。这个问题在关闭"Silkscreen"选项时则表现正常，此时所有丝印层内容(包括Value、Reference等)都会被正确隐藏。

问题根源探究

经过技术团队分析，发现问题的根源在于Allegro的JSON导出脚本exportJson.il存在逻辑缺陷。具体表现为：

1. 底部层文本对象在导出JSON时出现了重复
2. 其中一组文本对象具有正确的"rev"、"val"标记
3. 另一组则缺少这些关键标记
4. InteractiveHtmlBom工具基于输入数据正常工作，但接收到的数据本身存在问题

技术细节分析

通过对比导出脚本的代码实现，发现"add extra silkscreen layers (top)"和"add extra silkscreen layers (bottom)"两个部分的处理逻辑存在差异。在顶部层处理时，脚本正确地使用了"unless(elem->parent->refdes)"判断语句来过滤无效文本对象，但在底部层处理时遗漏了这一关键判断条件。

这种不对称的处理方式导致：

• 顶部层文本导出正常，InteractiveHtmlBom可以正确识别和控制显示/隐藏
• 底部层文本被重复导出，其中一组缺少必要的类型标记，导致显示控制失效

解决方案

针对这一问题，技术团队提出了明确的修复方案：

1. 在exportJson.il脚本中统一顶部和底部层的处理逻辑
2. 为底部层处理添加相同的"unless(elem->parent->refdes)"判断条件
3. 确保所有文本对象都带有正确的类型标记

用户验证表明，在修改脚本后，底部层Value的显示控制功能恢复正常，与顶部层表现一致。

经验总结

这个案例为我们提供了几点重要的经验教训：

1. 在处理多层PCB设计时，必须确保各层的导出逻辑一致
2. 文本对象的类型标记是交互式BOM工具正确工作的关键
3. 脚本开发中应避免复制粘贴代码后遗漏必要的修改
4. 对于显示控制类问题，应先检查原始数据是否包含足够的控制信息

这个问题虽然表面上是显示控制问题，但实际根源在于数据导出阶段，提醒我们在处理EDA工具数据交互时要特别注意数据完整性和一致性。