Intel® Simics® Simulator for Intel® FPGAs: Agilex™ 5 E-Series Virtual Platform User Guide

Download PDF
ID 786901
Date 4/01/2024
Public
Document Table of Contents
Document Table of Contents x
1. About This Document 2. Agilex™ 5 E-Series Intel® Simics® Virtual Platforms 3. Agilex™ 5 E-Series Virtual Platform Component Intel® Simics® Models 4. Running a Simulation with the Agilex™ 5 E-Series HPS Model 5. Supported Use Cases 6. Troubleshooting Issues When Migrating Software from Intel® Simics® to Hardware A. Document Revision History
1. About This Document x
1.1. Terminology 1.2. List of Acronyms
2. Agilex™ 5 E-Series Intel® Simics® Virtual Platforms x
2.1. Agilex™ 5 E-Series Universal Virtual Platform
2.1. Agilex™ 5 E-Series Universal Virtual Platform x
2.1.1. Agilex™ 5 E-Series Universal Virtual Platform Overview 2.1.2. Agilex™ 5 E-Series Universal Virtual Platform User-Configurable Parameters 2.1.3. Agilex™ 5 E-Series Virtual Platform Key Capabilities
2.1.1. Agilex™ 5 E-Series Universal Virtual Platform Overview x
2.1.1.1. Agilex™ 5 HPS Component 2.1.1.2. HPS Subsystem Component 2.1.1.3. FPGA Fabric Design 2.1.1.4. qsys_top Component 2.1.1.5. FPGA Component 2.1.1.6. Board Component 2.1.1.7. System Component 2.1.1.8. Target Script
2.1.3. Agilex™ 5 E-Series Virtual Platform Key Capabilities x
2.1.3.1. Boot-To-Operating System Prompt 2.1.3.2. Basic Ethernet 2.1.3.3. CPU Power-On and Boot Core Selection 2.1.3.4. Reset Flow 2.1.3.5. General Purpose I/O (GPIO) Loopback 2.1.3.6. USB Disks Hot-Plug Support 2.1.3.7. On-Chip Memory IP FPGA Fabric Example Design 2.1.3.8. FPGA-to-HPS Bridges 2.1.3.9. Exercising Peripheral Subsystem in FPGA Fabric Design 2.1.3.10. USB Controller Host/Device Mode Configuration 2.1.3.11. B0 Silicon Features Selection
3. Agilex™ 5 E-Series Virtual Platform Component Intel® Simics® Models x
3.1. Agilex™ 5 E-Series HPS Intel® Simics® Model 3.2. Virtual Platform HPS Subsystem Components 3.3. Virtual Platform qsys_top Components 3.4. Virtual Platform Board Components 3.5. Modeling Support Limitations
3.1. Agilex™ 5 E-Series HPS Intel® Simics® Model x
3.1.1. Agilex™ 5 E-Series HPS Intel® Simics® Model Architecture 3.1.2. PSS Subsystem Components 3.1.3. MPU and APS Subsystem 3.1.4. MPFE Subsystem 3.1.5. Additional Agilex™ 5 E-Series HPS Components 3.1.6. Agilex™ 5 E-Series B0 Features Support
3.2. Virtual Platform HPS Subsystem Components x
3.2.1. External Memory Interface (EMIF) 3.2.2. Security Device Manager (SDM)
3.3. Virtual Platform qsys_top Components x
3.3.1. FPGA Fabric
3.4. Virtual Platform Board Components x
3.4.1. Marvel EMAC PHY 3.4.2. SD Card Device 3.4.3. ONFI NAND Memory Device 3.4.4. SPI Flash Device 3.4.5. AT24Cxx EEPROM Device 3.4.6. I3C Device 3.4.7. USB Disk Device 3.4.8. Intel® Simics® Text Console
4. Running a Simulation with the Agilex™ 5 E-Series HPS Model x
4.1. Prerequisites 4.2. Intel® Simics® Simulation Setup for the Agilex™ 5 E-Series Device 4.3. Starting the Simulation 4.4. Getting Device Information from the Intel® Simics® Model
1. About This Document
2. Agilex™ 5 E-Series Intel® Simics® Virtual Platforms
3. Agilex™ 5 E-Series Virtual Platform Component Intel® Simics® Models
4. Running a Simulation with the Agilex™ 5 E-Series HPS Model
5. Supported Use Cases
6. Troubleshooting Issues When Migrating Software from Intel® Simics® to Hardware
A. Document Revision History

