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

Download PDF
ID 784383
Date 7/08/2024
Public
Document Table of Contents
Document Table of Contents x
1. About This Document 2. Intel® Simics® Simulator and Virtual Platforms 3. Intel® Simics® Simulator for Intel® FPGAs Device Portfolio 4. Installing the Intel® Simics® Simulator for Intel® FPGAs 5. Getting Started with Intel® Simics® Simulator 6. Debugging Target Software 7. Networking with the Simulated Target System 8. Intel® Simics® Scripting 9. Software Debug Examples with Intel® Simics® Simulator 10. Document Revision History for Intel® Simics® Simulator for Intel FPGAs User Guide A. Intel® Simics® Simulator Command Reference
1. About This Document x
1.1. Documentation Conventions for Examples 1.2. Terminology 1.3. List of Acronyms
2. Intel® Simics® Simulator and Virtual Platforms x
2.1. Device Model and Virtual Platforms 2.2. Intel® Simics® Simulator 2.3. Intel® Simics® Simulator Architecture
2.2. Intel® Simics® Simulator x
2.2.1. Intel® Simics® Simulator for Intel FPGAs Capabilities
4. Installing the Intel® Simics® Simulator for Intel® FPGAs x
4.1. Installing the Intel® Simics® Simulator for Intel® FPGAs on Linux* Systems 4.2. Installing the Intel® Simics® Simulator for Intel® FPGAs on Microsoft Windows* Systems 4.3. Installing Ashling* RiscFree* IDE for Intel® FPGAs 4.4. Intel® Simics® Simulator for Intel® FPGAs Support
5. Getting Started with Intel® Simics® Simulator x
5.1. Simulation Set Up 5.2. Starting the Simulation 5.3. Intel® Simics® Simulator Command-Line Interface (CLI) 5.4. Hardware Inspection 5.5. Intel® Simics® Simulator Timing
5.1. Simulation Set Up x
5.1.1. Initializing an Intel® Simics® Project and Deploying a Virtual Platform 5.1.2. Understanding Target Scripts
5.2. Starting the Simulation x
5.2.1. Starting a Simulation from a Command Prompt 5.2.2. Starting a Simulation with Ashling* RiscFree* IDE
5.3. Intel® Simics® Simulator Command-Line Interface (CLI) x
5.3.1. Version of the Intel® Simics® Simulator for Intel FPGAs Software 5.3.2. Simulation Run Control from CLI 5.3.3. Intel® Simics® Simulator Command Scope 5.3.4. Intel® Simics® Simulator CLI Variables and Operations 5.3.5. Intel® Simics® Simulator CLI Command Completion and Command History 5.3.6. Intel® Simics® Command-Line Interface Help 5.3.7. Capture of CLI Session to a File 5.3.8. Intel® Simics® Simulator File Location and Intel® Simics® Search Path
5.4. Hardware Inspection x
5.4.1. Listing Objects in the Target System 5.4.2. Processor (CPU) Inspection 5.4.3. Device Inspection 5.4.4. Memory Mapping and Memory Inspection 5.4.5. Logging
5.4.2. Processor (CPU) Inspection x
5.4.2.1. Listing Processors 5.4.2.2. Inspect Processor Registers
5.4.3. Device Inspection x
5.4.3.1. Retrieve List of Devices 5.4.3.2. Inspecting Device Registers
5.4.4. Memory Mapping and Memory Inspection x
5.4.4.1. Memory Mapping Inspection 5.4.4.2. Memory Inspection
5.4.5. Logging x
5.4.5.1. Breakpoints on CLI Log Messages
5.5. Intel® Simics® Simulator Timing x
5.5.1. CPU Frequency 5.5.2. CPU Cycles and Steps 5.5.3. Events 5.5.4. Enable Real Time
6. Debugging Target Software x
6.1. Intel® Simics® Debugger and Debug Context 6.2. Capturing Serial Console Output 6.3. Breakpoints 6.4. Debugging Target Software with Symbol Files 6.5. Debugging Target Software with Ashling* RiscFree* Debugger 6.6. Capturing CPU Instruction Execution Trace
6.3. Breakpoints x
6.3.1. Memory Breakpoints 6.3.2. Temporal Breakpoints 6.3.3. CPU Control Register Breakpoints 6.3.4. Hardware Access Breakpoints 6.3.5. CPU Register Breakpoints 6.3.6. Tracing Breakpoints 6.3.7. Text Console Activity Breakpoints
6.4. Debugging Target Software with Symbol Files x
6.4.1. Loading Symbol Files in a Simulation
6.5. Debugging Target Software with Ashling* RiscFree* Debugger x
6.5.1. Remote Debugging with RiscFree* IDE
6.5.1. Remote Debugging with RiscFree* IDE x
6.5.1.1. Remote Debugging With Intel® Simics® Simulation and RiscFree* IDE on the Same System 6.5.1.2. Remote Debugging With Intel® Simics® Simulation and RiscFree* IDE on Different Systems 6.5.1.3. Remote Access to the Target System Serial Console
7. Networking with the Simulated Target System x
7.1. Network Simulation and Service Node 7.2. Connectivity Between Host PC and Target System
7.2. Connectivity Between Host PC and Target System x
7.2.1. Port Forwarding 7.2.2. Transferring Files Between Host PC and Target System 7.2.3. Accessing Target System from Host PC Through HTTP 7.2.4. Networking Commands Reference Table
7.2.1. Port Forwarding x
7.2.1.1. Incoming Port Forwarding 7.2.1.2. Outgoing Port Forwarding
7.2.1.1. Incoming Port Forwarding x
7.2.1.1.1. Example of an SSH Connection with Incoming Port Forwarding
7.2.1.2. Outgoing Port Forwarding x
7.2.1.2.1. Example of SSH Connection With Outgoing Port Forwarding 7.2.1.2.2. Example of SSH Connection via NAPT
7.2.2. Transferring Files Between Host PC and Target System x
7.2.2.1. Transferring Files with SCP service 7.2.2.2. Transferring Files with TFTP service
7.2.2.1. Transferring Files with SCP service x
7.2.2.1.1. Transferring Files With SCP Service via Forwarding Ports 7.2.2.1.2. Transferring Files with SCP from Target System to Host PC via NAPT
7.2.2.2. Transferring Files with TFTP service x
7.2.2.2.1. TFTP Using Forwarding Port 7.2.2.2.2. TFTP via NAPT 7.2.2.2.3. TFTP Using TFTP Server in Intel® Simics® Service Node
8. Intel® Simics® Scripting x
8.1. Scripts in CLI
8.1. Scripts in CLI x
8.1.1. Variables 8.1.2. Command Return Values 8.1.3. Control Flow Commands 8.1.4. Local Variables 8.1.5. Integer Conversion 8.1.6. Accessing Configuration Parameters 8.1.7. Error Handling in Scripts 8.1.8. Script Branches
8.1.8. Script Branches x
8.1.8.1. Script Branches Commands 8.1.8.2. Variables in Script Branches 8.1.8.3. Branch Synchronization 8.1.8.4. Canceling Script Branches 8.1.8.5. Script Branches Restrictions
9. Software Debug Examples with Intel® Simics® Simulator x
9.1. Debugging Linux* User-Mode Application
9.1. Debugging Linux* User-Mode Application x
9.1.1. Debugging a Linux Application with GDB 9.1.2. Debugging a Linux Application with RiscFree* IDE
9.1.1. Debugging a Linux Application with GDB x
9.1.1.1. Debugging with GDB Debug from Host PC Using Forwarding Ports 9.1.1.2. Debugging with GDB from Host PC with Intel® Simics® Simulator GDB Server
1. About This Document
2. Intel® Simics® Simulator and Virtual Platforms
3. Intel® Simics® Simulator for Intel® FPGAs Device Portfolio
4. Installing the Intel® Simics® Simulator for Intel® FPGAs
5. Getting Started with Intel® Simics® Simulator
6. Debugging Target Software
7. Networking with the Simulated Target System
8. Intel® Simics® Scripting
9. Software Debug Examples with Intel® Simics® Simulator
10. Document Revision History for Intel® Simics® Simulator for Intel FPGAs User Guide
A. Intel® Simics® Simulator Command Reference

