21.6.14 PROGRAMMER_INFO

Description

"PROGRAMMER_INFO" is a command tool used in configure_tool. The configure_tool -name {PROGRAMMER_INFO} Tcl command sets the programmer settings, similar to the way FlashPro commands set the programmer settings. For the JTAG interface, you can set specific voltage and force TCK frequency values for your programmer in this dialog. For the SPI Target interface, you can set specific voltage and force SCK frequency values for your programmer in this dialog.

Note: This command supports the FlashPro3, FlashPro4, FlashPro5, and FlashPro6 programmers.
configure_tool -name {PROGRAMMER_INFO} -params {name:value}

Arguments

The following table list the FlashPro3 arguments.

Attention: When running tcl command with parameters {flashpro3_clk_mode:discrete_clk} and/or {flashpro4_clk_mode:discrete_clk}, a warning message is added to the log which states that using the Discrete Clocking TCK mode will increase the programming time significantly.
ParameterTypeDescription
flashpro3_clk_modestringSpecifies free-running or discrete TCK. The possible value for this argument are: free_running_clk or discrete_clocking. Default TCK mode setting is Free running clock.
flashpro3_force_freqstringForces the FlashPro software to use the TCK frequency specified by the software rather than the TCK frequency specified in the programmer file. The possible value for this argument are: ON or OFF. Default is OFF.
flashpro3_ freqintegerSpecifies the TCK frequency in MHz. It can be between 1MHz to 6MHz.
flashpro3_vpumpstringThe Vpump option is checked to instruct the FlashPro3 programmer to supply Vpump to the device. The possible value for this argument are: ON or OFF. Default is ON.

The following table list the FlashPro4 arguments.

ParameterTypeDescription
flashpro4_clk_modestringSpecifies free-running or discrete TCK. The possible value for this argument are: free_running_clk or discrete_clocking. Default TCK mode setting is Free running clock.
flashpro4_force_freqstringForces the FlashPro software to use the TCK frequency specified by the software rather than the TCK frequency specified in the programmer file. The possible value for this argument are: ON or OFF. Default is OFF.
flashpro4_ freqintegerSpecifies the TCK frequency in MHz. It can be between 1MHz to 6MHz.
flashpro4_vpump​stringThe Vpump option is checked to instruct the FlashPro4 programmer to supply Vpump to the device. The possible value for this argument are: ON or OFF. Default is ON.

The following table list the FlashPro5 arguments.

ParameterTypeDescription
flashpro5_clk_modestringSpecifies free-running or discrete TCK. The possible value for this argument are: free_running_clk or discrete_clocking. Default TCK mode setting is Free running clock.
flashpro5_force_freqstringForces the FlashPro software to use the TCK frequency specified by the software rather than the TCK frequency specified in the programmer file. The possible value for this argument are: ON or OFF. Default is OFF.
flashpro5_ freqintegerSpecifies the TCK frequency in MHz. It can be between 1MHz to 6MHz or 10, 16, 30 MHz.
flashpro5_vpumpstringThe Vpump option is checked to instruct the FlashPro5 programmer to supply Vpump to the device. The possible value for this argument are: ON or OFF. Default is ON.

The following table list the FlashPro6 arguments.

ParameterTypeDescription
flashpro6_force_sck_freqstringForces the FlashPro software to use the SCK frequency. Valid values are ON, OFF(default).
flashpro6_force_tck_freqstringForces the FlashPro software to use the TCK frequency. Valid values are ON, OFF(default).
flashpro6_sck_freqintegerSpecifies the SCK frequency in MHz. SCK is used with a maximum frequency of 40 MHz, and the default frequency is 20 MHz. Limitation of the SCK frequency for the selected programmer: 1.00, 2.00, 2.50, 3.33, 4.00, 5.00, 6.67, 8.00, 10.00, 13.33, 20.00(default), 40.00 MHz.
flashpro6_tck_freqintegerSpecifies the TCK frequency in MHz. It can be between 1MHz to 6MHz or 10, 16, 30 MHz.
flashpro6_vpump​stringThe Vpump option is checked to instruct the FlashPro6 programmer to supply Vpump to the device. The possible value for this argument are: ON or OFF. Default is ON.

