Lattice Diamond中Verilog未连接输入引脚的三种工程级修复策略
1. 为什么Verilog输入引脚会"消失"？
第一次用Lattice Diamond做FPGA开发的朋友，经常会遇到这样的场景：仿真时明明跑得好好的代码，一到综合阶段就报错，提示某些输入引脚无法分配。更诡异的是，这些引脚在代码里明明白白写着，但工具就是找不到它们。这种情况我遇到过不下十次，最夸张的一次是32位数据总线被优化得只剩8位，差点让我怀疑人生。
其实这是综合器的"智能优化"在作祟。当工具发现某个输入信号在模块内部没有被实际使用时，就会认为这是个冗余设计，自动帮你"修剪"掉。就好比你网购时商家"贴心"地帮你去掉包装盒，结果收到货发现零件少了一半。这种优化对资源利用率是好事，但对需要保留测试接口或预留扩展功能的工程就是灾难。
Verilog代码里常见的危险信号包括：
- 仅用于调试的监测信号
- 预留的扩展接口
- 暂时未使用的配置引脚
- 多模块设计中部分模块的输入
2. 代码层解决方案：用属性声明保住引脚
2.1 基础版：syn_force_pads属性
最直接的解决方法是在信号声明处添加综合属性。就像给重要文件贴"勿碎"标签一样，用/* synthesis syn_force_pads = 1 */告诉工具："这个引脚我很需要，别动它！"
module sensor_interface( /* synthesis syn_force_pads = 1 */ input wire temperature_alert, /* synthesis syn_force_pads = 1 */ input wire [3:0] sensor_id ); // 即使暂时只用sensor_id[1:0] // 也能保留全部4位引脚 endmodule我在电机控制项目里就用这招保住了过流保护引脚，虽然当前算法还没用到这个信号，但硬件上必须留着做安全冗余。实测这个方法的优点是精准控制，只影响标记的信号。
2.2 增强版：syn_noprune组合技
当遇到更顽固的情况时，可以加上syn_noprune属性双保险：
/* synthesis syn_force_pads=1 syn_noprune=1 */ input wire factory_test_mode;这个组合相当于在信号上同时贴了"勿碎"和"勿丢"两个标签。去年做通信板卡时，有个配置引脚加了syn_force_pads还是被优化，加上syn_noprune才彻底解决。不过要注意，这会导致对应的IO缓冲器不被优化，会轻微增加资源占用。
3. 工具层解决方案：修改综合器参数
3.1 全局保留模式：-u参数
如果工程里有大量需要保留的测试引脚，逐个加属性太麻烦。这时可以在Diamond的Process窗口，右键选择Synthesis→Properties，在Command Line Options里添加-u参数：
MAP Design → Command line options = -u这相当于告诉综合器："所有未使用的IO都给我留着"。就像搬家时跟工人说"所有箱子不管贴没贴标签都别扔"。我在原型验证阶段经常用这招，特别是当硬件版本还不稳定，可能需要飞线测试的时候。
不过要提醒两点：
- 会略微增加布局布线难度
- 量产前记得移除参数优化资源
3.2 策略配置文件调整
对于长期项目，更好的做法是创建自定义策略文件。在Diamond中：
- 打开Tools → Strategy Editor
- 复制Default策略并重命名
- 在MAP Design阶段添加
keep_unused_io选项
这样既能保持工程整洁，又方便不同阶段切换策略。我们团队现在就有Debug、Pre-production、Release三套策略配置。
4. 约束层解决方案：引脚锁定技巧
4.1 电子表格视图强制保留
在Diamond的Spreadsheet View里，找到对应引脚的行，把Pull Mode设为NONE。这相当于在PCB设计阶段就给这个引脚打了"保留"标记。我习惯在这里同时填写引脚用途说明，方便后续维护：
| Pin Name | Location | Pull Mode | Comment |
|---|---|---|---|
| debug_clk | P23 | NONE | 示波器测试点 |
| reserved[0] | A12 | NONE | 下一代功能扩展 |
4.2 LPF文件手动编辑
高级用户可以直接编辑.lpf约束文件，添加类似这样的约束：
LOCATE COMP "temperature_alert" SITE "P34"; KEEP NET "temperature_alert";这种方法特别适合需要版本控制的团队项目。有次我们的硬件工程师临时换了封装，我就是靠批量编辑LPF文件，半小时就完成了引脚迁移。
5. 方案选型指南
根据八年踩坑经验，总结出这个决策流程图：
- 少量关键信号→ 用代码属性（方案2）
- 调试阶段大量测试点→ 启用-u参数（方案3.1）
- 长期保留的预留接口→ 约束文件锁定（方案4）
- 团队协作项目→ 自定义策略+LPF（方案3.2+4.2）
最近做智能家居主控板时，我就组合使用了这些方法：关键中断用代码属性，调试接口用-u参数，扩展插座用LPF约束。结果一次通过硬件测试，连PCB工程师都夸引脚管理清晰。
最后分享一个血泪教训：曾经为了省事全程用-u参数，结果量产时忘了关闭，导致成本超支5%。现在我的checklist里永远有一条"确认最终版本已移除调试保留参数"。