Agile 5 - Premium - Enhanced HPS User Guide

[BRSOCO]

Hi,

I have been following the Agilex™ 5E HPS Enhanced System Example Design tutorial and I've identified an error in the Hardware Compilation section that prevents the build flow from completing successfully.

The issue lies in the quartus_pfg command intended to generate the legacy_baseline_hps_debug.sof file.

Steps to Reproduce

Follow the tutorial instructions up to the "Hardware Compilation" section.

Run the first two make commands:

cd $TOP_FOLDER/agilex5e-ed-hps-enhanced/src/hw
make legacy_baseline-build
make legacy_baseline-sw-build

These steps complete successfully, creating output_files/legacy_baseline.sof and software/hps_debug/hps_wipe.ihex respectively.

Execute the quartus_pfg command exactly as specified in the tutorial:

Generated bash
quartus_pfg -c output_files/legacy_baseline.sof\ output_files/legacy_baseline_hps_debug.sof\ -o hps_path=software/hps_debug/hps_wipe.ihex

Actual Behavior (The Error)

The command fails with the following error, because the legacy_baseline_hps_debug.sof file does not exist yet and the command syntax is misinterpreted:

Generated code
Error (19509): Cannot locate file output_files/legacy_baseline.sof output_files/legacy_baseline_hps_debug.sof -o.
Error: Quartus Prime Programming File Generator was unsuccessful. 1 error, 0 warnings

Analysis of the Problem

The provided command incorrectly lists legacy_baseline_hps_debug.sof as a second input file for the conversion. However, this file is the intended output of the operation. The correct syntax for quartus_pfg in this context is:
quartus_pfg -c <input_file> <output_file> [options]

Proposed Correction

The command needs to be corrected to properly specify the input and output files.

Before (Incorrect command from the tutorial):

This command fails because it treats the output file as a second input file.
quartus_pfg -c output_files/legacy_baseline.sof\ output_files/legacy_baseline_hps_debug.sof\ -o hps_path=software/hps_debug/hps_wipe.ihex

After (Corrected command that works):

This command correctly specifies input.sof, output.sof, and then the options.
quartus_pfg -c output_files/legacy_baseline.sof output_files/legacy_baseline_hps_debug.sof -o hps_path=software/hps_debug/hps_wipe.ihex

With this corrected command, the legacy_baseline_hps_debug.sof file is generated successfully, and the subsequent "Build Core RBF" step can proceed without errors.