Comenzi TCL în Vivado

Documentație comenzi TCL în Vivado

AMD (anterior Xilinx) pune la dispoziție o documentație oficială foarte detaliată pentru comenzile Tcl utilizate în Vivado Design Suite. Aceasta acoperă atât comenzile individuale, cât și programarea scripturilor pentru automatizarea proiectelor FPGA.

Documentația este organizată în trei manuale principale, care se completează reciproc:

1. UG835 — Vivado Design Suite Tcl Command Reference Guide
2. UG894 — Vivado Design Suite User Guide: Using Tcl Scripting
3. UG912 — Vivado Design Suite Properties Reference Guide

UG835 — Vivado Design Suite Tcl Command Reference Guide

Referința completă a comenzilor Tcl. Acesta este principalul manual de referință pentru comenzile Tcl disponibile în Vivado. Documentația prezintă sintaxa comenzilor, parametrii acceptați, descrierea funcționalității și exemple de utilizare.

Sunt documentate comenzi pentru:

• Crearea, deschiderea și configurarea proiectelor.
• Selectarea dispozitivelor FPGA și a plăcilor de dezvoltare.
• Gestionarea fișierelor sursă HDL și a constrângerilor XDC.
• Sinteză, implementare și generarea fișierelor bitstream.
• Gestionarea IP-urilor și a diagramelor Block Design.
• Analiza temporizării (timing analysis) și a utilizării resurselor.
• Interacțiunea cu dispozitivele fizice prin Hardware Manager.

De exemplu, pentru a obține informații despre FPGA-ul XC7Z020 de pe placa Digilent Arty Z7-20:

# Identificarea variantelor disponibile ale dispozitivului
get_parts xc7z020*

# Afișarea tuturor proprietăților variantei selectate
report_property [get_parts xc7z020clg400-1]

# Afișarea proprietății DEVICE
get_property DEVICE [get_parts xc7z020clg400-1]

Este important de observat că report_property necesită un obiect Vivado, nu un simplu șir de caractere. Comanda get_parts obține obiectul corespunzător dispozitivului, care este ulterior transmis comenzii report_property.

UG894 — Vivado Design Suite User Guide: Using Tcl Scripting

Ghid pentru utilizarea Tcl și automatizarea fluxurilor de proiectare. Acest manual explică utilizarea limbajului Tcl în mediul Vivado și modul în care comenzile pot fi combinate în scripturi pentru automatizarea proiectării. Subiectele importante includ lucrul cu obiectele Vivado, interogarea și filtrarea colecțiilor, utilizarea variabilelor, procedurilor și buclelor Tcl, precum și executarea comenzilor în mod interactiv sau în batch mode.

De exemplu, putem interoga proiectul curent:

# Obținerea obiectului corespunzător proiectului
set proiect [current_project]

# Identificarea dispozitivului selectat
set dispozitiv [get_property PART $proiect]

puts "Dispozitiv FPGA: $dispozitiv"

UG912 — Vivado Design Suite Properties Reference Guide

Referința proprietăților obiectelor din Vivado. Acest manual descrie proprietățile asociate obiectelor Vivado și modul în care acestea pot fi citite sau modificate folosind comenzile Tcl. Vivado folosește un model bazat pe obiecte. Un proiect conține obiecte precum dispozitive FPGA, celule logice, porturi, conexiuni, ceasuri și instanțe IP.

Aceste obiecte au proprietăți care pot fi interogate folosind:

# Afișarea proprietăților obiectului
report_property $obiect

# Enumerarea denumirilor proprietăților
list_property $obiect

# Citirea valorii unei proprietăți
get_property NUME_PROPRIETATE $obiect

# Modificarea unei proprietăți (dacă este editabilă)
set_property NUME_PROPRIETATE valoare $obiect

De exemplu, pentru identificarea frecvenței unui ceas definit în proiect:

# Enumerarea ceasurilor existente
get_clocks

# Afișarea proprietăților ceasului specificat
report_property [get_clocks clk_100MHz]

