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

ID 784383
Date 12/04/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

6.5.1.2. Remote Debugging With Intel® Simics® Simulation and RiscFree* IDE on Different Systems

This section describes how to setup a remote debug session with the RiscFree* IDE debugger when this runs in a different host PC than the one where the Intel® Simics® session is being run. This allows for example to perform some debug in an Intel® Simics® session from someone else.

  1. Complete the initial setup on the system that runs the Intel® Simics® simulation:
    1. Start an Intel® Simics® simulation session either using simics or simics-gui commands as described in Starting the Simulation.
    2. From the Intel® Simics® CLI console, run the start-eclipse-backend command.
      This command enables Intel® Simics® simulator to accept a remote connection form a debugger. By default, it enables a TCP connection with the Simics name. The command returns the URL path for the connection.
      #Intel Simics simulator CLI 
      simics> start-eclipse-backend
      Starting TCF on:
       TCP:localhost:1534
       TCP:10.116.92.41:1534

      In this example, the remote connection must use either the localhost:1534 path from the same host system or the 10.116.92.41:1534 path from a remote system.

      Remember this information because you need it to create the connection between RiscFree* IDE and your Intel® Simics® simulation session.

  2. On a different system, start the RiscFree* IDE from your RiscFree* IDE installation directory (that is, do not use the simic-riscfree command):
    #Linux terminal session
    $ <riscfree_installdir>/RiscFree/RiscFree
    You are prompted to choose (or create) a workspace.
  3. In the RiscFree* IDE, create a connection from RiscFree* IDE system to the Intel® Simics® simulation system:
    1. From the New Connection menu, select Generic Connection and click Next.
    2. Complete the New Connection wizard as follows:
      1. Assign a name to the connection.
      2. Select the type of protocol used for the connection. TCP is the default connection type created when you ran the start-eclipse-backend command.
      3. Assign the remote system IP address and port number needed to connect to the Intel® Simics® session. This information is provided when you run the start-eclipse-backend command.
      Click Finish when done.

      By default, the autoConnect attribute is set to true. After completing the connection setup, RiscFree* IDE attempts to connect to the remote Intel® Simics® session.

  4. To start the debug session, click the Target actions icon and select Debug.

After the debug session starts, you can control your Intel® Simics® simulation session from the RiscFree* IDE and preform any debugging task like setting breakpoints.

Disconnect from the your Intel® Simics® simulation session gracefully by using the Disconnect icon in the RiscFree* IDE: