Programming Options

You can find additional programming options for the efx_run script with the efx_pgm --help option.

efx_pgm[.exe] --help
Note: Do not run the efx_pgm application on its own. Use the place and route options with the efx_run script and the --pgm_opts option.
Table 1. Programmer Primary Options
Option Input Description
--help None Show help.
--project-xml Filename Specifies the project XML file name. If empty, the top-level module name is set as the project name.
--source Filename Input LBF/HEX file.
--periph Filename Input periphery configuration file (from periphery tool).
--dest Filename Output HEX file.
--query_bitstreams None Program exits immediately. Exit code 0 indicates bitstreams enabled for given device, 1 if not.
--query_security_version None Program exits immediately. Prints value for security layer device version.
Table 2. Programmer General Options
Option Input Description
--family Family name Specifies the device family.
--device Device name Specifies the device name.
--displayed_device Device name Device name written to bitstream header.
--generate_header on, off Write a header to the bitstream file.
--timestamp on, off Write a timestamp to the bitstream file header.
--width 1, 2, 4, 8, 16, 32 Programming width.
--settings_file Filename Specifies a settings file to be used instead of listing options into the command-line interface.
--interface_designer_​settings Filename Settings file generated from the Interface Designer.
--periph_override Filename CSV file to ovveride Interface Designer LPF settings.
--mode Mode configuration mode.
Table 3. HEX Generation Options
Option Input Description
--oscillator_clock_divider DIV8, DIV4, DIV2, DIV1 SPI Active programming clock divider.
--bitstream_compression on, off Enable compressed bitstream.
--optimize_bram_data on, off Optimize block RAM frames.
--spi_low_power_mode on, off Power down flash devices after programming.
--io_weak_pullup on, off Enable IO weak pullup during configuration.
--jtag_usercode Number JTAG USERCODE
--enable_roms on, off, smart Enable initialized memory in user RAMs.
--enable_crc_check on, off Enable CRC checking of bitstream during programming.
--enable_pcr_crc_check on, off Enable PCR CRC checking of bitstream during programming.
--enable_seu_crc_check on, off Enable SEU CRC checking of bitstream during user mode.
--enable_cbsel on, off Enable SPI Active image selection using CBSEL[1:0] pins.
--enable_remote_update on, off Enable remote update.
--remote_update_retries Number Number of retry attempts for remote update.
--flash_addr_2 Number Flash byte address for multi-image selection #2.
--flash_addr_3 Number Flash byte address for multi-image selection #3.
--flash_addr_4 Number Flash byte address for multi-image selection #4.
--enable_daisy_chain on, off Enable SPI Active/Passive daisy chain.
--daisy_chain_length Number Daisy chain total bit count.
--four_byte_addressing on, off Use 4 byte addressing during active mode configuration from SPI flash.
--active_capture_clk_edge posedge, negedge SPI Active sampling clock edge.
--enable_external_master_​clock on, off Select external clock source for SPI Active configuration.
--seu_mode automatic, manual Select automatic or manual user mode SEU CRC checking.
--seu_wait_interval Number Wait interval between automatic mode SEU CRC checks.
--release_tri_then_reset on, off Release IO tri-states before reset upon entering user mode.
--activate_tri_then_reset on, off Activate tri-state IO pins before the chip resets during exit from user mode.
--osc_user_enable on, off Enable internal oscillator for user mode/core usage.
--osc_user_div_select DIV8, DIV4, DIV2, DIV1 Select internal oscillator divider for user mode/core usage.

Using Multiple pgm_opts

efx_run.py helloworld.xml --flow pnr --pgm_opts bitstream_compression=off width=4