21.6.2 CONFIGURE_CHAIN

Description

This Tcl command tool used in "run_tool." It takes a script file that contains specific Tcl commands and passes them to FlashPro Express for execution.

Important: For a new Libero project without a JTAG chain, executing this command causes Libero to first add the existing design device to the JTAG chain and then execute the commands from the script. If, for example, the script fpro_cmds.tcl contains commands to add four devices, executing the command run_tool -name. {CONFIGURE_CHAIN} -script {fpro_cmds.tcl} will create a JTAG chain of the Libero design device and the four devices. For existing Libero projects that already have a JTAG chain, the command is executed on the existing JTAG chain.
run_tool -name {CONFIGURE_CHAIN} -script {fpro_cmds.tcl}

Arguments

ParameterTypeDescription
namestringSpecify tool name.
scriptstringSpecify absolute or relative path of the script file. This is an optional parameter. fpro_cmds.tcl is a Tcl script that contains specific Tcl commands to configure JTAG chain. For details on JTAG chain programming Tcl commands, refer to the Tcl commands section in the Libero SoC Online Help. Do not include any project-management commands such as open_project, save_project, or close_project in this fpro_cmds.tcl script file. The run_tool -name {CONFIGURE_CHAIN} command generates these projectmanagement commands for you.
Return TypeDescription
IntegerReturns 0 on success and 1 on failure.

Error Codes

Error CodeDescription
NoneNone

Supported Families

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

Example

The following example runs "CONFIGURE_CHAIN" tool with the script:

run_tool -name {CONFIGURE_CHAIN} -script {d:/fpro_cmds.tcl}
#Example fpro_cmds.tcl command file for the -script parameter
add_actel_device -file {./prj/designer/impl/sd.stp} -name {dev}
enable_device -name {M2S050TS_5} \
	      -enable 0 add_non_actel_device \
              -ir 2 \
              -tck 1.00 \
              -name {Non-Microchip Device} 
add_non_actel_device -ir 2 \
                     -tck 1.00 \
		     -name {Non-Microchip Device (2)}
remove_device -name {Non-Microchip Device}
set_device_to_highz -name {M2S050TS_5} -highz 1 
add_actel_device -device {M2S050TS} -name {M2S050TS (3)}
select_libero_design_device -name {M2S050TS (3)}