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

Download PDF
ID 786901
Date 11/16/2024
Public
Document Table of Contents
Document Table of Contents x
1. About This Document 2. Agilex™ 5 Intel® Simics® Virtual Platforms 3. Agilex™ 5 Universal Virtual Platform Component Intel® Simics® Models 4. Running a Simulation with the Agilex™ 5 HPS Model 5. Supported Use Cases 6. Troubleshooting Issues When Migrating Software from Intel® Simics® to Hardware A. Document Revision History for Intel Simics Simulator for Intel FPGAs Agilex 5 Virtual Platform User Guide
1. About This Document x
1.1. Terminology 1.2. List of Acronyms
2. Agilex™ 5 Intel® Simics® Virtual Platforms x
2.1. Agilex™ 5 Universal Virtual Platform
2.1. Agilex™ 5 Universal Virtual Platform x
2.1.1. Agilex™ 5 Universal Virtual Platform Overview 2.1.2. Agilex™ 5 Universal Virtual Platform User-Configurable Parameters 2.1.3. Agilex™ 5 Universal Virtual Platform Key Capabilities
2.1.1. Agilex™ 5 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 Universal 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. Agilex™ 5 HPS Component and Stepping Silicon Features Selection
3. Agilex™ 5 Universal Virtual Platform Component Intel® Simics® Models x
3.1. Agilex™ 5 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 HPS Intel® Simics® Model x
3.1.1. Agilex™ 5 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 HPS Components 3.1.6. Agilex™ 5 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 HPS Model x
4.1. Prerequisites 4.2. Intel® Simics® Simulation Setup for the Agilex™ 5 Device 4.3. Starting the Simulation 4.4. Getting Device Information from the Intel® Simics® Model
1. About This Document
2. Agilex™ 5 Intel® Simics® Virtual Platforms
3. Agilex™ 5 Universal Virtual Platform Component Intel® Simics® Models
4. Running a Simulation with the Agilex™ 5 HPS Model
5. Supported Use Cases
6. Troubleshooting Issues When Migrating Software from Intel® Simics® to Hardware
A. Document Revision History for Intel Simics Simulator for Intel FPGAs Agilex 5 Virtual Platform User Guide

2.1.3.6. USB Disks Hot-Plug Support

The virtual platform instantiates up to three USB disks that support hot-plugging by using Intel® Simics® CLI commands to emulate plugging and unplugging the USB disks.

In the virtual platform, only the disks that have a file image assigned to them are connected by default if a USB port is available. In the virtual platform, there is a single port of the USB 3.1 controller (usb1_typec) and one for the USB 2.0 OTG controller (usb0_otg) to match the real Agilex™ 5 development kit, and because of this, you can connect up to two disks at a time.

The usb3_disk is a SuperSpeed disk. You can connect it to any of the ports even though when using the plug command with this disk, the auto-completion feature of Intel® Simics® CLI shows only the usb1_typec port from the USB 3.1 controller (usb1_typec).

The usb3_hs_disk and usbotg_disk are HighSpeed disks. You can connect them to either a USB 3.1 controller (usb1_typec) or a USB 2.0 OTG controller (usb0_otg) port.

If a disk is already connected to a port and you want to connect (plug) another disk in this port, you must disconnect (unplug) the former one first. For example, if usb3_disk is already connected to usb1_typec port, to connect the usb3_hs_disk disk into this port, you must unplug the usb3_disk disk first to release the usb1_typec port and then can connect the usb3_hs_disk to this port with the plug command.

If a disk image file is assigned to the usb3_disk or to the usb3_hs_disk, it is connected by default to the usb1_typec port. Since only one of these can be connected to the usb1_typec port, the usb3_disk has precedence over the usb3_hs_disk. In the case of usbotg_disk, it is connected by default to the usb0_otg port if a disk image is assigned to it.

The following table describes the disks available in this virtual platform and their characteristics:
Table 9.  Characteristics of Disks Available in the Virtual Platform
Disk Type Port to Connect USB Controller
usb3_disk SuperSpeed (SS)

usb3_disk_comp

usb1_typec (default)

usb0_otg 2

USB 3.1 Gen 1 (usb3)
usb3_hs_disk High Speed (HS)

usb3_disk_hs_comp

usb1_typec (default)

usb0_otg

USB 3.1 Gen 1 (usb3)
usbotg_disk High Speed (HS)

usb3_disk_hs_comp

usb0_typec

usb0_otg (default)

USB 2.0 OTG (usb2)
The following CLI commands emulate plugging, unplugging, and port connected to the USB disks:
Table 10.  CLI Commands
Task Command
Plugging
  • system.board.usb3_disk.plug port = usb1_typec
  • system.board.usb3_hs_disk.plug port = usb1_typec
  • system.board.usbotg_disk.plug port = usb0_otg
Unplugging
  • system.board.usb3_disk.unplug
  • system.board.usb3_hs_disk.unplug
  • system.board.usbotg_disk.unplug
Port connected to
  • system.board.usb3_disk.usb_device->usb_host
  • system.board.usb3_hs_disk.usb_device->usb_host
  • system.board.usbotg_disk.usb_device->usb_host
2 Not shown as an option when using the auto-completion feature with the plug Intel® Simics® command.
Level Two Title