program Subcommand - 2024.2 English - UG908

Vivado Design Suite User Guide: Programming and Debugging (UG908)

Document ID
UG908
Release Date
2024-11-13
Version
2024.2 English

The program subcommand is used to configure and analyze errors in situ via a JTAG interface. The arguments to the pdi_dbg_util program subcommand are as follows:

pdi_dbg_util program [OPTIONS] PDI_FILE

Where the options are:

  • --skip_reset
    • Skip resetting the device before programming the PDI
  • -c, --cs_url URL
    • ChipScope server URL [default: TCP:localhost:3042]
  • -t, --target_index INTEGER
    • Index of target device. Use list-targets command to get list of JTAG targets. [default: 0]
  • -u, --url URL
    • Hardware server URL [default: TCP:localhost:3121]

The program subcommand encompasses multiple arguments, like those of the analyze-hw subcommand. The primary parameter is the PDI file used for configuring the target device. Analogous to the "analyze-hw" subcommand, you must furnish a target index and hardware server URL. If the command is executed on the same host as the hardware server, the default value of localhost:3121 suffices, and therefore, this option can be omitted. Similarly, the target index option might be omitted when the target index is 0. It is important to note that in cases where the target index is unknown, the "list-targets" subcommand can be used to determine it. Lastly, the ChipScope server URL option might be optionally specified for in-depth error analysis.

The program subcommand has a special option called –skip_reset. This option is used to optionally avoid performing a reset prior to configuring the device with the PDI file. This feature is helpful for situations where either the system needs to be reset independently of this tool or when handling special cases like DFX PDI configuration.