Visible to Intel only — GUID: opg1719202661900
Ixiasoft
1. About the RiscFree* IDE
2. Getting Started with the Ashling* RiscFree* IDE for Intel® FPGAs
3. Using Ashling* RiscFree* IDE for Intel® FPGAs with Nios® V Processor System
4. Using Ashling* RiscFree* IDE for Intel® FPGAs with Arm* Hard Processor System
5. Debugging Features with RiscFree* IDE for Intel® FPGAs
6. Debugging with Command-Line Interface
7. Ashling RiscFree* Integrated Development Environment (IDE) for Intel® FPGAs User Guide Archives
8. Document Revision History for the Ashling RiscFree* Integrated Development Environment (IDE) for Intel® FPGAs User Guide
A. Appendix
3.1. Importing Nios® V Processor Project
3.2. Building Nios® V Processor Project
3.3. Setting Run Configuration to Download Nios® V Processor Project
3.4. Setting Debug Configuration to Debug Nios® V Processor Project
3.5. Setting Debug Configuration to Debug a Booting Nios® V Processor Project
3.6. Debugging Tools
5.1. Debug Features in RiscFree* IDE
5.2. Processor System Debug
5.3. Heterogeneous Multicore Debug
5.4. Debugging µC/OS-II Application
5.5. Debugging FreeRTOS Application
5.6. Debugging Zephyr Application
5.7. Arm* HPS On-Chip Trace
5.8. Debugging the Arm* Linux Kernel
5.9. Debugging Target Software in an Intel® Simics Simulator Session
Visible to Intel only — GUID: opg1719202661900
Ixiasoft
3.5. Setting Debug Configuration to Debug a Booting Nios® V Processor Project
Debug Configuration reuses the setting made in Run Configuration. If you have completed the setting, you can skip this subchapter.
You can download and run Nios® V processor software project on the targeted Intel FPGA using the Ashling* RiscFree* IDE for Intel® FPGAs. To run the project, follow these steps:
- Right-click the project folder (application or BSP) in the project explorer and select Debug As > Debug configurations.
- Select Ashling RISC-V Hardware Debugging > <Project Name>. Ensure the Project and C/C++ Application match with your project name and your project .elf file respectively.
- Under the Main tab, for C/C++ Application, browse to select the application build .elf file. For example: hello.elf.
Figure 18. Debug Configurations for Nios® V Processor—Main Tab
- Under the Debugger tab, set these settings:
- Debug probe: Agilex SI/SoC Dev Kit (Name of the FPGA board/development kit)
- Transport type: JTAG
- JTAG frequency: 16 MHz
Figure 19. Debug Configurations for Nios® V Processor—Debugger Tab - Click Auto-detect Scan Chain to automatically detect JTAG scan chain information of the target device. Select the options from Device/Tap selection and Core selection.
- Navigate to Startup tab, go to Load Image and Symbols, turn off Load Image.
Figure 20. Disable Load Image
- Based on the OS you use, configure the OS Awareness settings as follows:
- Intel HAL: No OS Awareness configuration is required.
- Other OS: Under the OS Awareness tab, turn on Enable OS Aware Debugging, and select the OS version applicable to you as listed below:
- OS: μC/OS-II and Version: 2.93.0
- OS: FreeRTOS and Version: 10.5.0
- OS: Zephyr and Version: 3.2.0
Note: Nios® V processor does not support Linux OS.
Figure 21. Enabling OS Aware Debugging in RISC-V Hardware Debugging
- Click Debug. RiscFree* IDE for Intel® FPGAs downloads the program to the target and you can find the console prints as shown in the following diagram.
Figure 22. Console Prints after Debug Connection is SuccessfulCurrently, the program is running in debug mode. You can check the Debug tab on the left side of the RiscFree* IDE for Intel® FPGAs.Figure 23. Debug state - RunningNote: Before you proceed to debug, make sure the debugger is in Suspended state. For more information on how to suspend the debugger, refer to GUI for Debugging.Figure 24. Debug state - Suspended
- Click Suspend icon in the Debug bar.
To verify the boot copier has copied the application successfully, continue with the following steps:
- Go to Window > Show View > Memory Browser.
- Select Add Memory Monitor.
- Provide the memory address 0x0 and click OK.
Figure 25. Memory Browser at Address 0x0
- Go to <Working directory>/software/app/build/Default folder.
- Open the hello.elf.objdump file.
- Search for Disassembly of section .entry.
- The disassembly shows that the information at starting address 0 is 0x3680006f, which is exactly the same as in the Memory Browser.
- You can continue to verify section .exceptions.
Figure 26. Disassembly of an Application
Related Information