debug-arm7

glasgow run debug-arm7

Debug ARM7TDMI processors via the JTAG interface.

This applet supports displaying CPU state, dumping a memory region, and running a GDB remote protocol server for a debugger. All debugger features are implemented except for memory watchpoints. (This processor has errata that makes watchpoints essentially unusable, as well as impacting breakpoints.)

The applet should work on all big-endian and little-endian ARM7TDMI CPUs, and has been tested on a big-endian SoC (Yamaha SWLL).

The CPU must be the only TAP in the JTAG chain.

usage: glasgow run debug-arm7 [-h] [-V SPEC] [--tck PIN] [--tms PIN]
                              [--tdo PIN] [--tdi PIN] [--trst PIN] [-e ENDIAN]
                              [-f FREQ]
                              OPERATION ...
-h, --help

show this help message and exit

-V <spec>, --voltage <spec>

configure I/O port voltage to SPEC (e.g.: ‘3.3’, ‘A=5.0,B=3.3’, ‘A=SA’)

--tck <pin>

bind the applet I/O line ‘tck’ to PIN (default: A0)

--tms <pin>

bind the applet I/O line ‘tms’ to PIN (default: A1)

--tdo <pin>

bind the applet I/O line ‘tdo’ to PIN (default: A2)

--tdi <pin>

bind the applet I/O line ‘tdi’ to PIN (default: A3)

--trst <pin>

bind the applet I/O line ‘trst’ to PIN

-e {big,little}, --endian {big,little}

target endianness (default: little)

-f <freq>, --frequency <freq>

set TCK frequency to FREQ kHz (default: 1000)

glasgow run debug-arm7 dump-memory

usage: glasgow run debug-arm7 dump-memory [-h] [-f FILENAME] ADDRESS LENGTH
address

start at ADDRESS

length

dump LENGTH bytes

-h, --help

show this help message and exit

-f <filename>, --file <filename>

dump contents to FILENAME

glasgow run debug-arm7 dump-state

usage: glasgow run debug-arm7 dump-state [-h]
-h, --help

show this help message and exit

glasgow run debug-arm7 gdb

usage: glasgow run debug-arm7 gdb [-h] [GDB-ENDPOINT]
gdb-endpoint

listen at GDB-ENDPOINT, either unix:PATH or tcp:HOST:PORT (default: tcp::1234)

-h, --help

show this help message and exit