Intel® Agilex™ Configuration User Guide

ID 683673
Date 1/14/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

5.5.3. Generating a Factory Update Image

You can generate the factory update image from the command line directly, by running the quartus_pfg with the following arguments:
quartus_pfg -c fpga.sof factory_update.rpd -o mode=ASX4 -o start_address=<address> -o bitswap=ON -o rsu_upgrade=ON
Note: If you selected to use relative address options, skip the start_address argument in your command line.
Note: The rsu1.tcl script that Intel provides performs the bit swap operation. Consequently, if you are using this script, set bitswap=OFF in the command above.
Alternatively, you can use the Intel® Quartus® Prime Pro Edition Programming File Generator to generate a factory update image (.rpd). You can use this image to update the decision firmware, decision firmware data, and the factory image.
Note: The .rpd to program flash memory includes firmware pointer information for image addresses. You must use the Programming File Generator to generate the .rpd for flash devices.
  1. On the File menu, click Programming File Generator.
  2. Select Intel® Agilex™ from the Device family drop-down list.
  3. Select the configuration mode from the Configuration mode drop-down list. The current Intel® Quartus® Prime only supports the RSU feature in the Active Serial x4 configuration mode.
  4. On the Output Files tab, assign the output directory and file name.
  5. Select the output file type:
    • Raw Programming File (.rpd)
  6. In Intel® Quartus® Prime software version 20.4 or earlier, click the Edit… button and assign the Start address for the image in flash memory. This Start address must match the starting address of the target partition in flash memory. If the address is incorrect, the image does not load successfully when you trigger an update with this image.

    In Intel® Quartus® Prime software version 21.1 or later, a Use relative address option is the default option to generate a single application bitstream. You do not have to specify the start address since you may program the image to any available location in the QSPI flash memory. To load the image, you must correctly point to the starting address of the stored image in flash memory.

    If you choose to disable this option, unselect the Use relative address checkbox. You must provide the Start address for the image in flash memory.

    Figure 74. Specifying Parameters for Single .rpd Stored in Flash Memory
  7. By default, the .rpd file type is little-endian. If you are using a third-party programmer that does not support the little-endian format, set Bit swap to On to generate the .rpd file in big endian format.
    Note: The rsu1.tcl script that Intel provides performs the bit swap operation. Consequently, if you are using this script, set Bit swap to Off.
  8. On the Input Files tab, click Add Bitstream. If necessary, change the Files of type to SRAM Object File (*.sof). Then, select factory image .sof file and click Open.
    Figure 75. Specify the .sof File
  9. Select the .sof and then click Properties. Turn On Generate RSU factory update image. Specify the Bootloader file.
    Note: You only have to specify the Bootloader file for Intel® Agilex™ SX devices.
    Figure 76. Specify the .sof File
  10. Click Generate to generate the RSU programming files. You can now update the decision firmware, decision firmware data, and the factory image in flash memory. You can save the configuration in a .pfg file for later use.