Intel® Agilex™ Configuration User Guide

ID 683673
Date 10/29/2021

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

Document Table of Contents 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 Intel® Agilex™ from the Device family drop-down list.
  3. Select the configuration scheme from the Configuration mode drop-down list. The current Intel® 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.

    Select the following file types for AS x4 configuration mode:

    • 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 file drop-down list and click OK.
    Note: You must assign Page 0 to Factory Image. Intel® recommends that you let the Intel® 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. Select the flash memory and click Add Partition.
  11. In the Add Partition dialog box, select for application image .sof file from the Input file drop-down list, assign the page number.
  12. 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.
  13. For .jic files,
    Click Select at the Flash loader, select your device family and device name, and click OK.
  14. Click Generate to generate the remote system update programming files. After generating the programming file, you can proceed to program the flash memory.

    The generated .jic file contains only the initial flash data. If a remote host updates the initial flash image and then the application performs a verify operation, 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.

    Note: If you plan to update the factory image, Intel recommends reserving an additional 64 KB space for possible expansion of the factory image. Complete the following steps to reserve extra space for updates to the factory image:
    1. Identify the new end address by adding 64 KB to the existing END ADDRESS of the FACTORY_IMAGE. The end address is available in the .map file. For example, if the current end address is 0x00423FF, the new end address is 0x00523FF .
    2. Repeat the steps to regenerate the new .jic file. On the Configuration Device tab, select the FACTORY_IMAGE partition and click Edit. In the Edit Partition dialog box, under the Address Mode drop down list, select Block to set the new End address value for the FACTORY_IMAGE.
    3. 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.