Manufaturação industrial
Internet das coisas industrial | Materiais industriais | Manutenção e reparo de equipamentos | Programação industrial |
home  MfgRobots >> Manufaturação industrial >  >> Industrial programming >> VHDL

Integrando Bibliotecas IP do Quartus Prime no VUnit: Guia Passo a Passo

Já quis rodar uma simulação VHDL que inclui um IP core do Quartus através do framework de verificação VUnit?

Era isso que o engenheiro FPGA Konstantinos Paraskevopoulos tinha em mente, mas não encontrou tutorial adequado. Felizmente, usou seu talento para descobrir como e foi gentil o suficiente para compartilhar via este artigo convidado.

Vamos dar a palavra ao Konstantinos!

Muitas vezes é desejável incorporar IPs predefinidos do Catálogo IP do Quartus no seu design ao simular seu sistema com VUnit. Este tutorial fornece o conhecimento necessário para gerar, incorporar e vincular bibliotecas IP externas do Quartus ao ambiente VUnit.

Novo no VUnit? Confira este tutorial: Começando com VUnit

Visão Geral

Este tutorial consiste em três partes principais:

  1. Breve descrição do IP selecionado
  2. Passos necessários para gerar e vincular as bibliotecas apropriadas
  3. Verificação utilizando VUnit e ModelSim

Requisitos

Também assume conhecimento básico de VHDL e habilidades em ModelSim.

Design Sob Teste

Para nosso cenário, utilizamos o IP Somador Paralelo da lista de IP Aritmética Inteira do Quartus.

Integrando Bibliotecas IP do Quartus Prime no VUnit: Guia Passo a Passo

Nosso design aceita três vetores de entrada de 16 bits e produz o resultado da soma em vetor de 17 bits.

Passo 1: Gerar IP

Geramos nosso somador na janela do catálogo IP clicando duas vezes no componente somador paralelo sob Biblioteca/Funções Básicas/Aritmética.

Após fornecer um nome e personalizar nosso componente conforme necessidades, clicamos no botão Generate HDL no canto inferior direito.

Integrando Bibliotecas IP do Quartus Prime no VUnit: Guia Passo a Passo

Neste ponto, uma janela aparecerá, como mostrado na figura a seguir.

Nota: Devemos definir Create simulation model sob a seção Simulation para VHDL ou Verilog para gerar arquivos de simulação, pois a opção padrão é none. Se não escolhermos um, o arquivo given_ip_name.spd não será gerado, causando falha no próximo passo.

Integrando Bibliotecas IP do Quartus Prime no VUnit: Guia Passo a Passo

O processo acima gera um arquivo e uma pasta sob nosso diretório quartus:

  1. Arquivo: given_ip_name.ip
  2. Pasta: given_ip_name

A pasta contém arquivos .vhd e .v que precisam ser adicionados depois em nosso script run.py.

Passo 2: Gerar arquivos de simulação do IP

  1. GUI: Selecione Tools ➤ Generate Simulator Setup Script for IP e especifique diretório de saída na janela de prompt,
  2. CMD: Utilizando comandos Qsys, podemos gerar os mesmos arquivos digitando no terminal o seguinte comando:
ip-setup-simulation --quartus-project= <project's_QPF_filepath> \ --output-directory= <my_dir>

Usando um dos dois métodos acima, instruímos o Quartus a gerar um diretório para cada simulador suportado que contém script para criar e compilar as bibliotecas IP.

Passo 3: Gerar e compilar bibliotecas IP para ModelSim

O próximo passo é encontrar o script msim_setup.tcl na pasta mentor criada pelo passo anterior e duplicá-lo com o nome setup.tcl. Então, no arquivo setup.tcl, descomente os comandos ilustrados e defina a variável $QSYS_SIMDIR.

# # QSYS_SIMDIR is used in the Quartus-generated IP simulation script to # # construct paths to the files required to simulate the IP in your Quartus # # project. By default, the IP script assumes that you are launching the # # simulator from the IP script location. If launching from another # # location, set QSYS_SIMDIR to the output directory you specified when you # # generated the IP script, relative to the directory from which you launch # # the simulator. # set QSYS_SIMDIR <script generation output directory> # # # Source the generated IP simulation script. source $QSYS_SIMDIR/mentor/msim_setup.tcl # # # Set any compilation options you require (this is unusual). # set USER_DEFINED_COMPILE_OPTIONS <compilation options> # set USER_DEFINED_VHDL_COMPILE_OPTIONS <compilation options for VHDL> # set USER_DEFINED_VERILOG_COMPILE_OPTIONS <compilation options for Verilog> # # # Call command to compile the Quartus EDA simulation library. dev_com # # # Call command to compile the Quartus-generated IP simulation files. com # 

