21.11.14 run_selected_actions

Description

FlashPro-specific Tcl command. Runs the selected action on the specified programmer. If no programmer name is specified, the action is run on all connected programmers. A programming file must be loaded.

run_selected_actions [-name "name"] \
                     [-force_rtg4_erase "TRUE | FALSE"] \
                     [-prog_spi_flash "TRUE | FALSE"] \
                     [-disable_prog_design "TRUE | FALSE"] \
                     [-spi_flash_image "spi_flash_image"] \
                     [-spi_flash_action "spi_flash_action"]

Arguments


Parameter	Type	Description
name	string	Optional argument that specifies the programmer name. You can repeat this argument for multiple programmers(example below).
force_rtg4_erase	boolean	This action is for RT4G device only. When the value of this option is set to "TRUE" the erase action will be run on RT4G device when erase action is executed in batch mode using TCL script.
disable_prog_design	boolean	Specify 1 or "TRUE" to disable device programming, specify 0 or "FALSE" to enable device programming.
prog_spi_flash	boolean	Specify 1 or "TRUE" to enable spi flash programming, sepcify 0 or "FALSE" to disable spi flash programming.
spi_flash_image	string	Provide the path of spi flash image (bin) file.
spi_flash_action	string	The value can be one of these: PROGRAM_SPI_IMAGE, VERIFY_SPI_IMAGE, READ_SPI_IMAGE, ERASE_SPI_FLASH.


Return Type	Description
None	None

Error Codes


Error Code	Description
None	The programmer with name doesn't exist.
None	Parameter 'name' has illegal value.
None	Parameter 'argument_name' is not defined. Valid command formatting is 'run_selected_actions [-name "name"]* [-force_rtg4_erase "TRUE \| FALSE"] \ [-prog_spi_flash "TRUE \| FALSE"] [-disable_prog_design "TRUE \| FALSE"] \ [-spi_flash_image "spi_flash_image"] [-spi_flash_action "spi_flash_action"].

Supported Families


PolarFire®
SmartFusion® 2
IGLOO® 2
RTG4™

Example

The following example runs the selected actions on the programmers 'FP30085' and 'FP30086':

run_selected_actions -name {FP300085} -name {FP300086}

The following example catches pass/fail:

if {[catch {run_selected_actions -name {FP300085}]} {
    puts "Error running Action"
} else {
    puts "Action passed"}

The following example returning exit code to the command line (returns exit 99 on script failure, otherwise returns 0):

if {[catch {run_selected_actions}]}{
    exit 99
} else {
    exit 0
}

v2024.2