Penguasaan Xilinx Vivado: Debugging Integrated Logic Analyzer (ILA) & Virtual Input/Output (VIO)
Tutorial ini memandu Anda menggunakan inti Integrated Logic Analyzer (ILA) dan Virtual Input/Output (VIO) Xilinx Vivado untuk debugging dan memantau desain VHDL on-chip. Pada akhirnya, Anda akan mengetahui cara memasukkan probe, mengonfigurasi trigger, dan menangkap perilaku sinyal yang tepat tanpa peralatan eksternal.
Ringkasan
Seluruh artikel ini akan merujuk pada cuplikan layar Vivado. Klik setiap gambar untuk memperbesar. Gunakan sidebar atau navigasi pop-up seluler untuk akses cepat.
ILA dan VIO
Inti ILA memungkinkan Anda men probes sinyal internal FPGA secara real-time, sementara inti VIO memungkinkan Anda menggerakkan sinyal internal dari Vivado. Keduanya gratis, sangat konfigurable, dan terintegrasi mulus ke dalam alur kerja Vivado.
- Xilinx IP: Integrated Logic Analyzer (ILA)
- Xilinx IP: Virtual Input/Output (VIO)
Persyaratan
- Papan FPGA Xilinx
- Vivado Design Suite (2020.2 atau lebih baru)
- Pengetahuan dasar VHDL
Kami akan menggunakan Kintex-7 KC705 Evaluation Kit dalam contoh, tetapi langkah-langkahnya berlaku untuk FPGA Xilinx modern apa pun.
Unduh Proyek Contoh
Unduh ZIP yang berisi desain contoh dan file VHDL. Buka ila_tutorial.xpr di Vivado untuk menjelajahi desain, atau lanjutkan untuk membuatnya dari awal.
Buat Proyek dengan Vivado
Jalankan Vivado dan klik Create Project di layar selamat datang.
Lanjutkan melalui wizard: beri nama proyek ila_tutorial (tanpa spasi), pilih RTL Project, dan tambahkan sumber counter.vhdl dan counter_top.vhdl. Aktifkan Copy sources into project dan lanjutkan.
Tambahkan file batas top.xdc, menyalinnya ke dalam proyek. Sesuaikan pin clock dan LED dengan papan Anda, dan tetapkan periode clock yang benar.
Pilih papan Anda dari daftar dan klik Finish untuk membuka proyek.
Ringkasan Contoh Desain
Contoh ini terdiri dari dua counter 4-bit yang dirantai bersama. counter.vhdl mengimplementasikan counter yang bertambah ketika diaktifkan dan mengeluarkan output trigger 1-bit antara hitungan 12 dan 15.
Deklarasi entitas:
---------------------------------------------------------------------------- -- ENTITY DECLARATION. ---------------------------------------------------------------------------- ENTITY counter IS PORT(clk : IN STD_LOGIC; -- Main clock reset : IN STD_LOGIC; -- reset, active_high enable : IN STD_LOGIC; -- enable the next counter trigger : OUT STD_LOGIC -- trigger the next counter ); END ENTITY;
Sinyal internal:
count – nilai counter 4-bit. trigger_o – sinyal perantara yang terhubung ke output trigger.
Penggunaan atribut (akan dijelaskan nanti):
ATTRIBUTE MARK_DEBUG : STRING; ATTRIBUTE MARK_DEBUG OF count : SIGNAL IS "true";
Logika sekuensial:
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;
counter_top.vhdl membuat instance dua counter. counter_1_inst selalu diaktifkan dan meng-clock counter_2_inst melalui output trigger nya. Akibatnya, counter_2_inst hanya bertambah empat kali per siklus 16-cycle dari counter_1_inst.
Buat Inti VIO untuk RESET
Kami akan menghasilkan VIO yang menggerakkan input reset desain, memungkinkan toggling manual dari Vivado.
Buka IP Catalog, cari VIO, double-klik VIO (Virtual Input/Output), dan namai ulang menjadi vio_reset. Setel Input Probe Count ke 0 dan Output Probe Count ke 1.
Konfigurasikan probe output: lebar = 1, nilai awal = 0x1, lalu klik OK dan Generate.
Setelah sintesis, deklarasikan komponen di counter_top.vhdl dan buat instance-nya. Jangan lupa untuk menyetel flatten_hierarchy ke None sebelum re-sintesis.
COMPONENT vio_reset PORT( clk : IN STD_LOGIC; probe_out0 : OUT STD_LOGIC_VECTOR(0 DOWNTO 0) ); END COMPONENT;
Masukkan Probe Debugging
Sinyal dapat di-probe melalui tiga metode:
- Dari sumber VHDL (melalui atribut
MARK_DEBUG). - Dari Netlist atau Schematic (klik kanan Mark Debug).
- Dari file XDC/TCL (tidak dibahas di sini).
Penyisipan dari Sumber VHDL
Deklarasikan atribut MARK_DEBUG sekali per file, lalu terapkan pada sinyal yang diinginkan:
ATTRIBUTE MARK_DEBUG : STRING; ATTRIBUTE MARK_DEBUG OF count : SIGNAL IS "true";
Dalam desain yang telah di-sintesis, count akan muncul di bawah Unassigned Debug Nets dengan ikon bug.
Penyisipan dari Netlist
Navigasikan ke Netlist atau Schematic, temukan net trigger, klik kanan, dan pilih Mark Debug untuk kedua counter.
Buat Inti Debug ILA
Buka Set Up Debug dari IP Catalog. Vivado akan mencantumkan semua net debug dan domain clocknya. Simpan semua empat sinyal untuk tutorial ini.
Konfigurasikan kedalaman FIFO ILA (1024 cukup) dan aktifkan Capture control. Selesaikan wizard; Vivado menghasilkan inti ILA dan file batas.
Simpan batas sebagai ila_core.xdc. File ini menerapkan atribut debug, membuat inti ILA, mengonfigurasi setiap probe, dan membuat instance dbg_hub yang menghubungkan inti ke Vivado. Perbarui frekuensi clock hub agar cocok dengan desain Anda.
Jalankan ulang sintesis, lalu implementasi, dan hasilkan bitstream. Buka Hardware Manager, auto-connect, dan program perangkat bersama dengan file probe .ltx.
Konfigurasikan Trigger ILA
Setelah pemrograman, dasbor ILA muncul. Aktifkan tab VIO dan hapus jendela yang tidak diperlukan. Tambahkan probe reset ke VIO sehingga Anda dapat mengubahnya selama capture.
Siapkan trigger pada counter_1_inst/trigger dengan kondisi rising-edge dan jendela pre-trigger 32 sampel.
Menjalankan ILA dengan Satu Trigger
Siapkan trigger (status beralih ke waiting for trigger) dan ubah reset ke 0. Setelah trigger aktif, ILA merekam 32 sampel sebelum peristiwa dan berlanjut hingga FIFO penuh.
Melakukan zoom-out menunjukkan perilaku counter_2_inst juga.
Menjalankan ILA dengan Beberapa Trigger
Untuk skenario kompleks, rantai beberapa trigger. Misalnya, trigger ketika counter_1_inst/count == 9 dan counter_2_inst/count > 2, membagi FIFO menjadi empat jendela.
Mode Auto Re-Trigger
Aktifkan Auto re-trigger untuk menangkap peristiwa yang terjadi secara sporadis atau dengan frekuensi tinggi. Konfigurasikan satu trigger, setel kedalaman FIFO, dan siapkan inti.
Mode Capture
Mode capture hanya merekam sampel yang memenuhi kondisi global. Misalnya, capture ketika counter_1_inst/trigger == 1 DAN counter_2_inst/trigger == 0 secara bersamaan.
Kesimpulan
ILA dan VIO adalah alat on-chip debugging yang kuat dan gratis. Dengan memanfaatkan probe, beberapa trigger, dan mode capture, Anda dapat memantau dan mengontrol desain FPGA yang kompleks secara langsung dari Vivado.