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.

Link-uri externe

• PetaLinux Tools Documentation: Reference Guide (UG1144)