Verilog中使用'include实现参数化设计

前段时间在FPGA上用Verilog写了一个多端口以太网的数据分发模块，因为每个网口需要独立的MAC地址和IP地址，为了便于后期修改，在设计中使用parameter来定义这些地址和数据总线的位宽等常量。 
当时的做法是，顶层模块和子模块中都定义parameter型常数，在顶层模块引用子模块时，通过参数传递改变在被引用子模块中已定义的参数，实现在顶层模块统一管理参数的功能，代码如下

 module top(); // 顶层模块
 parameter eth1_ip_addr = {'d192, 8'd168, 'd100, 8'd1}; // 以太网1 IP地址 192.168.100.1
 parameter eth2_ip_addr = {'d192, 8'd168, 'd100, 8'd2}; // 以太网2 IP地址 192.168.100.2

 // 子模块1例化
 sub1
 #（  .ip_addr(eth1_ip_addr) // 参数传递
 )
 sub1_inst( ); //端口映射

 // 子模块2例化
 sub2
 #（  .ip_addr(eth2_ip_addr) // 参数传递
 )
 sub2_inst( ); //端口映射

子模块1和2分别实现以太网1和2的收发功能，ip_addr为各自的本地IP地址，通过参数传递将eth1_ip_addr和eth2_ip_addr的值分别传递给两个子模块的ip_addr常数。 
不过上述方法的缺点在于： 
1. 当子模块的参数较多，并且要多次实例化时，代码会显得较为臃肿 
2. 假如工程的层次有4层，某个参数只在第4层的模块使用到，为了实现将参数从顶层传递到第4层，第2层和第3层模块的参数列表中必须包含该参数。 
解决上述问题有两种方法： 
1. 使用defparam命令在顶层模块对子模块中的参数重定义，但是该方法同样存在一个问题：改变已经实例化后的模块中的参数，必须用英文小数点（.）表示层次逻辑关系，如下所示

 module top;
 reg clk;
 reg [:] in1;
 reg [:] in2;
 wire [:] o1;
 wire [:] o2;
 // 子模块实例化
 vdff m1 (o1, in1, clk);
 vdff m2 (o2, in2, clk);
 endmodule
 // 子模块定义
 module vdff (out, in, clk);
 parameter size = , delay = ;
 input [:size-] in;
 input clk;
 output [:size-] out;
 reg [:size-] out;

 always @(posedge clk)
 # delay out = in;
 endmodule
 // 参数重定义模块
 module annotate;
 defparam
 top.m1.size = , // size参数的层次化表示
 top.m1.delay = ,
 top.m2.size = ,
 top.m2.delay = ;
 endmodule

具体使用方法见http://www.cnblogs.com/hechengfei/p/4116667.html 
2. 使用`inculude预处理命令 
最近在STM官网上找M95xxx系列的EEPROM资料时，看到该芯片的Verilog Testbench模块，如下图所示

M95XXX_Macro_Mux.v：定义M95xxx系列芯片的AC参数 
M95XXX_Parameters.v：定义Memory大小、有效地址位数和Page大小等参数 
M95xxx_Testbench.v：链接 M95xxx_Driver.v和M95xxx_Memory.v 
M95xxx_Driver.v：模拟M95xxx_Memory.v文件基于SPI接口的读写行为 
M95xxx_Memory.v：M95xxx EEPROM的行为级描述模型

在上述文件中，M95XXX_Macro_Mux.v和M95XXX_Parameters.v定义了全局参数，被其他文件通过’include命令包含到文件内。具体使用方法如下 
M95XXX_Parameters.v 参数定义文件

 `define MEM_ADDR_BITS                     //memory address bits
 `define PAGE_ADDR_BITS                     //page address bits

M95xxx_Driver.v   驱动文件

`include "M95XXX_Parameters.v"
reg[`MEM_ADDR_BITS-:] memory_address;
reg[`PAGE_ADDR_BITS-:] page_address;

可以看到要调用参数文件中参数时，需要： 
1. 使用'include命令包含参数文件 
2. 使用反引号+参数名的方式来调用该参数

---

STM MP95xxx系列EEPROM Verilog Testbench模型的链接地址： 
https://gitee.com/hombeen/codes/y9rb0g7ej385sipqozvla95