The following table list the FlashPro programmer arguments.

ParameterTypeDescription
flashpro_drive_trststringValid values are ON, OFF(default). This parameter supported by FlashPro Programmer for PolarFire, SmartFusion 2, IGLOO 2 and RTG4 devices.
flashpro_force_freqstringValid values are ON, OFF(default). This parameter supported by FlashPro Programmer for PolarFire, SmartFusion 2, IGLOO 2 and RTG4 devices.
flashpro_force_vddpstringThe possible value for this argument are ON(default), OFF. This parameter supported by FlashPro Programmer for PolarFire, SmartFusion 2, IGLOO 2 and RTG4 devices.
flashpro_freqintegerSpecifies the TCK frequency in MHz. It can be between 1MHz to 6MHz or 10, 16, 30 MHz. This parameter supported by FlashPro Programmer for PolarFire, SmartFusion 2, IGLOO 2 and RTG4 devices.
flashpro_vddlstringThe possible value for this argument are: ON or OFF. Default is ON. This parameter supported by FlashPro Programmer for PolarFire, SmartFusion 2, IGLOO 2 and RTG4 devices.
flashpro_vddpintegerThe possible value for this argument are: 2.5V or 3.3V. Default is 2.5V. This parameter supported by FlashPro Programmer for PolarFire, SmartFusion 2, IGLOO 2 and RTG4 devices.
flashpro_vpnstringThe possible value for this argument are: ON or OFF. Default is ON. This parameter supported by FlashPro Programmer for PolarFire, SmartFusion 2, IGLOO 2 and RTG4 devices.
flashpro_vppstringThe possible value for this argument are: ON or OFF. Default is ON. This parameter supported by FlashPro Programmer for PolarFire, SmartFusion 2, IGLOO 2 and RTG4 devices.
Return TypeDescription
IntegerReturns 0 on success and 1 on failure.

Error Codes

Error CodeDescription
NoneIllegal Vddp value V for FlashPro. Expected: 2.5V or 3.3V.
NoneInvalid Clock Mode for FlashPro3. Expected: 'free_running_clk' or 'discrete_clk'.
NoneInvalid Clock Mode for FlashPro4. Expected: 'free_running_clk' or 'discrete_clk'.
NoneInvalid Clock Mode for FlashPro5. FlashPro5 programmer supports 'free_running_clk' clock mode only.

Supported Families

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

Example

For FlashPro3 programmer:

configure_tool -name {PROGRAMMER_INFO} \
               -params {flashpro3_clk_mode:free_running_clk} \
               -params {flashpro3_force_freq:OFF} \
               -params {flashpro3_freq:400000} \
               -params {flashpro3_vpump:ON}

For FlashPro4 programmer:

configure_tool -name {PROGRAMMER_INFO} \
               -params {flashpro4_clk_mode:free_running_clk} \
               -params {flashpro4_force_freq:OFF} \
               -params {flashpro4_freq:400000} \
               -params {flashpro4_vpump:ON}

For FlashPro4 programmer:

configure_tool -name {PROGRAMMER_INFO} \
               -params {flashpro5_clk_mode:free_running_clk} \
               -params {flashpro5_force_freq:OFF} \
               -params {flashpro5_freq:400000} \
               -params {flashpro5_vpump:ON}

For FlashPro6 programmer:

configure_tool -name {PROGRAMMER_INFO} \
               -params {flashpro6_force_freq:OFF} \
	       -params {flashpro6_freq:400000}

See Also

  • configure_flashpro3_prg
  • configure_flashpro4_prg
  • configure_flashpro5_prg
  • configure_flashpro6_prg