Skip to main content Link Search Menu Expand Document (external link)

50.002 Computation Structures
Information Systems Technology and Design
Singapore University of Technology and Design
Ian Goh (Spring 2022)

Debugging the FPGA (Alchitry Lab 1.2.7)

This document is written to guide you with debugging the FPGA using Alchitry Lab 1.2.7 builtin debug feature. That being said, there’s nothing wrong using outputs such as the LEDS or 7-segment display to debug. Use whichever method you prefer.

Debug Project

Start by selecting the Debug Project (bug looking icon) in the toolbar.

Select Signals

Select the signals you would like to capture during debugging by ticking the respective checkboxes. Here are two sample scenarios:

Example to debug FSM current state (0-indexed in output):

Example to debug REGFILE read addresses and output:

Build Project

Build the project by clicking on Debug.

Wait patiently… very patiently…

Load Project

Once the build has completed, load the project onto the FPGA by clicking the Program (Flash) button.

Wait

Wait for the FPGA to start up.

Open Wave Capture

Open the Wave Capture tab by going to Tools > Wave Capture.

Connect and Capture

Click on Connect (left button) followed by Capture (right button).

View Signals

You should now be able to view the signals you selected earlier. Hover over the signal lines to view the values in decimal or expand the view to see each individual bit.

Capture At Will

You are now able to capture the signals at any point in time during execution by clicking on the Capture button in the Wave Capture tab.

Good luck debugging!