5.4.3.2. Inspecting Device Registers

Intel® Simics® simulator provides several commands that allow you to inspect status and configuration registers in a device.

The print-device-regs command allows you to obtain information about the registers in a device bank. The syntax of this command is the following: 

print-device-regs bank [pattern] [-s]

The bank argument can be either a device or a bank object (i.e., device.bank.<bank-name> ). If this argument is a device, the register information of all banks in the device are listed. The pattern argument is used as a filter to show only the registers that match the pattern provided. The register information is listed starting from the lower register offset, but the -s argument can be used to list the register alphabetically.

Some examples of using the print-device-regs command are as follows: 

# Intel Simics simulator CLI  
simics> print-device-regs bank=system.board.fpga.soc_inst.hps_subsys.agilex_hps.sdmmc.bank.regs
------------------------------------
Offset   Name     Size     Value    
------------------------------------
0x0      HRS00     4      0x10000
0x4      HRS01     4      0x32
0x8      HRS02     4      0x30000
0xc      HRS03     4      0x0
0x10     HRS04     4      0x2000
:                         0x28000001
------------------------------------

simics> print-device-regs bank=system.board.fpga.soc_
inst.hps_subsys.agilex_hps.sdmmc.bank.sdmmc_bank pattern="SRS*"
------------------------------------
Offset   Name     Size    Value    
------------------------------------
0x200    SRS00     4      0x0
0x204    SRS01     4      0x47200
0x208    SRS02     4      0x0
0x20c    SRS03     4      0xclb0033
:     
------------------------------------

In the previous capture, you can see some of the registers that are under the system.board.fpga.soc_inst.hps_subsys.agilex_hps.sdmmc.bank.regs bank. Also, it shows how to use the pattern argument to view only registers that starts with SRS prefix. In both examples, you can see the offset, the size, and current value of the register.

