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

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Este tutorial orienta você no uso dos núcleos Integrated Logic Analyzer (ILA) e Virtual Input/Output (VIO) do Xilinx Vivado para depurar e monitorar projetos VHDL on-chip. Ao final, você saberá como inserir sondas, configurar gatilhos e capturar o comportamento preciso dos sinais sem equipamentos externos.

Visão Geral

Ao longo do artigo, faremos referência a capturas de tela do Vivado. Clique em cada imagem para ampliar. Use a barra lateral ou a navegação pop-up móvel para acesso rápido.

ILA e VIO

O IP ILA permite sondar sinais internos do FPGA em tempo real, enquanto o IP VIO permite acionar sinais internos a partir do Vivado. Ambos são gratuitos, altamente configuráveis e se integram perfeitamente ao fluxo de trabalho do Vivado.

Requisitos

  1. Uma placa FPGA Xilinx
  2. Vivado Design Suite (2020.2 ou mais recente)
  3. Conhecimento básico de VHDL

Usaremos o Kit de Avaliação Kintex-7 KC705 nos exemplos, mas os passos se aplicam a qualquer FPGA Xilinx moderno.

Baixar o Projeto de Exemplo

Baixe o ZIP contendo o projeto de exemplo e arquivos VHDL. Abra ila_tutorial.xpr no Vivado para explorar o projeto, ou continue lendo para criá-lo do zero.

Criar um Projeto com o Vivado

Inicie o Vivado e clique em Create Project na tela de boas-vindas.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Avance pelo assistente: nomeie o projeto ila_tutorial (sem espaços), selecione RTL Project e adicione as fontes counter.vhdl e counter_top.vhdl. Ative Copy sources into project e continue.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Adicione o arquivo de restrições top.xdc, copiando-o para o projeto. Ajuste os pinos de clock e LED para corresponder à sua placa e defina o período de clock correto.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Selecione sua placa na lista e clique em Finish para abrir o projeto.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Visão Geral do Exemplo de Projeto

O exemplo consiste em dois contadores de 4 bits encadeados. O counter.vhdl implementa um contador que incrementa quando habilitado e assere uma saída trigger de 1 bit entre as contagens 12 e 15.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Declaração da Entidade

--------------------------------------------------------------------------- -- DECLARAÇÃO DA ENTIDADE. ---------------------------------------------------------------------------- ENTITY counter IS PORT(clk : IN STD_LOGIC; -- Clock principal reset : IN STD_LOGIC; -- reset, ativo em nível alto enable : IN STD_LOGIC; -- habilita o próximo contador trigger : OUT STD_LOGIC -- dispara o próximo contador ); END ENTITY; 

Sinais Internos

Uso de Atributos (será explicado depois)

 ATTRIBUTE MARK_DEBUG : STRING; ATTRIBUTE MARK_DEBUG OF count : SIGNAL IS "true"; 

Lógica Sequencial

 seq_proc: PROCESS (reset, clk) BEGIN -- for seq_proc IF (reset = '1') THEN count <= (OTHERS => '0'); trigger_o <= '0'; ELSIF rising_edge(clk) THEN IF (enable = '1') THEN count <= count + 1; IF (count > x"B" AND count <= x"F") THEN trigger_o <= '1'; ELSE trigger_o <= '0'; END IF; END IF; END IF; END PROCESS; 

O counter_top.vhdl instancia dois contadores. O counter_1_inst está sempre habilitado e faz o clock do counter_2_inst através de sua saída trigger. Consequentemente, o counter_2_inst incrementa apenas quatro vezes a cada ciclo de 16 contagens do counter_1_inst.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Criar um Núcleo VIO para RESET

Geraremos um VIO que aciona a entrada reset do projeto, permitindo alternância manual a partir do Vivado.

Abra o IP Catalog, procure por VIO, dê duplo clique em VIO (Virtual Input/Output) e renomeie para vio_reset. Defina Input Probe Count como 0 e Output Probe Count como 1.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Configure a sonda de saída: largura = 1, valor inicial = 0x1, depois clique em OK e Generate.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Após a síntese, declare um componente no counter_top.vhdl e instancie-o. Não se esqueça de definir flatten_hierarchy como None antes de ressintetizar.

 COMPONENT vio_reset PORT( clk : IN STD_LOGIC; probe_out0 : OUT STD_LOGIC_VECTOR(0 DOWNTO 0) ); END COMPONENT; 

