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]]]

Link-uri externe

• PetaLinux Tools Documentation: Reference Guide (UG1144)