Após alterar e salvar o setup.tcl, podemos executar o arquivo Tcl usando o comando vsim.

vsim -c -do "do setup.tcl; quit"

Isso gera as bibliotecas compiladas na pasta mentor.

Passo 4: Vinculo VUnit

Agora que as bibliotecas IP foram geradas, devemos vinculá-las usando o script python run.py.

Confira a figura abaixo para entender melhor a estrutura de diretórios do nosso exemplo. A topologia inicial consistia da pasta raiz demo, pastas tb, vunit, e quartus. Todos subpastas e arquivos sob pasta quartus são gerados via framework Quartus após criar projeto e completar passos 1 a 3.

Nota: Quartus gera mais arquivos e pastas, mas a imagem abaixo mostra aqueles de interesse para nós.

Integrando Bibliotecas IP do Quartus Prime no VUnit: Guia Passo a Passo

Usando esta visão distinta da topologia como referência, podemos especificar nosso caminho ROOT e o(s) caminho(s) para as bibliotecas geradas, como mostrado abaixo.

Note que sim_files é o diretório que especificamos no passo 2 onde a pasta mentor foi armazenada.

from vunit import VUnit from os.path import join, dirname, abspath # ROOT root = join(dirname(__file__), '../') # Path to generated libraries path_2_lib = '/quartus/sim_files/mentor/libraries/' # ROOT

Após criar uma instância VUnit chamada vu, podemos especificar uma biblioteca de design para nosso código VHDL e vincular quaisquer bibliotecas externas necessárias:

# Create VUnit instance by parsing command line arguments vu = VUnit.from_argv() # create design's library my_lib = vu.add_library('my_lib') # Link external library vu.add_external_library("parallel_adder", root + path_2_lib + "parallel_adder")

E finalmente, adicione nossos arquivos fonte. Estes estão localizados em três subpastas sob o diretório given_ip_name:

  1. parallel_add_191
  2. synth
  3. sim

Os dirs synth e sim contêm a mesma informação, nomeadamente o design top-level do nosso IP. No entanto, a formatação destes arquivos no nosso caso é em VHDL. Poderia ser em Verilog, e isso depende da linguagem escolhida no passo 1.

Caso nosso design top-level envolva sub-componentes, devemos também incluir seus arquivos fonte. Eles estão localizados sob subpastas no diretório given_ip_name, como o componente parallel_add_191 no nosso caso.

my_lib.add_source_files(join(root,'quartus','parallel_adder','sim','parallel_adder.vhd')) my_lib.add_source_files(join(root,'quartus','parallel_adder','parallel_add_191','sim','parallel_adder_parallel_add_191_oh4guxa.vhd')) my_lib.add_source_files(join(root,'tb','tb_demo.vhd')) testbench = my_lib.entity("tb_demo") vu.main()

Testbench

Para começar, você pode conferir este link para aprender sobre fundamentos de formação de testbench VUnit.

Voltando ao nosso testbench, adicionamos as bibliotecas VUnit necessárias junto com qualquer outra biblioteca que gostaríamos de empregar e definimos nossos sinais.

Nota: Execução de processo no nosso exemplo é sequencial. Assim, sinais de controle (referidos como flags) são usados para notificar um processo se deve iniciar ou terminar.

library IEEE; use IEEE.std_logic_1164.all; use ieee.numeric_std.all; library vunit_lib; context vunit_lib.vunit_context; entity tb_demo is generic ( runner_cfg : string:= runner_cfg_default); end tb_demo; architecture sim of tb_demo is constant clk_period : time := 10 ns; signal clk : std_logic := '0'; signal rst : std_logic := '0'; -- INPUTS signal data_a : std_logic_vector(0 to 15):= (others => '0'); signal data_b : std_logic_vector(0 to 15):= (others => '0'); signal data_c : std_logic_vector(0 to 15):= (others => '0'); -- OUTPUTS signal result : std_logic_vector(0 to 16); -- CONTROL FLAGS signal reset_done :boolean := false; signal sim_done :boolean := false; signal start_sim :boolean := false; 

Seguindo, instanciamos nosso UUT. Quartus fornece exemplos de instanciação de componente para VHDL e Verilog sob convenções de nome ip_name_inst.vhd e ip_name_inst.v.

