Appendix: Import the Debug Configuration

About this task

With the Efinity software v2022.1 and higher, you do not need to import the debug configuration. These instructions are for reference if you are using an earlier software version with legacy Eclipse IDE.

To simplify the debugging steps, the Sapphire SoC includes debug configurations that you import. There are several configuration files, depending on which board you use.

Table 1. Debug Configurations
Debug Configuration Use for
default Debugging software on Trion® development boards.
default_ti Debugging software on Titanium development boards.
default_softTap 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.)

To import a debug configuration and use it to launch a debug session:

Procedure

  1. Launch Eclipse by running the run_eclipse.bat file (Windows) or run_eclipse.sh (Linux).
  2. Select a workspace (if you have not set one as a default).
  3. Open the axiDemo project or select it under C/C++ Projects.
  4. Right-click the axiDemo project name and choose Import.
  5. In the Import dialog box, choose Run/Debug > Launch Configurations.
  6. Click Next. The Import Launch Configurations dialog box opens.
  7. Browse to the following directory and click OK:
    OptionDescription
    Windows embedded_sw\<SoC module>\config
    Linux embedded_sw/<SoC module>/config_linux
  8. Check the box next to config (Windows) or config_linux (Linux).
  9. Click Finish.
  10. Right-click the axiDemo project name and choose Debug As > Debug Configurations.
  11. Enter axiDemo in the Project box.
  12. Enter build\axiDemo.elf in the C/C++ Application box.
  13. Windows only: you need to change the path to the cpu0.yaml file:
    1. Click the Debugger tab.
    2. In the Config options box, change ${workspace_loc} to the full path to the <SoC module> directory.
      Note: For the cpu0.yaml path, make sure to use \\ as the directory separator because the first slash escapes the second one. For example, use:
      c:\\Efinity\\2021.2\\project\\<project name>\\embedded_sw\\<SoC module>\\cpu0.yaml
  14. Click Debug.

Results

Note: If Eclipse prompts you to switch to the Debug Perspective, click Switch.