21.3.56 get_tool_state

Description

This Tcl command is used to get the state of a tool in the Libero Design Flow. It can be run on all tools which have a tool state in the UI (such as green check mark/error/out of date/has not run yet/tool run with warnings etc). The output of this Tcl command is equivalent to the tooltip message seen on the tool in the Libero Design Flow window in the UI.

get_tool_state -name {tool_name}

Arguments

ParameterTypeDescription
namestringSpecifies the name of tool for which you wish to get the tool state. It is mandatory.
  • SYNTHESIZE
  • COMPILE
  • PLACEROUTE
  • VERIFYTIMING
  • VERIFYPOWER
  • PROGRAMDEVICE
  • GENERATE_MEMORY_MAP
  • GENERATEPROGRAMMINGFILE
  • EXPORTPROGRAMMINGFILE
  • EXPORTPROGRAMMINGJOB
  • EXPORTJOBDATA
  • EXPORTNETLIST
  • EXPORTSMARTDEBUGDATA
  • PUBLISHBLOCK
  • EXPORTSDF
  • GENERATEPROGRAMMINGDATA

Error Codes

Error Code

Description

None

Required parameter 'name' is missing.

None

Parameter 'param_name' is not defined. Valid command formatting is 'get_tool_state -name "tool name"'.

Supported Families

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

The following table shows the possible tool states. Note that not all tool states mentioned apply to every tool.

Tool StateDescription
Tool successfully runWhen the execution is successful.
Device/Project settings have changedWhen the Device/Project settings that affect the tool are modified.
Tool configuration has changedWhen a tool's configuration options are changed.
Tool failedWhen a tool execution fails.
Tool has not run yetWhen a tool has not run yet.
Tool inputs are out of dateWhen a parent tool state is cleaned or when a design source is modified or something in another tool is modified that the current tool is dependent on.
Tool executedWhen a tool ran successfully.
Timing constraints have not been metWhen the Verify Timing tool ran successfully but the design has timing violations.
Timing constraints have been metWhen the Verify Timing tool ran successfully and there are no timing violations for the design.

The following table shows all the tools for which this command is applicable.

Tool Name (Tcl)Tool Display Name Supported Families
SYNTHESIZESynthesizeSmartFusion 2, IGLOO 2, RTG4, PolarFire
COMPILECompileSmartFusion 2, IGLOO 2, RTG4, PolarFire
PLACEROUTEPlace and RouteSmartFusion 2, IGLOO 2, RTG4, PolarFire
VERIFYTIMINGVerify TimingSmartFusion 2, IGLOO 2, RTG4, PolarFire
VERIFYPOWERVerify PowerSmartFusion 2, IGLOO 2, RTG4, PolarFire
PROGRAMDEVICERun PROGRAM ActionSmartFusion 2, IGLOO 2, RTG4, PolarFire
GENERATE_MEMORY_MAPGenerate Memory MapSmartFusion 2, IGLOO 2, RTG4, PolarFire
GENERATEPROGRAMMINGFILEGenerate BitstreamSmartFusion 2, IGLOO 2, RTG4, PolarFire
EXPORTPROGRAMMINGFILEExport BitstreamSmartFusion 2, IGLOO 2, RTG4, PolarFire
EXPORTPROGRAMMINGJOBExport FlashPro Express JobSmartFusion 2, IGLOO 2, RTG4, PolarFire
EXPORTJOBDATAExport Job Manager DataSmartFusion 2, IGLOO 2, RTG4, PolarFire
EXPORTNETLISTFile > Export > Netlist...SmartFusion 2, IGLOO 2, RTG4, PolarFire
EXPORTSMARTDEBUGDATAExport SmartDebug DataSmartFusion 2, IGLOO 2, RTG4, PolarFire
PUBLISHBLOCKPublish BlockSmartFusion 2, IGLOO 2, RTG4, PolarFire
EXPORTSDFGenerate Back Annotated FilesSmartFusion 2, IGLOO 2, RTG4, PolarFire
GENERATEPROGRAMMINGDATAGenerate FPGA Array DataSmartFusion 2, IGLOO 2, RTG4, PolarFire

Example

The following example gets the state of synthesize tool in the Libero Design flow.

set state [get_tool_state -name {SYNTHESIZE}]
puts "$state"
Output: Tool successfully run