21.3.78 run_tool

Description

This Tcl command starts the specified tool. For tools that support command files, an optional command file can be supplied through the -script parameter. Select a root before running this tool.

Note: Where possible, the value of tool_name corresponds to the name of the tool in Libero SoC.

Invoking some tools will cause Libero SoC to automatically run some upstream tools in the design flow. For example, invoking Place and Route will invoke Synthesis (if not already run) before it runs Place and Route.

run_tool -name {tool_name} \
         [-script {absolute or relative path to script file} ]

Arguments


Parameter	Type	Description
name	string	Specified tool name. The following is a list of supported tool names. SYNTHESIZE COMPILE SIM_PRESYNTH SIM_POSTSYNTH SIM_POSTLAYOUT PLACEROUTE VERIFYTIMING VERIFYPOWER GENERATEPROGRAMMINGFILE GENERATE_MEMORY_MAP PROGRAMDEVICE CONFIGURE_CHAIN SMARTDEBUG SSNANALYZER UPDATE_ENVM UPDATE_UPROM EXPORTNETLIST EXPORTSDF GENERATEPROGRAMMINGDATA GENERATEDEBUGDATA GENERATE_SPI_FLASH_IMAGE PROGRAM_SPI_FLASH_IMAGE
script	string	Specify absolute or relative path of the script file. This is an optional parameter.

Supported tool_names

The following table lists the supported tool names for run_tool -name {tool_name}.


tool_name	Parameter	Description
SYNTHESIZE	N/A	Runs synthesis on your design.
COMPILE	N/A	Runs Compile with default or configured settings.
SIM_PRESYNTH	N/A	Runs pre-synthesis simulation with your default simulation tool
SIM_POSTSYNTH	N/A	Runs post-synthesis simulation with your default simulation tool.
SIM_POSTLAYOUT	N/A	Runs the post layout simulation on the simulation tool.
PLACEROUTE	N/A	Runs Place and Route tool with default or configured settings.
VERIFYTIMING	-script {`script_file`}	Runs timing analysis with default settings/configured settings in `script_file`.
VERIFYPOWER	-script {`script_file`}	Runs power analysis with default settings/configured settings in `script_file`.
GENERATEPROGRAMMINGFILE	N/A	Generates the bitstream used for programming within Libero. This is similar to executing "Generate FPGA Array Data" in the Libero design flow.
GENERATE_MEMORY_MAP (SmartFusion 2, IGLOO 2 and RTG4 only)	N/A	Exports an XML file in <prj_folder> component/work/<design> /<design>_DataSheet.xml. The file contains information about your root SmartDesign in your project.
PROGRAMDEVICE	N/A	Programs your device with configured parameters.
CONFIGURE_CHAIN	-script {`script_file`}	Takes a script that contains FlashPro-specific Tcl commands and passes them to FlashPro Express for execution.
SMARTDEBUG	-script {`script_file`}	Takes a script that contains SmartDebug-specific Tcl commands and passes them to SmartDebug for execution.
SSNANALYZER	-script {`script_file`}	Takes a script that contains Simultaneous Switching Noise (SSN)-specific Tcl commands and passes them to the SSN tool for execution. Simultaneous Switching Noise (SSN) is a Libero SoC tool that analyzes and generates a Nosie Margin report for I/Os after layout. Depends on Die ane Package.
UPDATE_ENVM (SmartFusion 2 and IGLOO 2 only)	-script {`update_config_file`}	Takes a script file that updates the client(s) in the ENVM. In the script file, the client(s) to be updated may be a serialization client or a data storage client or a mix of serialization clients and data storage clients.
UPDATE_UPROM (RTG4 only)	-script {`update_config_file`}	Takes a script file that updates the data storage client(s) in RTG4 UPROMS.
EXPORTNETLIST	N/A	This command exports a .v/.vhd netlist file to the active synthesis implementation folder.
EXPORTSDF	N/A	This command exports the back annotated files to the designer/impl1 folder.
GENERATEPROGRAMMINGDATA	N/A	Generates the files needed by generating programming bitstream files.
GENERATEDEBUGDATA (PolarFire only)	N/A	Generates the files needed by SmartDebug during device debug.
GENERATE_SPI_FLASH_IMAGE (PolarFire only)	N/A	Generates SPI Flash Image file used for programming SPI FLASH Image within Libero.
PROGRAM_SPI_FLASH_IMAGE (PolarFire only)	N/A	Programs SPI Flash Image with configured parameters.

Error Codes


Error Code	Description
None	You must specify the Tcl script to run with the CONFIGURE_CHAIN tool.
None	You must specify the Tcl script to run with the SMARTDEBUG tool.
None	PROGRAMDEVICE: No programmer is connected.
None	SPI Flash Memory is not configured. Use the Configure Design Initialization Data and Memories tool to configure it.

Supported Families


Supported Families
PolarFire®
RTG4™
SmartFusion® 2
IGLOO® 2

Example

run_tool \
-name {COMPILE}
run_tool \
-name {SYNTHESIZE} 
# control _synopsys.tcl contains the synthesis-specific Tcl commands
run_tool \
-name {VERIFYTIMING} \
-script {./SmartTime.tcl}
# Script file contains SmartTime-specific Tcl commands
run_tool \
-name {VERIFYPOWER} \
-script {./SmartPower.tcl}
# Script file contains SmartPower-specific Tcl commands
run_tool \
-name {SMARTDEBUG}
-script {./sd_test.tcl}
# Script file contains SmartDebug-specific Tcl commands

v2024.1