Intel® Simics® Simulator for Intel® FPGAs: User Guide

ID 784383
Date 7/08/2024
Public
Document Table of Contents

5.4.3.1. Retrieve List of Devices

You can retrieve the list of the Intel® Simics® model devices that are part of the current virtual platform using the “devs” command (only shown the devices that are mapped into a memory space). This command provides information about how many times each device has been accessed, and where they are mapped. The syntax for this command is the following:

devs [device]

You can use the device argument to show information for a single device only. The mappings are presented as start and end offsets within a named memory space. The function number or port name associated with each different mapping for a device is also printed.

The following Intel® Simics® simulator console capture shows a couple of examples of the calling of devs command:

# Intel Simics simulator CLI

Simics> devs
---------------------------------------------------------------------------------
Count  Device                        Space           Range                Fn/Port 
---------------------------------------------------------------------------------
78   system...ccu.bank.caiu0   system...phys_mem 0x000000001c000000 -     0
                                                 0x000000001c000fff
:
0    system...uart0.bank.regs  system...phys_mem 0x0000000010c02000 -     0
                                                 0x0000000010c02fff 
:
69   system....bank.regs       system...phys_mem 0x0000000010a30000 -     0 
                                                 0x0000000010a304ff
:
--------------------------------------------------------------------------------

simics> devs  system.board.fpga.soc_inst.hps_subsys.agilex_hps.ocram

--------------------------------------------------------------------------
Count  Device                     Space          Range             Fn/Port 
--------------------------------------------------------------------------
0      system...ocram    system...phys_mem  0x00000 - 0x7ffff      0
--------------------------------------------------------------------------
Note: In the previous capture, CCU and UART devices are listed when calling the devs command. In the output, you can observe that these are mapped in physical memory and the memory range is provided. The system.board.fpga.soc_inst.hps_subsys.agilex_hps.ocram command is used to only retrieve the device information corresponding to the OCRAM device.