Launch the Debug Script

About this task

With the Efinity software v2022.2 and higher, debugging scripts are available for each software example in the /embedded_sw/efx_hard_soc/software/ directory and are imported into your project when you create a new project or importing existing project into the workspace. You can use these scripts to launch the debug mode.

Table 1. Debug Configurations
Launch Script Description
<app>_ti.launch Debugging software on Titanium development boards.
<app>_softTap.launch Debugging software on Trion or Titanium development boards with the soft JTAG TAP interface. For example, you would need to use the soft TAP if you want to use the OpenOCD debugger and the Efinity® Debugger at the same time. (See Using a Soft JTAG Core for Example Designs.)
<app>_ti_mc.launch Debugging software on Titanium development boards with multiple cores.
<app>_softTap_mc.launch Debugging software on Trion or Titanium development boards with the soft JTAG TAP interface with multiple cores. For example, you would need to use the soft TAP if you want to use the OpenOCD debugger and the Efinity® Debugger at the same time. (See Using a Soft JTAG Core for Example Designs.)

Efinity software v2025.1 introduces a new parameter in soc.h.

With this update, the Efinity RISC-V Embedded Software IDE can distinguish the different device families (Titanium and Topaz) and automatically provide the appropriate .launch file based on your selected device.

Table 2. Usage of the Parameter
Parameter Files/Folder
#define FAMILY_TYPE_TITANIUM smpDemo
  • Includes
  • src
    • makefile
    • smpDemo_ti_mc.launch
    • smpDemo_ti.launch
#define FAMILY_TYPE_TOPAZ smpDemo
  • Includes
  • src
    • makefile
    • smpDemo_tz_mc.launch
    • smpDemo_tz.launch

To debug the gpioDemo project:

Procedure

  1. Right-click gpioDemo > gpioDemo_<family>.launch.
  2. Choose Debug As > gpioDemo > gpioDemo_<family>. Efinity RISC-V Embedded Software IDE launches the OpenOCD debugger for the project.
  3. Click Debug.
  4. Confirm Perspective Switch window would prompt out. Click Switch to switch from C/C++ perspective to Debug perspective to start the debug process.