Debugging programs

nspire_emu's native debugger

nspire_emu includes a simple command-line ARM debugger you can bring up from the Emulation > Enter debugger menu. It features ARM disassembly, instruction stepping, memory and instruction breakpoints, backtracing and memory dumping. The debugger commands available can be shown with the command '?'.

Ncubate's GDB support

GDB is the GNU Project Debugger. The Ncubate emulator implements the GDB Remote Serial Protocol for compatibility with any GDB front end such as the standard command-line interface, Insight or Eclipse CDT.

GDB allows source-level debugging, which means:

• for ARM developments, you can see you assembly symbols while debugging
• you can execute line-by-line your C programs, view the content of C variables during execution and set breakpoints from the source code

How to use it

For any debugging session, make sure to rebuild (make clean all) your whole program with the following additional nspire-gcc flags (set with the variable GCCFLAGS in Ndless sample Makefiles):

GCCFLAGS = -O0 -g (... other flags)

These flags disable optimizations that may lose GDB and ask debugging symbols to be included in the ELF file generated.

Then run Ncubate with the /G option:

nspire_emu (... usual options) /G=1000

This will make Ncubate listen for GDB commands on the TCP port 1000. Your firewall may prompt to open the port.

You can now launch your favorite GDB front end and connect it to localhost:1000.

Programs built with Ndless require Ndless v1.7 to be intalled on the OS image.

With GDB command line interface

YAGARTO GNU ARM toolchain includes the standard GDB client, run with arm-none-eabi-gdb from a command prompt. The following GDB commands can be used to connect to Ncubate:

file <your_program.elf>
target remote localhost:1000
break main

Running the file command before the target command is important for address relocation.

You can the run the program from Ncubate, which will break on the main() function, and then use s (step), n (next) and other GDB commands.

With Eclipse CDT

Eclipse CDT is the recommanded tool for GDB debugging with Ncubate. Eclipse CDT is a GUI for C and C++ development based on GNU tools.

On Windows, make sure that MSYS's bin directory is on the PATH before running Eclipse, else you won't be able to build your program.

If running a 64-bit operating system, ensure that Yagarto is not located in C:\Program Files (x86). By default, Yagarto will install here. Simply move it to C:\Yagarto and update your path by removing the old reference to Yagarto and adding C:\Yagarto\bin

Once your source code is imported into an Eclipse project and can be built within Eclipse, the visual debugger can be used to connect to Ncubate.

This video tutorial shows how to set up use the main features of Eclipse CDT's debugger with Ncubate.