Agilex™ 7 Configuration User Guide

ID 683673
Date 11/04/2024
Public
Document Table of Contents

5.5.1.1. Generating the Initial RSU Image Using SOF Files

Follow these steps to generate the initial RSU image:

  1. On the File menu, click Programming File Generator.
  2. Select Agilex™ 7 from the Device family drop-down list.
  3. Select the configuration scheme from the Configuration mode drop-down list. The current Quartus® Prime only supports remote system update feature in Active Serial x4.
  4. On the Output Files tab, assign the output directory and file name.
  5. Select the output file type:
    • JTAG Indirect Configuration File (.jic)/Programmer Object File (.pof)
    • Memory Map File (.map)
    • Raw Programming File (.rpd)
  6. On the Input Files tab, click Add Bitstream, select the factory image .sof file and click Open. Repeat this step for the application image .sof.
  7. On the Configuration Device tab, click Add Device, select your flash memory and click OK. The Programming File Generator tool automatically populates the flash partitions.
  8. Select the FACTORY_IMAGE partition and click Edit.
  9. In the Edit Partition dialog box, select your factory image .sof file in the Input Files drop-down list and click OK.
    Note: You must assign a factory image input file. The Programming File Generator is unable to generate output files if input files are missing for the FACTORY_IMAGE partition.
    Note: You must assign Page 0 to Factory Image. Intel® recommends that you let the Quartus® Prime software assign the Start address of the FACTORY_IMAGE automatically by retaining the default value for Address Mode which is Auto. From the Address Mode drop down list, select Block to set an End address value for the FACTORY_IMAGE. The Programming File Generator reserves and assigns the start and end flash addresses to store BOOT_INFO, SPT0, SPT1, CPB0, and CPB1.
  10. To enable direct factory image fallback, select the BOOT_INFO partition, click the Edit... button, and set Direct factory image fallback to On. This step is optional.
  11. Select the flash memory and click Add Partition.
  12. In the Add Partition dialog box, select application image .sof file from the Input file drop-down list, assign the page number.
  13. Repeat this step for additional application images and click OK. You can add up to seven partitions for seven application images. The page 1 application image is the highest priority, and the page 7 image is the lowest priority.
  14. If you generate .jic files, click Select at the Flash loader, select your device family and device name, and click OK.
  15. Click Generate to generate the remote system update programming files. After generating the programming file, you can proceed to program the flash memory.
    Note:

    The generated .jic file contains only the initial flash data. If a remote host updates the initial flash image and then performs a verify operation using the Programmer, the verify operation fails. Verification fails because the verify operation compares the updated image to the initial flash data. If you want to verify the updated flash image, you read back the updated image from flash and compare it to the expected .rpd file.

    You can use the programmer to examine the flash content and compare it to the new flash image .rpd.

  16. You can optionally Click File > Save As .. to save the configuration parameters as a file with the .pfg extension. The .pfg file contains your settings for the Programming File Generator. After you save the .pfg, you can use this file to regenerate the programming file by running the following command:
    quartus_pfg -c <configuration_file>.pfg

    The .pfg file is actually an XML file which you can edit to replace absolute file paths with relative file paths. You cannot edit the.pfg file for other reasons. You can open and edit the .pfg in the Programming File Generator.