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.
Parameter Type Description
flashpro3_clk_mode string Specifies 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_freq string Forces 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_ freq integer Specifies the TCK frequency in MHz. It can be between 1MHz to 6MHz.
flashpro3_vpump string The 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.

Parameter Type Description
flashpro4_clk_mode string Specifies 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_freq string Forces 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_ freq integer Specifies the TCK frequency in MHz. It can be between 1MHz to 6MHz.
flashpro4_vpump​ string The 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.

Parameter Type Description
flashpro5_clk_mode string Specifies 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_freq string Forces 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_ freq integer Specifies the TCK frequency in MHz. It can be between 1MHz to 6MHz or 10, 16, 30 MHz.
flashpro5_vpump string The 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.

Parameter Type Description
flashpro6_force_sck_freq string Forces the FlashPro software to use the SCK frequency. Valid values are ON, OFF(default).
flashpro6_force_tck_freq string Forces the FlashPro software to use the TCK frequency. Valid values are ON, OFF(default).
flashpro6_sck_freq integer Specifies 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_freq integer Specifies the TCK frequency in MHz. It can be between 1MHz to 6MHz or 10, 16, 30 MHz.
flashpro6_vpump​ string The 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.

Parameter Type Description
flashpro_drive_trst string Valid values are ON, OFF(default). This parameter supported by FlashPro Programmer for PolarFire, SmartFusion 2, IGLOO 2 and RTG4 devices.
flashpro_force_freq string Valid values are ON, OFF(default). This parameter supported by FlashPro Programmer for PolarFire, SmartFusion 2, IGLOO 2 and RTG4 devices.
flashpro_force_vddp string The 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_freq integer Specifies 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_vddl string The 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_vddp integer The 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_vpn string The 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_vpp string The 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 Type Description
Integer Returns 0 on success and 1 on failure.

Error Codes

Error Code Description
None Illegal Vddp value V for FlashPro. Expected: 2.5V or 3.3V.
None Invalid Clock Mode for FlashPro3. Expected: 'free_running_clk' or 'discrete_clk'.
None Invalid Clock Mode for FlashPro4. Expected: 'free_running_clk' or 'discrete_clk'.
None Invalid 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