21.3.100 update_and_run_tool

Description

The Tcl command updates and runs the specified tool if there are any modifications with respect to the source files required by the tool. For tools that support command files, an optional command file can be supplied through the -script parameter.

update_and_run_tool -name {<tool_name >} \
-script {<absolute or relative path to script file>}
Tip: -script is an optional parameter.

Arguments

ParameterTypeDescription
namestringSpecified 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
  • SSNANALYZER
  • EXPORTNETLIST
  • EXPORTSDF
  • GENERATEPROGRAMMINGDATA
  • GENERATEDEBUGDATA
  • GENERATE_SPI_FLASH_IMAGE
  • PROGRAM_SPI_FLASH_IMAGE
scriptstringSpecifies 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 update_and_run_tool -name {tool_name}.

tool_nameParameterDescription
SYNTHESIZE

-script

{script_file}

Runs synthesis on your design.
COMPILEN/ARuns Compile with default or configured settings.
SIM_PRESYNTHN/ARuns pre-synthesis simulation with your default simulation tool.
SIM_POSTSYNTHN/ARuns post-synthesis simulation with your default simulation tool.
SIM_POSTLAYOUTN/ARuns the post layout simulation on the simulation tool.
PLACEROUTEN/ARuns 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.
GENERATEPROGRAMMINGFILEN/AGenerates the bit stream 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/AExports an XML file in <prj_folder> component/work/<design> /<design>_DataSheet.xml. The file contains information about the root SmartDesign in your project.
PROGRAMDEVICEN/APrograms 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.
SSNANALYZER

-script

{script_file}

Takes a script that contains the Simultaneous Switching Noise (SSN)-specific Tcl commands and passes them to the SSN tool for execution. The SSN is a Libero SoC tool that analyzes and generates a Noise Margin report for I/Os after layout depending on Die ane Package.
EXPORTNETLISTN/AThis command exports a .v/.vhd netlist file to the active synthesis implementation folder.
EXPORTSDFN/AThis command exports the back annotated files to the designer/impl1 folder.
GENERATEPROGRAMMINGDATAN/AGenerates the files needed by generating programming bit stream files.
GENERATEDEBUGDATA (PolarFire only)N/AGenerates the files needed by SmartDebug during device debug.
GENERATE_SPI_FLASH_IMAGE (PolarFire only)N/AGenerates SPI Flash Image file used for programming SPI FLASH Image within Libero.
PROGRAM_SPI_FLASH_IMAGE (PolarFire only)N/APrograms SPI Flash Image with configured parameters.

Error Codes

Error CodeDescription
NoneYou must specify the Tcl script to run with the CONFIGURE_CHAIN tool.
NoneYou must specify the Tcl script to run with the SMARTDEBUG tool.
NonePROGRAMDEVICE: No programmer is connected.
NoneSPI 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

update_and_run_tool \
-name {COMPILE}
update_and_run_tool \
-name {VERIFYTIMING} \
-script {./SmartTime.tcl}
# Script file contains SmartTime-specific Tcl commands
update_and_run_tool \
-name {VERIFYPOWER} \
-script {./SmartPower.tcl}
# Script file contains SmartPower-specific Tcl commands
update_and_run_tool \
-name {SSNANALYZER}
-script {<full_path>/ssn.tcl}
# Script file contains the SSN-specific Tcl commands
Important: 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.