You can also get detailed information about a specific register. For this, use the print-device-reg-info command to view information about all fields that integrate this register, including its name, range/width in bits, access type (R/W, RO, and so on), and value. The following is the register syntax: 

print-device-reg-info register

The register argument is the register path (device.bank.register) for which you want to obtain the information. The following capture of the Intel® Simics® simulator console shows an example of how the print-device-reg-info command is being used: 

# Intel Simics simulator CLI 
simics> print-device-reg-info  system.board.fpga.soc_inst.hps_subsys.agilex_hps.sdmmc.bank.sdmmc_bank.SRS03
 [system.board.fpga.soc_inst.hps_subsys.agilex_hps.sdmmc.bank.sdmmc_bank.SRS03]

                     Bits : 32
                   Offset : 0x20c
                    Value : 203096115 (0x0c1b0033)

Bit Fields:
    Reserved_15 @ [31:30] : 00      "(Read Only)"
           Cidx @ [29:24] : 001100  "(Read Write)"
             Ct @ [23:22] : 00      "(Read Write)"
            Dps @ [21:21] : 0       "(Read Write)"
           Cice @ [20:20] : 1       "(Read Write)"
          Crcce @ [19:19] : 1       "(Read Write)"
            Scf @ [18:18] : 0       "(Read Write)"
            Rts @ [17:16] : 11      "(Read Write)"
      Reserved_8 @ [15:9] : 0000000 "(Read Only)"
              Rid @ [8:8] : 0       "(Read Write)"
             Rece @ [7:7] : 0       "(Read Write)"
             Rect @ [6:6] : 0       "(Read Write)"
             Msbs @ [5:5] : 1       "(Read Write)"
             Dtds @ [4:4] : 1       "(Read Write)"
              Ace @ [3:2] : 00      "(Read Write)"
              Bce @ [1:1] : 1       "(Read Write)"
             Dmae @ [0:0] : 1       "(Read Write)"

There is a list of commands that are recommended to access registers in devices. These commands can be classified into the following categories depending on the action and side effects:

  • Target register: Describes how the register to access is indicated. It can use a register name or an offset. The argument for each of these two cases is as follows:
    • By register name: 
      <command> reg_name device.bank.regs.<reg_name>) [field]
    • By offset: 
      <command> bank(device.bank.regs) offset=<offset> size=<size>

    In case of “By offset” operation, the offset corresponds to the offset of the register in the bank indicated and the size corresponds to the number of bytes to access in the register.

  • Operation Direction: Describes if the operation to the register is read or write. In the case of write operations, the value to be written in the register is an additional argument to be provided to the command.
    • Side effects: This classification implies that the command can be non-intrusive or not. In the case of having side effects, the write or read operation can create undesired effects in the simulation, such as the trigger of interrupt or exception.

The following table lists commands that can be called:

Table 13.  Commands to Inspect Device Registers
Operation Direction Target Register Commands
No Side Effects Side Effects
Write By Name set-device-reg write-device-reg
By Offset set-device-offset write-device-offset
Read By Name get-device-reg read-device-reg
By Offset get-device-offset read-device-offset

The following Intel® Simics® simulator console capture shows an example on how you can use some of the above commands: 

# Intel Simics simulator CLI

simics> get-device-reg system.board.fpga.soc_inst.hps_subsys.agilex_hps.sdmmc.bank.sdmmc_bank.SRS03
0xc1b0033

simics> set-device-reg system.board.fpga.soc_inst.hps_subsys.agilex_hps.sdmmc.bank.sdmmc_bank.SRS03 0xFF

simics> get-device-reg system.board.fpga.soc_inst.hps_subsys.agilex_hps.sdmmc.bank.sdmmc_bank.SRS03
0xff

simics> get-device-offset system.board.fpga.soc_inst.hps_subsys.agilex_hps.sdmmc.bank.sdmmc_bank offset = 0x20c size=4
0xff (LE)

simics> write-device-offset system.board.fpga.soc_inst.hps_subsys.agilex_hps.sdmmc.bank.sdmmc_bank offset = 0x20c size=4 0xCC

simics> read-device-offset system.board.fpga.soc_inst.hps_subsys.agilex_hps.sdmmc.bank.sdmmc_bank offset = 0x20c size=4
0xcc (LE)

simics> read-device-reg system.board.fpga.soc_inst.hps_subsys.agilex_hps.sdmmc.bank.sdmmc_bank.SRS03
0xcc

In the previous capture, several read and write operations are being done to the system.board.fpga.soc_inst.hps_subsys.agilex_hps.sdmmc.bank.sdmmc_bank.SRS03 register. It started using the set/get commands to write and read back the 0xFF value. After this, the read/write commands are used to write and read back the 0xCC value. When using access by offset, the offset is 0x20C, which corresponds to the offset value of SRS03 in the register bank of the sdmmc device.

Level Two Title