4.2. Intel® Simics® Simulation Setup for the Agilex™ 5 E-Series Device

Setting up simulation with the Agilex™ 5 E-Series Universal Virtual Platform (agilex5e-universal) includes the following actions:

  • Initialize the project directory
  • Deploy virtual platform
  • Build virtual platform components
  • Update parameters in the startup script

For more information about setting up simulation, refer to Simulation Set Up in Intel® Simics® Simulator for Intel® FPGAs User Guide.

To complete the initial setup for simulation with the Agilex™ 5 E-Series Intel® Simics® model using the Agilex™ 5 E-Series Universal Virtual Platform, perform the following steps:

  1. Start a new terminal session.
  2. Switch directories to where you want to create the project directory. For example: 
    cd /home/simicsUser/SimicsEnv/
  3. Create the working directory: 
    mkdir project-1
cd project-1
  4. Initialize the project directory and deploy the platform:
    <simics_installdir>/simics_intelfpga_cli –-deploy agilex5e-universal

    The command results in the following output: 

    Intel Simics Simulator for Intel(R) FPGA CLI:
INFO: Preparing to initialize
/home/simicsUser/SimicsEnv/project-1 as an Intel Simic workspace
Project created successfully
    Confirm that the project directory has been initialized and the simics and simics-gui commands appear in the project directory. Also, ensure that the targets directory is created and includes the target script that corresponds to the deployed platform. A listing of your project directory should include the following files and directories:
    • bin/
    • compiler.mk
    • config.mk
    • doc/
    • documentation
    • GNUmakefile
    • modules/
    • simics
    • simics-gui
    • simics-riscfree
    • targets/

    If you want to add the project directory to a source control directory, do not add these files because they are always created automatically.

  5. Build the virtual platform components: 
    make
    The command results in the following output: 
    === Environment Check ===
'/home/simicsUser/SimicsInstallDir/project-1' is up-to date
gcc version 9
=== Building module agilex5e-universal-board-comp ===
=== Building module agilex5e-universal-fpga-comp ===
=== Building module agilex5e-universal-system-comp ===
Copying agilex5_icon_84x84.png

After completing the initial setup, customize the Intel® Simics® target script for the selected virtual platform by modifying the parameters in the script. The agilex5e-universal.simics virtual platform target script contains parameters to specify the paths of the binary files used in the simulation.

For example, if you want to run a simulation of the Agilex™ 5 E-Series HPS booting from an SD card, set the $sd_image_filename and $fsbl_image_filename target script parameters. These parameters correspond to the image of the SD Card (includes U-Boot, ATF, Linux kernel, and Linux file system) and the image of the u-boot SPL, respectively.

The example script that follows shows these parameters set.
Important: If you want to customize any of the components in the virtual platform (for example, create your system/board/FPGA component), edit the components before running the make command. This way, the target script takes the customized binaries/Python components generated from the build.

Update the target script with the binaries that are used in the simulation. The following example shows an updated target script: 

# agilex5e-universal.simics Target script

$sd_image_filename = "gsrd-console-image-agilex5.wic"
$fsbl_image_filename = "u-boot-spl-dtb.bin"

# Options for platform images
if not defined sd_image_filename {$sd_image_filename = ""}
if not defined nand_data_image_filename {$nand_data_image_filename = ""}
if not defined nand_spare_image_filename {$nand_spare_image_filename = ""}
if not defined qspi_image_filename {$qspi_image_filename = ""}
 
# FSBL Image name
if not defined fsbl_image_filename {$fsbl_image_filename = ""}

For instructions on obtaining prebuilt binaries or building your own binaries, refer to Linux GSRD Intel® Simics® Virtual Platform for Agilex™ 5 E-Series on RocketBoards.org.

Level Two Title