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


Parameter	Type	Description
name	string	Specify tool name.
script	string	Specify 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 Type	Description
Integer	Returns 0 on success and 1 on failure.

Error Codes


Error Code	Description
None	None

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)}

v2024.2