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.
- IP Xilinx: Integrated Logic Analyzer (ILA)
- IP Xilinx: Virtual Input/Output (VIO)
Requisitos
- Uma placa FPGA Xilinx
- Vivado Design Suite (2020.2 ou mais recente)
- 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.
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.
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.
Selecione sua placa na lista e clique em Finish para abrir o projeto.
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.
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
count– o valor do contador de 4 bits.trigger_o– sinal intermediário conectado à saídatrigger.
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.
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.
Configure a sonda de saída: largura = 1, valor inicial = 0x1, depois clique em OK e Generate.
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:
- A partir do código-fonte VHDL (via atributos
MARK_DEBUG). - A partir do Netlist ou Schematic (clique com botão direito Mark Debug).
- 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.
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.
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.
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.
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.
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.
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.
Configure um gatilho em counter_1_inst/trigger com condição de borda de subida e uma janela de pré-gatilho de 32 amostras.
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.
Ao dar zoom out, revela-se o comportamento do counter_2_inst também.
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.
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.
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.
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
- Dominando VHDL & Verilog: Escrevendo Lógica Combinacional e Sequencial Limpa
- Expandindo horizontes da nuvem: novas zonas, contêineres e estratégias multicloud
- Fundamentos de C#: Essenciais de Entrada e Saída
- Dominando Entrada e Saída em C++: Guia Prático
- Dominando Entrada e Saída (I/O) em C: scanf() e printf() Explicados
- Dominando I/O e Importação de Módulos em Python: Guia Prático
- Dominando Entrada e Saída em Java: Imprimir, Ler e Formatados Seus Dados
- Dominando Latches D: Projeto, Operação e Diferenças Principais
- Dominando Entrada e Saída em Programação C
- RightHand Robotics e Element Logic Revelam Sistema Integrado de Picking Robótico de Peças