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

ID 786901
Date 11/16/2024
Public
Document Table of Contents

3.4.7. USB Disk Device

This device corresponds to a model of a generic USB Mass Storage device. There are two classes of USB disk devices supported as board devices (both are USB 3.1 Gen 1 and USB 2.0 compatible and can be connected to a USB 2.0 or USB 3.0 port):

  • High-Speed USB disk: USB 2.0 ports natively support this disk. However, USB 3.0 ports also support it.

    Component: usb3_disk_hs_comp

  • SuperSpeed USB disk: USB 3.0 ports natively support this disk. However, USB 2.0 ports also support it. Hence, the disk is backwards-compatible with USB 2.0 standard.

    Component: usb3_disk_comp

Both USB disks can be configured with a size limited to 64 TB, although the actual disk size is taken from the assigned image. The image to be loaded into the disk must be provided as part of the parameters defined in the virtual platform target script. The Intel® Simics® model of the devices implements a simple SCSI controller and supports control and bulk transfers. The model supports the hot-plug feature. Use the following Intel® Simics® commands to handle USB device operations:

Table 27.   Intel® Simics® Commands to Handle USB Device Operations
Command Parameter Purpose
load-file

file

Command for assigning an image file to the USB disk.

plug

port

Command for plugging in the USB device to specified port.

  • USB SuperSpeed (USB-SS) device could be plugged in a usb2 or usb3 port.
  • USB High Speed (USB-HS) devices could be plugged in a usb2 or usb3 port.
unplug

-

Command for unplugging a USB device.

<usb disk hierarchy>.usb_device->usb_host

-

Command to determine if a USB disk is connected to a port. If nothing is returned, it means that the disk is not connected.