# Citirea perioadei ceasului, exprimată în ns
get_property PERIOD [get_clocks clk_100MHz]

Obținerea documentației direct din consola Tcl

Vivado include un sistem de asistență care permite consultarea comenzilor fără deschiderea manualelor. Pentru afișarea informațiilor despre o comandă:

help get_parts
help report_property
help get_property

Pentru afișarea sintaxei și a argumentelor acceptate:

get_parts -help
report_property -help

Pentru afișarea comenzilor de ajutor disponibile:

help

Alte comenzi TCL utile (Vivado):

Informații despre componenta folosită în proiectul curent, din Vivado:

report_property [get_parts [get_property PART [current_project]]]

Comenzi Tcl utile pentru proiectarea FPGA

Tabelul următor prezintă câteva comenzi frecvent utilizate.

Comandă	Funcționalitate
get_parts	Enumerarea dispozitivelor FPGA
get_board_parts	Enumerarea definițiilor plăcilor
current_project	Obținerea proiectului curent
get_property	Citirea unei proprietăți
set_property	Modificarea unei proprietăți
report_property	Afișarea proprietăților unui obiect
get_cells	Identificarea celulelor din proiect
get_ports	Identificarea porturilor
get_nets	Identificarea conexiunilor
get_clocks	Identificarea semnalelor de ceas
get_bd_cells	Identificarea componentelor din Block Design
get_ips	Identificarea instanțelor IP
launch_runs	Lansarea sintezei sau implementării
report_utilization	Raportarea utilizării resurselor
report_timing_summary	Raportarea temporizării
write_bitstream	Generarea unui bitstream din designul implementat
write_project_tcl	Exportarea configurației proiectului ca script Tcl

Disponibilitatea unor comenzi depinde de contextul activ: proiect deschis, Block Design, design sintetizat sau implementat.

Generarea unui script Tcl dintr-un proiect existent

O funcționalitate importantă a Vivado este posibilitatea exportării configurației proiectului într-un script Tcl.

Comanda este:

write_project_tcl -force proiect_arty.tcl

Scriptul rezultat poate fi utilizat pentru recrearea proiectului, cu condiția ca fișierele sursă, constrângerile și celelalte dependențe necesare să fie disponibile.

Această abordare oferă câteva avantaje importante:

• Reproducerea configurației unui proiect FPGA.
• Automatizarea creării proiectelor.
• Integrarea cu sisteme de control al versiunilor, precum Git.
• Compararea modificărilor dintre configurațiile proiectelor.
• Reducerea dependenței de interfața grafică Vivado.

Pentru un proiect care combină logica FPGA, interfața AXI, procesorul ARM și comunicația Ethernet pe Arty Z7-20, automatizarea prin Tcl poate deveni deosebit de utilă.

Ce documentație trebuie consultată?

Obiectiv	Manual recomandat
Identificarea sintaxei unei comenzi	UG835
Învățarea programării Tcl în Vivado	UG894
Înțelegerea obiectelor și proprietăților	UG912
Automatizarea sintezei și implementării	UG835 + UG894
Interogarea resurselor FPGA	UG835 + UG912
Automatizarea proiectelor Zynq și AXI	UG835 + UG894

Versiunile online consultate sunt Vivado 2026.1, publicate de AMD în 2026. Pentru versiuni mai vechi ale Vivado, este recomandată selectarea versiunii corespunzătoare din arhiva documentației AMD.

Concluzie

Pentru dezvoltarea proiectelor FPGA în Vivado, cele trei manuale sunt complementare:

UG835 reprezintă dicționarul comenzilor Tcl, UG894 explică modul în care acestea se combină pentru automatizarea fluxurilor de proiectare, iar UG912 documentează proprietățile obiectelor asupra cărora acționează comenzile.

Pentru studierea sistematică a interfeței Tcl, ordinea recomandată este UG894, apoi UG835, urmat de UG912.

Link-uri externe

• PetaLinux Tools Documentation: Reference Guide (UG1144)