Verilog File I/O onder de knie: Openen, Lezen, Schrijven en Sluiten
Verilog beschikt over systeemtaken en -functies waarmee bestanden geopend kunnen worden, waarden naar bestanden geschreven kunnen worden, waarden uit bestanden gelezen kunnen worden in variabelen en bestanden weer gesloten kunnen worden.
Bestanden openen en sluiten
module tb;
// Variabele om de file handler op te slaan
integer fd;
initial begin
// Open een nieuw bestand met de naam "my_file.txt"
// met "write" rechten, en sla de file handler pointer op in "fd"
fd = $fopen("my_file.txt", "w");
// Sluit de file handler waar "fd" naar wijst
$fclose(fd);
end
endmodule
Bestandsopenmodi
| Argument | Beschrijving |
|---|---|
| "r" of "rb" | Openen voor lezen |
| "w" of "wb" | Nieuw bestand aanmaken voor schrijven. Als het bestand bestaat, wordt het geleegd en overschreven |
| "a" of "ab" | Als bestand bestaat, toevoegen (openen voor schrijven aan EOF), anders nieuw bestand aanmaken |
| "r+", "r+b" of "rb+" | Openen voor zowel lezen als schrijven |
| "w+", "w+b" of "wb+" | Leegmaken of aanmaken voor update |
| "a+", "a+b", of "ab+" | Toevoegen, of nieuw bestand aanmaken voor update aan EOF |
Naar bestanden schrijven
| Functie | Beschrijving |
|---|---|
| $fdisplay | Vergelijkbaar met $display, maar schrijft naar bestand |
| $fwrite | Vergelijkbaar met $write, maar schrijft naar bestand |
| $fstrobe | Vergelijkbaar met $strobe, maar schrijft naar bestand |
| $fmonitor | Vergelijkbaar met $monitor, maar schrijft naar bestand |
Elk van deze systeemfuncties print waarden in decimaal formaat. Ze hebben ook drie varianten voor binaire, octale en hexadecimale uitvoer.
| Functie | Beschrijving |
|---|---|
| $fdisplay() | Print standaard in decimaal |
| $fdisplayb() | Print in binair |
| $fdisplayo() | Print in octaal |
| $fdisplayh() | Print in hexadecimaal |
module tb;
integer fd;
integer i;
reg [7:0] my_var;
initial begin
// Nieuw bestand aanmaken
fd = $fopen("my_file.txt", "w");
my_var = 0;
$fdisplay(fd, "Waarde getoond met $fdisplay");
#10 my_var = 8'h1A;
$fdisplay(fd, my_var); // Toont in decimaal
$fdisplayb(fd, my_var); // Toont in binair
$fdisplayo(fd, my_var); // Toont in octaal
$fdisplayh(fd, my_var); // Toont in hex
// $fwrite voegt niet automatisch newline toe aan het einde van elke regel
$fdisplay(fd, "Waarde getoond met $fwrite");
#10 my_var = 8'h2B;
$fwrite(fd, my_var);
$fwriteb(fd, my_var);
$fwriteo(fd, my_var);
$fwriteh(fd, my_var);
// Spring naar nieuwe regel met newline, en print met strobe die de
// uiteindelijke waarde neemt na non-blocking assignments
$fdisplay(fd, " Waarde getoond met $fstrobe");
#10 my_var <= 8'h3C;
$fstrobe(fd, my_var);
$fstrobeb(fd, my_var);
$fstrobeo(fd, my_var);
$fstrobeh(fd, my_var);
#10 $fdisplay(fd, "Waarde getoond met $fmonitor");
$fmonitor(fd, my_var);
for(i = 0; i < 5; i = i+1) begin
#5 my_var <= i;
end
#10 $fclose(fd);
end
endmodule
Simulatie Log:
Value displayed with $fdisplay 26 00011010 032 1a Value displayed with $fwrite 43001010110532b Value displayed with $fstrobe 60 00111100 074 3c Value displayed with $fmonitor 60 0 1 2 3 4
Uit bestanden lezen
Een regel lezen
De systeemfunctie $fgets leest tekens uit het bestand gespecificeerd door fd in de variabele str totdat str vol is, of een newline-teken is gelezen en overgedragen aan str, of een EOF-conditie wordt aangetroffen.
Bij een fout tijdens het lezen geeft het code nul terug; anders geeft het het aantal gelezen tekens terug.
EOF detecteren
De systeemfunctie $feof geeft een niet-nul waarde terug wanneer EOF wordt gevonden, en nul anders voor een gegeven file descriptor als argument.
module tb;
reg[8*45:1] str;
integer fd;
initial begin
fd = $fopen("my_file.txt", "r");
// Blijf regels lezen tot EOF gevonden wordt
while (! $feof(fd)) begin
// Haal huidige regel op in variabele 'str'
$fgets(str, fd);
// Toon inhoud van de variabele
$display("%0s", str);
end
$fclose(fd);
end
endmodule
Meerdere argumenten voor $fdisplay
Wanneer meerdere variabelen aan $fdisplay worden gegeven, print het alle variabelen in de gegeven volgorde na elkaar zonder spatie.
module tb;
reg [3:0] a, b, c, d;
reg [8*30:0] str;
integer fd;
initial begin
a = 4'ha; b = 4'hb; c = 4'hc; d = 4'hd;
fd = $fopen("my_file.txt", "w");
$fdisplay(fd, a, b, c, d);
$fclose(fd);
end
endmodule
Simulatie Log:
10111213
Data formatteren naar een string
Het eerste argument in de $sformat systeemfunctie is de variabelenaam waarin het resultaat geplaatst wordt. Het tweede argument is de format_string die aangeeft hoe de volgende argumenten geformatteerd moeten worden tot een string.
module tb;
reg [8*19:0] str;
reg [3:0] a, b;
initial begin
a = 4'hA; b = 4'hB;
// Formatteer 'a' en 'b' naar een string volgens het formaat,
// en sla op in 'str' variabele
$sformat(str, "a=%0d b=0x%0h", a, b);
$display("%0s", str);
end
endmodule
Simulatie Log:
a=10 b=0xb
Verilog
- Verilog beheersen: Complete tutorial voor digitale schakelingontwerp
- Verilog concatenatie beheersen: Een praktische gids
- Verilog-toewijzingen begrijpen: types, syntax en best practices
- Verilog Blocking vs. Non-Blocking: belangrijkste verschillen uitgelegd
- Verilog-functies beheersen voor efficiënt RTL-ontwerp
- Verilog Tasks begrijpen: Functions vs Tasks, Syntax en Gebruik
- Verilog Clock Generator: Ontwerp & Implementatie Gids
- Verilog Math Functions beheersen voor efficiënt Hardware-ontwerp
- Verilog $timeformat beheersen: Precisie en Weergave-controle
- Verilog Timescales begrijpen en printen in elke Scope
- Beginner's Guide to Verilog: Hello World Voorbeeld