begin -- Unit Under Test UUT : entity work.parallel_adder port map ( data0x => data_a, -- parallel_add_input.data0x data1x => data_b, -- .data1x data2x => data_c, -- .data2x result => result -- parallel_add_output.result );

Os dois primeiros processos que começam são clk_process e reset_rel. Enquanto o último é suspenso após resetar e dirigir a flag reset_done para true, o clk_process opera durante todo o tempo de simulação.

clk_process : process begin clk <= '1'; wait for clk_period/2; clk <= '0'; wait for clk_period/2; end process clk_process; reset_rel : process begin rst <= '1'; wait for clk_period*2; wait until rising_edge(clk); rst <= not rst; reset_done <= true; wait; end process reset_rel;

Agora que o reset está feito, podemos invocar o processo test_runner para executar nossos testes. Além disso, o test runner permanece ativo até a flag sim_done ser dirigida para true, o que ocorre no último processo.

test_runner : process begin test_runner_setup(runner, runner_cfg); wait until reset_done and rising_edge(clk); iterate : while test_suite loop start_sim <= true; if run("test_case_1") then info ("Start"); info (running_test_case); wait until sim_done; end if; end loop; test_runner_cleanup(runner); end process test_runner; 

Finalmente, o processo data_generator executa várias adições atribuindo valores às três entradas do nosso somador paralelo utilizando um loop for.

Nota: Este processo é disparado quando o processo test_runner instrui ao configurar a flag start_sim. No final deste processo, ele eleva a flag sim_done, ordenando o test runner a pausar a simulação.

data_generator : process constant tag2 : log_level_t := new_log_level("INFO", fg => blue, bg => black, style => bright); variable a,b,c,d : integer; begin wait until start_sim; wait until rising_edge(clk); show(display_handler, tag2); if running_test_case = "test_case_1" then for i in 0 to 10 loop data_a <= std_logic_vector(to_unsigned(i+10,data_a'length)); data_b <= std_logic_vector(to_unsigned(i+20,data_a'length)); data_c <= std_logic_vector(to_unsigned(i+30,data_a'length)); wait until rising_edge(clk); a := to_integer(unsigned(data_a)); b := to_integer(unsigned(data_b)); c := to_integer(unsigned(data_c)); d := to_integer(unsigned(result)); log( integer'image(a) &" + " & integer'image(b) &" + " & integer'image(c) &" = " & integer'image(d), tag2); end loop; end if; sim_done <= true; end process data_generator; 

Verificação

Para rodar o caso de teste e verificar que tudo funciona como esperado, podemos executar o script run.py do diretório onde está localizado simplesmente digitando no terminal o seguinte comando.

python ./run.py -v

Nota: Um logger customizado foi usado para melhor ilustração na nossa saída visível ao fornecer a opção verbose -v. Além disso, como apenas um caso de teste é definido, não precisamos fornecer opção para especificá-lo.

Integrando Bibliotecas IP do Quartus Prime no VUnit: Guia Passo a Passo

Finalmente, para verificar nossos resultados no ModelSim, poderíamos digitar o seguinte comando:

python ./run.py --gui

Integrando Bibliotecas IP do Quartus Prime no VUnit: Guia Passo a Passo

(Clique na imagem para ampliar)

Conclusão

Para concluir, aprendemos como incorporar e testar IPs do Quartus que residem no catálogo IP dentro de um ambiente VUnit. Embora este tutorial usasse um IP predefinido, o mesmo processo se aplica a IPs empacotados customizados.

Confira este tutorial VUnit se ainda não viu:
Começando com VUnit

VHDL

  1. SigFox Explicado: Tecnologia, Impacto no Mercado e Comparação com Link Labs
  2. VUnit 101: Guia Prático para Verificação Automatizada de VHDL
  3. Criando Listas de Strings em VHDL: Boas Práticas e Exemplo
  4. Finalizando Graciosamente uma Simulação de Testbench VHDL
  5. Implementando um Controlador PWM em VHDL: Projeto, Simulação e Demo em FPGA
  6. Como Construir um Testbench de Auto-Verificação em VHDL – Guia Prático
  7. Tecnologia: A Chave para Cadeias de Suprimentos Transparentes e Éticas
  8. Máquina de Cerca de Elo de Corrente: Funcionamento e Benefícios
  9. Como Preparar (Priming) uma Bomba de Engrenagem Hidráulica para Desempenho Ótimo
  10. Guia Passo a Passo para Preparar (Priming) uma Bomba Hidráulica de Trator Ford