FPGA学习笔记7-Quartus II其余的部分TCL指令

Agenda
-Other Tcl Scripting Commands
-Accessing Command Line Options
-Using Tcl in Quartus II Software
-Getting More Help

::quartus::misc Package
-Utility and Miscellaneous Commands
Loaded by Default in Every Executable
-Some Commonly Used Commands
escape_brackets
post_message

escape_brackets Command
-Many Quartus II Tcl Commands Allow Regular Expressions in Option Arguments
-Improperly Escaping Bus Names Is a Common Error
address\[10\]
Regular Expression Matches address0 or address1
-Square Brackets Must Be Escaped Twice
address\\\[10\\\]
-Use escape_brackets Command For Convenience
-Example:Get All Location Assignments for Bus address[]
Example:

set address_names "address\[*\]"
set address_locations [get_all_instance_assignments \
    -to [escape_brackets $address_names] -name LOCATION]

post_message Command
-Formats Text Like Quartus II Message Types
-Specify Message Type and Text
info,extra_info,warning,critical_warning,error

Tcl Collections
-Some Tcl Commands Return Large Sets of Data
-Collection Is Container for Large Data Sets
Specific to Quartus II Tcl API
-Access Collection Elements with foreach_in_collection Command
Same Syntax as foreach Tcl Command
-Packages with Commonds that Return Collections Include foreach_in_collection
-No Need to Load Separate Package

Tcl Collection Example
-Print Details of All Instance Assignments

set instance_assignments [get_all_instance_assignments -name *]
foreach_in_collection instance $instance_assignments {
  set sect_id[lindex $instance 0]
  set src[lindex $instance 1]
  set dest[lindex $instance 2]
  set name[lindex $instance 3]
  set value[lindex $instance 4]
  puts "Section ID ($sect_id)"
  puts "Source ($src)"
  puts "Destination ($dest)"
  puts "Assignment Name ($name)"
  puts "Assignment value ($value)"
}

Access Command-Line Options
-Quartus II Version 4.1 Supports argv,argc,and argv0
Earlier Versions Pass Arguments in quartus(args) Variable
quartus(args) Still Supported

Version 4.1 Variable	Earlier Version Equivalent
argv	quartus(args)
argc	llength $quartus(args)
argv0	info nameofexecutable

Command-Line Options Example
-cmdline Package Provides Flexible Access to Command-Line Options
More Robust than Hard-Coded Indexing into List of Command_Line Options
Include with Quartus II

-Example with cmdline Package

quartus_sh -t myscript.tcl -project my_project -revision second

-Open Project with Optional Revision Name

package require cmdline
set options {\
         {"project.arg""""Project Name"}\
         {"revision.arg""""Revision Name"}\
}
array set optshash [::cmdline::getoptions ::argv $options "Options:"]
if{[string equal "" $optshash(revision)]}{
  #No revision is specified
  project_open $optshash(project)
}else{
  project_open $optshash(project) -revision $optshash(revision)
}
#The rest of your script follows here

Using Tcl in Quartus II
-Command-Line Executables
Batch Mode to Execute Script Files
Interactive Shell
Quick Tcl Evaluation of Command Arguments
-Tcl Console in GUI
Interactive Shell
View Menu(View->Unity windows->Tcl console)

Using Tcl at the Command Line
-Run Script File
quartus_sh -t <script file> [<script arguments>]
quartus_sh -t myscript.tcl Stratix
-Interactive Tcl Shell
quartus_sh -s
-Direct Tcl Evaluation
quartus_sh --tcl_eval <tcl command>
quartus_sh --tcl_eval help -pkg flow
-Same Syntax for Other Executable

Running Tcl Scripts

-Command-Line Executables Supporting Tcl

Name	Common Uses
quartus_sh	Assignments,General Reporting,Compiling,Simple Shell
quartus_tan	Timing Reporting,Advanced Timing Analysis
quartus_cdb	Back Annotation,LogicLock Regions,Chip Editor Functions
quartus_sim	Simulate with Tcl Testbenches

Why Different Executables?
-Different Executables Support Different Functionality
Different Tcl Packages Available
-Example
quartus_cdb Supports LogicLock Functions,
Not Timing Analysis Functions
Basic Project Functions Supported by All
-Executable and Package Matrix in Tcl Script Chapter of Quartus II Handbook
Also Type help at Tcl Shell Prompt for List

Quartus II Tcl Scripts
-Tcl Scripts Included with Quartus II
Design Space Explorer(DSE)
QHelp Unility
QFlow Script
-Scripts Listed in Tcl Scripts (Tools menu)
-Modify to Suit Needs

Pop Quiz
-List Three Ways to Use Tcl Scripts and Commands with Quartus II software

Pop Quiz Answer
-Tcl Console in Quartus II GUI
-Interactive Tcl Shell in Command-Line Executable
Batch Mode of Command-Line Executables
Direct Execution Mode of Command-Line Executable
-Tcl Toolbar Buttions(Not Covered in Presentation)