Finalizando Graciosamente uma Simulação de Testbench VHDL
Quando um testbench VHDL atinge o fim de sua execução pretendida, você vai querer que o simulador pare limpa e, se possível, retorne o controle a qualquer script chamador. Este artigo revisa as técnicas mais comuns e confiáveis para parar uma simulação nos principais simuladores VHDL, com exemplos de código para ModelSim, Vivado e scripts Tcl.
1. Usando o Procedimento finish (VHDL-2008)
A rotina finish do pacote std.env é a maneira mais direta de terminar um testbench que completou sem erros. Compile apenas o testbench em VHDL-2008; o RTL pode permanecer em um padrão anterior.
use std.env.finish; ... SEQUENCER_PROC : process begin -- Insert testbench logic here wait until stop_condition; report "Calling 'finish'"; finish; end process;
Por padrão, finish solicitará confirmação de terminação na GUI. Se você preferir saída automática — especialmente em modo batch — adicione a chave -onfinish stop ao vsim:
vsim -onfinish stop work.using_finish_tb
Quando executado em modo batch (vsim -c), o simulador sai limpo e o controle retorna ao shell, o que é ideal para scripts de regressão:
jonas@ubuntu:~/stop_tb$ vsim -c -do 'vsim work.using_finish_tb; run -all' # … # ** Note: Calling 'finish' # Time: 1 ms Iteration: 0 Instance: /using_finish_tb # End time: 22:58:31 on Jun 21,2020, Elapsed time: 0:00:00 # Errors: 0, Warnings: 8 jonas@ubuntu:~/stop_tb$
Duas sobrecargas existem: procedure FINISH; e procedure FINISH (STATUS : INTEGER);. O valor de status é dependente do simulador, então confiar nele para códigos de saída é desencorajado. No ModelSim você pode definir explicitamente o código de saída do shell com exit -code <value> em um script Tcl.
2. Usando o Procedimento stop (VHDL-2008)
A rotina stop pausa a simulação — útil para inspeção manual ou retomada posterior. Ela se comporta como um breakpoint.
use std.env.stop; ... SEQUENCER_PROC : process begin wait until stop_condition; report "Calling 'stop'"; stop; end process;
Em um fluxo de trabalho dirigido por script, stop o deixará em um shell Tcl, então o script travará a menos que você emita exit manualmente. É por isso que finish é geralmente preferido para execuções automatizadas.
3. Aproveitando uma Falha de Asserção
Alguns projetistas terminam um testbench deliberadamente causando uma falha de asserção. Este método funciona em todas as versões VHDL e não requer imports extras:
SEQUENCER_PROC : process begin wait until stop_condition; assert false report "Test: OK" severity failure; end process;
Embora garanta a terminação do simulador, o console reportará um failure mesmo que o teste tenha sucesso, o que pode ser enganoso em ferramentas de regressão automatizadas que tratam falhas como erros.
4. Controlando Terminação com Callbacks Tcl
Para controle mais flexível — como inspecionar sinais ou realizar limpeza — você pode vincular um sinal VHDL a um callback Tcl. O testbench VHDL sinaliza um booleano stop_condition quando todos os casos de teste terminam.
signal stop_condition : boolean; begin -- Example: toggle after 1 ms stop_condition <= not stop_condition after 1 ms; SEQUENCER_PROC : process begin -- testbench logic wait; -- keep the process dormant end process;
ModelSim
when {stop_condition} { stop echo "Test: OK" } run -all
Quando stop_condition se torna verdadeiro, o callback roda, imprime uma mensagem e pausa a simulação. Você pode substituir stop por exit para sair do simulador imediatamente.
Vivado
set sim_fileset sim_1 launch_simulation -simset [get_filesets $sim_fileset] add_condition -notrace stop_condition { stop puts "Test: OK" } run all
A flag -notrace suprime eco de comandos, mantendo a saída do console limpa.
Recomendação Final
Em todos os principais simuladores, o procedimento finish do VHDL-2008 permanece a escolha mais portável e amigável a scripts. Ele termina a simulação limpa tanto em ambientes GUI quanto batch sem prompts interativos persistentes.
No entanto, callbacks Tcl oferecem poderosas capacidades de depuração quando você precisa pausar a simulação e inspecionar ou manipular sinais dinamicamente.
Baixar Projetos de Exemplo
Usuários do ModelSim podem receber um arquivo zip contendo quatro testbenches ilustrativos enviando seu endereço de e-mail abaixo. (Usuários do Vivado podem replicar os exemplos com esforço mínimo.)
VHDL
- Criando Listas de Strings em VHDL: Boas Práticas e Exemplo
- Criando um Testbench Dirigido por Tcl para um Módulo Code-Lock VHDL
- Implementando um Controlador PWM em VHDL: Projeto, Simulação e Demo em FPGA
- Gerando Números Aleatórios em VHDL: De Uniforme a OSVVM
- Aprimorando a Verificação de Hardware com Testbench Interativo Baseado em Tcl
- Como Construir um Testbench de Auto-Verificação em VHDL – Guia Prático
- Implementando Lista Encadeada Dinâmica em VHDL com Tipos Protegidos e Ponteiros de Acesso
- Aproveitando Procedimentos In-Process para Design de FSM em VHDL Mais Limpo
- Dominando Funções VHDL: Guia Prático para Design Eficiente
- Derrotando a Ferrugem: 5 Estratégias Comprovadas para Preservar Seus Ativos Metálicos