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, and so on.

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/tool tips.
Important: The tool states described may not be applicable to all tools.
Tool State/Tool tipDescription
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 has run successfully.
Tool has timing violations/Timing constraints have not been metWhen the Verify Timing tool has run successfully but the design has timing violations.
Tool successfully run/Timing constraints have been metWhen the Verify Timing tool has run 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