Inserir Sondas de Depuração

Os sinais podem ser sondados através de três métodos:

  1. A partir do código-fonte VHDL (via atributos MARK_DEBUG).
  2. A partir do Netlist ou Schematic (clique com botão direito Mark Debug).
  3. A partir de um arquivo XDC/TCL (não abordado aqui).

Inserção a partir do Arquivo VHDL

Declare o atributo MARK_DEBUG uma vez por arquivo e aplique-o aos sinais desejados:

 ATTRIBUTE MARK_DEBUG : STRING; ATTRIBUTE MARK_DEBUG OF count : SIGNAL IS "true"; 

No projeto sintetizado, count aparecerá em Unassigned Debug Nets com um ícone de inseto.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Inserção a partir do Netlist

Navegue até Netlist ou Schematic, localize a rede trigger, clique com o botão direito e escolha Mark Debug para ambos os contadores.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Criar o Núcleo de Depuração ILA

Abra Set Up Debug no IP Catalog. O Vivado listará todas as redes de depuração e seus domínios de clock. Mantenha todos os quatro sinais para este tutorial.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Configure a profundidade FIFO do ILA (1024 é suficiente) e ative Capture control. Finalize o assistente; o Vivado gera um núcleo ILA e um arquivo de restrições.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Salve a restrição como ila_core.xdc. Este arquivo aplica os atributos de depuração, cria o núcleo ILA, configura cada sonda e instancia um dbg_hub que conecta o núcleo ao Vivado. Atualize a frequência do clock do hub para corresponder ao seu projeto.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Reexecute a síntese, depois a implementação e gere o bitstream. Abra o Hardware Manager, faça a conexão automática e programe o dispositivo junto com o arquivo de sondas .ltx.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Configurar Gatilhos do ILA

Após a programação, o painel do ILA aparece. Ative a aba VIO e remova janelas desnecessárias. Adicione a sonda reset ao VIO para poder alterná-la durante a captura.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Configure um gatilho em counter_1_inst/trigger com condição de borda de subida e uma janela de pré-gatilho de 32 amostras.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Executando ILA com Um Gatilho

Arme o gatilho (o status muda para waiting for trigger) e alterne reset para 0. Quando o gatilho dispara, o ILA registra 32 amostras antes do evento e continua até o FIFO encher.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Ao dar zoom out, revela-se o comportamento do counter_2_inst também.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Executando ILA com Múltiplos Gatilhos

Para cenários complexos, encadeie múltiplos gatilhos. Por exemplo, dispare quando counter_1_inst/count == 9 e counter_2_inst/count > 2, dividindo o FIFO em quatro janelas.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Modo Auto Re-Gatilho

Ative Auto re-trigger para capturar eventos que ocorrem esporadicamente ou em alta frequência. Configure um único gatilho, defina a profundidade do FIFO e arme o núcleo.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Modo de Captura

O modo de captura registra apenas amostras que satisfazem uma condição global. Por exemplo, capture quando counter_1_inst/trigger == 1 E counter_2_inst/trigger == 0 simultaneamente.

Dominando o Xilinx Vivado: Analisador Lógico Integrado (ILA) e Entrada/Saída Virtual (VIO) para Depuração

Conclusão

ILA e VIO são ferramentas poderosas e gratuitas para depuração on-chip. Aproveitando sondas, múltiplos gatilhos e modos de captura, você pode monitorar e controlar precisamente projetos complexos de FPGA diretamente do Vivado.

VHDL

  1. Dominando VHDL & Verilog: Escrevendo Lógica Combinacional e Sequencial Limpa
  2. Expandindo horizontes da nuvem: novas zonas, contêineres e estratégias multicloud
  3. Fundamentos de C#: Essenciais de Entrada e Saída
  4. Dominando Entrada e Saída em C++: Guia Prático
  5. Dominando Entrada e Saída (I/O) em C: scanf() e printf() Explicados
  6. Dominando I/O e Importação de Módulos em Python: Guia Prático
  7. Dominando Entrada e Saída em Java: Imprimir, Ler e Formatados Seus Dados
  8. Dominando Latches D: Projeto, Operação e Diferenças Principais
  9. Dominando Entrada e Saída em Programação C
  10. RightHand Robotics e Element Logic Revelam Sistema Integrado de Picking Robótico de Peças