Intel Agilex® 7 Hard Processor System Remote System Update User Guide

ID 683184
Date 6/09/2023
Public

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

Document Table of Contents

4.2.3.5. Creating Combined Application Images

The following command is used to create combined application images:

quartus_pfg -c \
factory_design.sof \
combined_image.rpd \
-o app_image=app_design.sof \
-o app_image_hps_path=app_fsbl.hex \
-o hps_path=factory_fsbl.hex \
-o mode=ASX4 \
-o bitswap=ON \
-o rsu_upgrade=ON \
-o firmware_only=ON \
-o hps=1 \
-o factory_fallback=ON

The following table describes the parameters.

Parameter Description
factory_design.sof Input SOF file, containing the FPGA design for the factory image
combined_image.rpd Output combined application image
-o app_image=app_design.sof Input SOF file, containing the FPGA design for the application image
-o app_image_hps_path=app_fsbl.hex Input HPS FSBL hex file for application image
-o hps_path=fsbl.hex Input HPS FSBL hex file for factory image
-o bitswap=ON Create file in regular binary format
-o rsu_upgrade=ON Select factory upgrade image
-o firmware_only=ON Select to upgrade just decision firmware
-o hps=1 Use only for HPS first designs
-o factory_fallback=ON Optional, use to enable direct factory fallback

For FPGA first case, the parameter “-o hps=1” must be omitted, and the file combined_image.rpd is created.

For HPS first the parameter “-o hps=1” must be passed, and the following two files will be created:

  • combined_image.hps.rpd—the combined application image
  • combined_image.core.rbf—corresponding fabric configuration file

The optional parameter "-o factory_fallback=ON" enables direct factory fallback for all configuration failures.