Skip to content

altera-fpga/agilex5e-ed-gsrd

Repository files navigation

Golden Hardware Reference Design (GHRD) for Agilex 5 FPGA E-Series

This repository contains Golden Hardware Reference Design (GHRD) for Agilex 5 E-Series System On Chip (SoC) FPGA. The GHRD is part of the Golden System Reference Design (GSRD), which provides a complete solution, including exercising soft IP in the fabric, booting to U-Boot, then Linux, and running sample Linux applications. Refer to the Agilex 5 E-Series Premium Development Kit GSRD and Agilex 5 E-Series Modular Development Kit GSRD for information about GSRD.

The designs are stored in individual folders. Each design can be opened, modified and compiled by using Quartus Prime software. GHRD releases are created for each version of Quartus Prime Software. It is recommended to use the release for your version of Quartus Prime. These reference designs demonstrate the system integration between Hard Processor System (HPS) and FPGA IPs.

Baseline feature

This is applicable to all designs.

  • Hard Processor System (HPS) enablement and configuration
    • Enable dual core Arm Cortex-A76 processor
    • Enable dual core Arm Cortex-A55 processor
    • HPS Peripheral and I/O. eg, NAND, SD/MMC, EMAC, USB, SPI, I2C, UART, and GPIO. (depends on the daughter card).
    • HPS Clock and Reset
    • HPS FPGA Bridge and Interrupt
  • HPS EMIF configuration
  • System integration with FPGA IPs
    • Peripheral subsystem that consists of System ID, Programmable I/O (PIO) IP for controlling DIPSW, PushButton, and LEDs.
    • Debug subsystem that consists of JTAG-to-Avalon Master IP to allow System-Console debug activity and FPGA content access through JTAG
    • 256KB of FPGA On-Chip Memory

Advanced feature

This is only applicable if the feature is enabled.

  • Time-Sensitive Networking (TSN): PHY configuration 2 (RGMII from FPGA HVIO)

The GHRD use cases:

  1. use the precompiled bitstream(sof) in release assets to programm the board.
  2. open and compile the designs with Quartus Prime.
  3. modify and compile the designs with Quartus Prime.

Dependency

  • Altera Quartus Prime 25.1
  • Supported Board
    • Agilex 5 FPGA E-Series 065B Premium Development Kit DK-A5E065BB32AES1 Agilex 5 E-Series Premium Development Kit
    • Agilex 5 FPGA E-Series 065B Modular Development Kit MK-A5E065BB32AES1 Agilex 5 E-Series Modular Development Kit

Tested Platform for the GHRD Build Flow

  • SUSE Linux Enterprise Server 12 SP5

Setup

Several tools are required to be in the path.

  • Altera Quartus Prime 25.1
  • Python 3.11.5 (only required when using command line to build)

Example Setup for Altera Quartus Prime tools

This is recommended, when using command line to build.

export QUARTUS_ROOTDIR=~/intelFPGA_pro/25.1/quartus

Note: Adapt the path above to where Quartus Prime is installed.

export PATH="$QUARTUS_ROOTDIR/bin:$QUARTUS_ROOTDIR/../qsys/bin:$QUARTUS_ROOTDIR/../niosv/bin:$QUARTUS_ROOTDIR/sopc_builder/bin:$QUARTUS_ROOTDIR/../questa_fe/bin:$QUARTUS_ROOTDIR/../syscon/bin:$QUARTUS_ROOTDIR/../riscfree/RiscFree:$PATH"'

Quick start

using command line

Copy and run the desired make command from designs in the root directory. After build, the design files (zip, sof and rbf) can be found in install/designs folder.

using Quartus GUI

  • Launch Quartus.
  • Open the project. Example: a5ed065es-premium-devkit-oobe/legacy-baseline/top.qpf
  • Click the play button to compile the design.
  • The compiled sof can be found in output_folders of the project path.

Designs

Agilex 5 FPGA E-Series 065B Premium Development Kit DK-A5E065BB32AES1

Refer to the individual readme for details of the design.

make a5ed065es-premium-devkit-oobe-legacy-baseline-legacy_baseline-all
make a5ed065es-premium-devkit-oobe-legacy-tsn-cfg2-legacy_tsn_cfg2-all
make a5ed065es-premium-devkit-debug2-legacy-baseline-legacy_baseline-all
make a5ed065es-premium-devkit-emmc-legacy-baseline-legacy_baseline-all
make a5ed065es-premium-devkit-nand-legacy-baseline-legacy_baseline-all

Agilex 5 FPGA E-Series 065B Modular Development Kit MK-A5E065BB32AES1

make a5ed065es-premium-devkit-som-legacy-baseline-legacy_baseline-all

Install location:

After build, the design files (zip, sof and rbf) can be found in install/designs folder. These files are also uploaded as github release assets.

  • <design_name>.zip
    • This is the archeived project files of the individual GHRD.
  • <design_name>.sof
    • Compiled bitstream. Can be programm on board.
  • <design_name>hps_debug.sof
    • This bitstream is injected with hps wipe program. This creates a wait loop to boot with arm debugger. Refer readme