Target Download FPGA/BINARY

The following is a list of download commands:

dow

Download ELF and binary file to target.

Syntax

dow [options] <file>

Download ELF file <file> to active target.

dow -data <file> <addr>

Download binary file <file> to active target address specified by <addr>.

Options

Option Description
-clear Clear uninitialized data (bss).
-skip-tcm-clear Clear uninitialized data sections that are part of Versal TCM. This is needed when elfs are loaded through debugger, so that TCM banks are initialized proporly. When the elfs are part of the PDI, PLM initializes the TCM, before loading the elfs.
-keepsym Keep previously downloaded elfs in the list of symbol files. Default behavior is to clear the old symbol files while downloading an elf.
-force Overwrite access protection. By default accesses to reserved and invalid address ranges are blocked.
-bypass-cache-sync Do not flush/invalidate CPU caches during elf download. Without this option, debugger flushes/invalidates caches to make sure caches are in sync.
-relocate-section-map <addr> Relocate the address map of the program sections to <addr>. This option should be used when the code is self-relocating, so that the debugger can find debug symbol info for the code. <addr> is the relative address, to which all the program sections are relocated.
-vaddr Use vaddr from the elf program headers while downloading the elf. This option is valid only for elf files.

Returns

Nothing.

verify

Verify if ELF/binary file is downloaded correctly to target.

Syntax

verify [options] <file>

Verify if the ELF file <file> is downloaded correctly to active target.

verify -data <file> <addr>

Verify if the binary file <file> is downloaded correctly to active target address specified by <addr>.

Options

Option Description
-force Overwrite access protection. By default accesses to reserved and invalid address ranges are blocked.
-vaddr Use vaddr from the elf program headers while verifying the elf data. This option is valid only for elf files.

Returns

Nothing, if successful. Error string, if the memory address cannot be accessed or if there is a mismatch.

fpga

Configure FPGA.

Syntax

fpga <bitstream-file>

Configure FPGA with given bitstream.

fpga [options]

Configure FPGA with bitstream specified options, or read FPGA state.

Options

Option Description
-file <bitstream-file> Specify file containing bitstream.
-partial Configure FPGA without first clearing current configuration. This options should be used while configuring partial bitstreams created before 2014.3 or any partial bitstreams in binary format.
-no-revision-check Disable bitstream vs silicon revision revision compatibility check.
-skip-compatibility-check Disable bitstream vs FPGA device compatibility check.
-state Return whether the FPGA is configured.
-config-status Return configuration status.
-ir-status Return IR capture status.
-boot-status Return boot history status.
-timer-status Return watchdog timer status.
-cor0-status Return configuration option 0 status.
-cor1-status Return configuration option 1 status.
-wbstar-status Return warm boot start address status.

Note(s)

  • If no target is selected or if the current target is not a supported FPGA device, and only one supported FPGA device is found in the targets list, then this device will be configured.

Returns

Depends on options used.

-file, -partial: Nothing, if fpga is configured, or an error if the configuration failed.

One of the other options Configutation value.