Verilog `ifdef: Kompilasi Bersyarat Dijelaskan
Verilog mendukung beberapa direktif kompiler yang pada dasarnya mengarahkan kompiler untuk memperlakukan kode dengan cara tertentu. Misalnya, bagian kode mungkin mewakili implementasi fitur tertentu dan harus ada cara untuk tidak menyertakan kode dalam desain jika fitur tidak digunakan.
Ini dapat diatasi dengan kompilasi bersyarat di mana desainer dapat membungkus kode dalam direktif kompiler yang memberitahu kompiler untuk menyertakan atau mengecualikan kode untuk kompilasi saat bendera bernama yang ditetapkan disetel.
Sintaks
Kompilasi bersyarat dapat dicapai dengan kata kunci Verilog `ifdef dan `ifndef. Kata kunci ini dapat muncul di mana saja dalam desain dan dapat disusun bersarang satu sama lain.
Kata kunci `ifdef hanya memberitahu kompiler untuk menyertakan potongan kode hingga `else atau `endif berikutnya jika makro yang disebut FLAG didefinisikan menggunakan direktif `define.
// Style #1: Only single `ifdef
`ifdef <FLAG>
// Statements
`endif
// Style #2: `ifdef with `else part
`ifdef <FLAG>
// Statements
`else
// Statements
`endif
// Style #3: `ifdef with additional ifdefs
`ifdef <FLAG1>
// Statements
`elsif <FLAG2>
// Statements
`elsif <FLAG3>
// Statements
`else
// Statements
`endif
Kata kunci `ifndef hanya memberitahu kompiler untuk menyertakan potongan kode hingga `else atau `endif berikutnya jika makro yang disebut FLAG tidak didefinisikan menggunakan direktif `define.
Contoh Desain dengan `ifdef
module my_design (
input clk,
input d,
`ifdef INCLUDE_RSTN
input rstn,
`endif
output reg q
);
always @ (posedge clk) begin
`ifdef INCLUDE_RSTN
if (!rstn) begin
q <= 0;
end else
`endif
begin
q <= d;
end
end
endmodule
Testbench
module tb;
reg clk, d, rstn;
wire q;
reg [3:0] delay;
my_design u0 (
.clk(clk),
.d(d),
`ifdef INCLUDE_RSTN
.rstn(rstn),
`endif
.q(q)
);
always #10 clk = ~clk;
initial begin
integer i;
{d, rstn, clk} <= 0;
#20 rstn <= 1;
for (i = 0 ; i < 20; i=i+1) begin
delay = $random;
#(delay) d <= $random;
end
#20 $finish;
end
endmodule
Perhatikan bahwa secara default, rstn tidak akan disertakan selama kompilasi desain dan oleh karena itu tidak akan muncul dalam daftar port. Namun jika makro yang disebut INCLUDE_RSTN didefinisikan dalam file Verilog apa pun yang merupakan bagian dari daftar file kompilasi atau diteruskan melalui baris perintah ke kompiler, rstn akan disertakan dalam kompilasi dan desain akan memilikinya.
Bereksperimen dengan menambahkan dan menghapus +define+INCLUDE_RSTN dari 'Compile & Run Options' di panel kiri untuk mengetahui perbedaannya.
Contoh Verilog `ifdef `elsif
Contoh berikut memiliki dua pernyataan display dalam cakupan `ifdef terpisah yang tidak memiliki bagian `else default. Jadi ini berarti bahwa secara default tidak akan ada yang ditampilkan. Jika makro MACRO didefinisikan, pesan display yang sesuai disertakan dan akan ditampilkan selama simulasi
module tb;
initial begin
`ifdef MACRO1
$display ("This is MACRO1");
`elsif MACRO2
$display ("This is MACRO2");
`endif
end
endmodule
Log Simulasi
# With no macros defined
ncsim> run
ncsim: *W,RNQUIE: Simulation is complete.
# With +define+MACRO1
ncsim> run
This is MACRO1
ncsim: *W,RNQUIE: Simulation is complete.
# With +define+MACRO2
ncsim> run
This is MACRO2
ncsim: *W,RNQUIE: Simulation is complete.
Contoh Verilog `ifndef `elsif
Kode yang sama dapat ditulis dengan `ifndef dan hasilnya akan berlawanan.
module tb;
initial begin
`ifndef MACRO1
$display ("This is MACRO1");
`elsif MACRO2
$display ("This is MACRO2");
`endif
end
endmodule
Log Simulasi
# With no macros defined
ncsim> run
This is MACRO1
ncsim: *W,RNQUIE: Simulation is complete.
# With +define+MACRO1
ncsim> run
ncsim: *W,RNQUIE: Simulation is complete.
# With +define+MACRO2
ncsim> run
This is MACRO1
ncsim: *W,RNQUIE: Simulation is complete.
# With +define+MACRO1 +define+MACRO2
ncsim> run
This is MACRO2
ncsim: *W,RNQUIE: Simulation is complete.
Contoh Verilog Nested `ifdef
`ifdef dan varian lainnya dapat disusun bersarang satu di dalam yang lain untuk membuat cara yang kompleks untuk inklusi dan eksklusi kode dengan makro yang didefinisikan.
module tb;
initial begin
`ifdef FLAG
$display ("FLAG is defined");
`ifdef NEST1_A
$display ("FLAG and NEST1_A are defined");
`ifdef NEST2
$display ("FLAG, NEST1_A and NEST2 are defined");
`endif
`elsif NEST1_B
$display ("FLAG and NEST1_B are defined");
`ifndef WHITE
$display ("FLAG and NEST1_B are defined, but WHITE is not");
`else
$display ("FLAG, NEST1_B and WHITE are defined");
`endif
`else
$display ("Only FLAG is defined");
`endif
`else
$display ("FLAG is not defined");
`endif
end
endmodule
Log Simulasi
# Without defining any macro
ncsim> run
FLAG is not defined
ncsim: *W,RNQUIE: Simulation is complete.
# With +define+FLAG +define+NEST1_B
ncsim> run
FLAG is defined
FLAG and NEST1_B are defined
FLAG and NEST1_B are defined, but WHITE is not
ncsim: *W,RNQUIE: Simulation is complete.
# With +define+FLAG +define+NEST1_B +define+WHITE
ncsim> run
FLAG is defined
FLAG and NEST1_B are defined
FLAG, NEST1_B and WHITE are defined
ncsim: *W,RNQUIE: Simulation is complete.
# With +define+FLAG
ncsim> run
FLAG is defined
Only FLAG is defined
ncsim: *W,RNQUIE: Simulation is complete.
# With +define+WHITE
ncsim> run
FLAG is not defined
ncsim: *W,RNQUIE: Simulation is complete.
# With +define+NEST1_A
ncsim> run
FLAG is not defined
ncsim: *W,RNQUIE: Simulation is complete.
Perhatikan bahwa selama makro induk tidak didefinisikan, definisi makro bersarang apa pun di dalamnya tidak akan dikompilasi. Misalnya, definisi makro NEST1_A atau WHITE tanpa FLAG tidak akan membuat kompiler mengambil kode bersarang.