Dominando Tarefas de Display do Verilog: Depuração e Logging Eficientes
Tarefas de sistema de display são principalmente usadas para exibir mensagens informativas e de depuração para rastrear o fluxo de simulação a partir de arquivos de log e também ajuda a depurar mais rápido. Existem diferentes grupos de tarefas de display e formatos nos quais eles podem imprimir valores.
Tarefas Display/Write
Sintaxe
Tanto $display quanto $write exibem argumentos na ordem em que aparecem na lista de argumentos.
$display(<lista_de_argumentos>);
$write(<lista_de_argumentos>);
$write não anexa o caractere de nova linha \n ao final de sua string, enquanto $display faz isso e pode ser visto no exemplo mostrado abaixo.
Exemplo
module tb;
initial begin
$display ("Isso termina com uma nova linha ");
$write ("Isso não,");
$write ("como isto. Para iniciar nova linha, use caractere newline ");
$display ("Isso sempre começa em uma nova linha !");
end
endmodule
Log de Simulação
ncsim> run Isso termina com uma nova linha Isso não,como isto. Para iniciar nova linha, use caractere newline Hi there ! ncsim: *W,RNQUIE: Simulation is complete.
Strobes do Verilog
$strobe imprime os valores finais das variáveis no final do delta de tempo atual e tem um formato similar ao $display.
module tb;
initial begin
reg [7:0] a;
reg [7:0] b;
a = 8'h2D;
b = 8'h2D;
#10;
// Esperar até simulação atingir 10ns
b <= a + 1;
// Atribuir valor a+1 a b
$display ("[$display] time=%0t a=0x%0h b=0x%0h", $time, a, b);
$strobe ("[$strobe] time=%0t a=0x%0h b=0x%0h", $time, a, b);
#1;
$display ("[$display] time=%0t a=0x%0h b=0x%0h", $time, a, b);
$strobe ("[$strobe] time=%0t a=0x%0h b=0x%0h", $time, a, b);
end
endmodule
Note que $strobe mostra o valor final atualizado da variável b no tempo 10ns que é 0x2E, e $display pega isso apenas no próximo delta de simulação em 11ns.
Log de Simulação
ncsim> run [$display] time=10 a=0x2d b=0x2d [$strobe] time=10 a=0x2d b=0x2e [$display] time=11 a=0x2d b=0x2e [$strobe] time=11 a=0x2d b=0x2e ncsim: *W,RNQUIE: Simulation is complete. ncsim> exit
Monitores Contínuos do Verilog
$monitor ajuda a imprimir automaticamente valores de variáveis ou expressões sempre que a variável ou expressão em sua lista de argumentos muda. Alcança um efeito similar de chamar $display após cada vez que qualquer um de seus argumentos é atualizado.
module tb;
initial begin
reg [7:0] a;
reg [7:0] b;
a = 8'h2D;
b = 8'h2D;
#10;
// Esperar até simulação atingir 10ns
b <= a + 1;
// Atribuir valor a+1 a b
$monitor ("[$monitor] time=%0t a=0x%0h b=0x%0h", $time, a, b);
#1 b <= 8'hA4;
#5 b <= a - 8'h33;
#10 b <= 8'h1;
end
endmodule
Note que $monitor é como uma tarefa que é gerada para rodar em background da thread principal que monitora e exibe mudanças de valor de suas variáveis de argumento. Uma nova tarefa $monitor pode ser emitida quantas vezes durante a simulação.
Log de Simulação
ncsim> run [$monitor] time=10 a=0x2d b=0x2e [$monitor] time=11 a=0x2d b=0xa4 [$monitor] time=16 a=0x2d b=0xfa [$monitor] time=26 a=0x2d b=0x1 ncsim: *W,RNQUIE: Simulation is complete.
Especificadores de Formato do Verilog
Para imprimir variáveis dentro de funções de display, especificadores de formato apropriados têm que ser dados para cada variável.
| Argumento | Descrição |
|---|---|
| %h, %H | Exibir em formato hexadecimal |
| %d, %D | Exibir em formato decimal |
| %b, %B | Exibir em formato binário |
| %m, %M | Exibir nome hierárquico |
| %s, %S | Exibir como string |
| %t, %T | Exibir em formato de tempo |
| %f, %F | Exibir 'real' em formato decimal |
| %e, %E | Exibir 'real' em formato exponencial |
module tb;
initial begin
reg [7:0] a;
reg [39:0] str = "Hello";
time cur_time;
real float_pt;
a = 8'h0E;
float_pt = 3.142;
$display ("a = %h", a);
$display ("a = %d", a);
$display ("a = %b", a);
$display ("str = %s", str);
#200 cur_time = $time;
$display ("time = %t", cur_time);
$display ("float_pt = %f", float_pt);
$display ("float_pt = %e", float_pt);
end
endmodule
Log de Simulação
ncsim> run a = 0e a = 14 a = 00001110 str = Hello time = 200 float_pt = 3.142000 float_pt = 3.142000e+00 ncsim: *W,RNQUIE: Simulation is complete.
Sequências de Escape do Verilog
Alguns caracteres são considerados especiais pois representam outros propósitos de display como nova linha, tabs e form feeds. Para imprimir esses caracteres especiais, cada ocorrência de tais caracteres tem que ser escapada.
| Argumento | Descrição |
|---|---|
| \n | Caractere de nova linha |
| \t | Caractere de tab |
| \\ | O caractere \ |
| \" | O caractere " |
| %% | O caractere % |
module tb;
initial begin
$write ("Caractere de nova linha \n");
$display ("Caractere de tab \t stop");
$display ("Escape \" %%");
/* // Erros de compilação
$display ("Sem escape \n"); // ERROR : String não terminada
$display ("Sem escape \""); // ERROR : String não terminada
*/
end
endmodule
Log de Simulação
ncsim> run Caractere de nova linha Caractere de tab stop Escape " % ncsim: *W,RNQUIE: Simulation is complete.
Verilog
- Domine o Verilog: Tutorial Completo para Projeto de Circuitos Digitais
- Dominando Concatenação Verilog: Guia Prático
- Entendendo Atribuições em Verilog: Tipos, Sintaxe e Boas Práticas
- Verilog Blocking vs Non-Blocking: Diferenças Essenciais Explicadas
- Dominando Funções em Verilog para Design RTL Eficiente
- Entendendo Tasks em Verilog: Funções vs Tasks, Sintaxe e Uso
- Verilog `ifdef: Compilação Condicional Explicada
- Dominando Referência Hierárquica em Verilog: Evite Colisão de Nomes em Módulos e Blocos
- Gerador de Clock Verilog: Guia de Design e Implementação
- Dominando Tarefas de Display do Verilog: Depuração e Logging Eficientes