Debugging - Using the Debug Interface
Preparation
- AmebaPro2 [ AMB82 MINI ] x 1
- SEGGER debug probe x 1
Example
Using the debugging feature available in the Arduino 2.0 IDE to debug your board. In this example, we will use SEGGER’s debug probe with Arduino IDE’s debug interface. Begin by installing the SEGGER debugging software. This can be found on SEGGER’s official website: https://www.segger.com/downloads/jlink/.
Before debugging, ensure that the code is optimized for debugging. Enable it by navigating to Sketch -> Optimize for Debugging.
Open the Debug example, “File” -> “Examples” -> “Debugging” -> “ExampleDebug”
Two files will open in the IDE; ExampleDebug.ino and debug_custom.json. Click on debug_custom.json. Under “serverArgs”, insert the directory path to Arduino15 folder, as well as the current version number of the tools folder.
Connect the JLink Debug Probe and AMB82 MINI board to the computer. Refer to the table below for the wiring connection between JLink Debug Probe and AMB82 MINI board. For more information, please refer to here.
| JLink Debug Probe | AMB82 MINI Board |
|---|---|
| VTref | 3.3V |
| GND | GND |
| SWDIO | SWDIO |
| SWCLK | SWCLK |
AMB82 MINI boards have 4 hardware breakpoints. Hardware breakpoints can be set at the left of the code and are indicated by a red dot shown in line 42. Setting more than 4 hardware breakpoints will cause debugging to fail. You will need to stop debugging and reset if this happens.
If 4 hardware breakpoint is not enough, software breakpoint can be used. Either of the instructions (__BKPT() or __asm__(“BKPT”)) can be used to add a software breakpoint in the program execution.
Upload the code and press the reset button on Ameba once the upload is finished.
Once uploading is completed, reset the board. Start debugging by selecting the Debug button. This is located to the right of the upload button. Arduino will proceed with opening a gdb-server tab in the same window as the output window. This can sometimes take up to 10 seconds to set up.
The line highlighted in yellow indicates which line of code the program is currently halted at. Debug console will appear to show the debugging information.
To continue running the code after the breakpoint, use any of the single-stepping functions highlighted in the red box (continue, step over, step into, step out, restart, stop).
