Name
JTAG support — Usage
Use of JTAG for debugging
JTAG can be used to single-step and debug loaded applications, or even applications resident in ROM, including the Stubrom.
Debugging of ROM applications is only possible if using hardware breakpoints. The Cortex-M3 core of the STM32 only supports two such hardware breakpoints, so they should be used sparingly. If using a GDB front-end such as Eclipse, check it has not set unnecessary extra breakpoints. Some JTAG devices give the option of whether to set hardware or software breakpoints by default. Be sure to configure your device appropriately.
When debugging via JTAG, you are likely to need to disable the default HAL idle thread action, otherwise there may be issues where the target fails to halt and the debugging session is unreliable. More details can be found in the Cortex-M architectural HAL.
Ronetix PEEDI notes
On the Ronetix PEEDI, the peedi.stm32.cfg
file should be used to setup and configure the hardware to an
appropriate state to load programs. This includes setting up the
clocks, GPIO lines, SRAM and flash memory controller.
The peedi.stm32c.cfg
file also contains an
option to define whether hardware or software breakpoints are
used by default, using the CORE0_BREAKMODE
directive in the [TARGET]
section. The
supplied version of the file defaults to software breakpoints.
With this default, hardware breakpoints can still be set from GDB
using the hbreak command. The default can be
changed to hardware breakpoints, and remember to use the
reboot command on the PEEDI command line
interface, or press the reset button to make the changes take
effect.
On the PEEDI, debugging can be performed either via the telnet interface or using arm-eabi-gdb. In the case of the latter, arm-eabi-gdb needs to connect to TCP port 2000 on the PEEDI's IP address. For example:
(gdb) target remote 111.222.333.444:2000
By default when the PEEDI is powered up, the target will always
run the initialization section of the
peedi.stm32c.cfg
file, and halts the target.
This behaviour is repeated with the reset
command.
If the board is reset with the 'reset' command, or by pressing the reset button and the 'go' command is then given, then the board will boot from ROM as normal. A similar effect can be achieved in GDB by connecting with target remote and immediately typing continue or c.
It is also possible for the target to always run, without
initialization, after the reset button has been pressed. This
mode can be selected in two ways. Either with
the CORE0_STARTUP_MODE
directive in
the [TARGET]
section of
the peedi.stm32c.cfg
file. Or by using
the reset run command. Either approach
conveniently allows the target to be connected to the JTAG
debugger, and be able to reset it with the reset button, without
being required to always type 'go' every
time. Although using reset run will not be
persistent across reboots of the PEEDI itself.
Suitably configured RAM applications can be loaded either via GDB, or directly via the telnet CLI. For example:
stm3210c> memory load tftp://192.168.7.9/test.bin bin 0x02000000
++ info: Loading image file: tftp://192.168.7.9/test.bin
++ info: At absolute address: 0x20000400
loading at 0x20000400
Successfully loaded 23KB (24560 bytes) in 0.1s
stm3210c> go
Consult the PEEDI documentation for information on other formats and loading mechanisms.
Abatron BDI3000 notes
On the Abatron BDI3000, the bdi3000.stm32.cfg
file should be used to setup and configure the hardware to an
appropriate state to load programs. This includes setting up the
clocks, GPIO lines, SRAM and flash memory controller.
The bdi3000.stm32.cfg
file also contains an
option to define whether hardware or software breakpoints are
used by default, using the BREAKMODE
directive in the [TARGET]
section. The
supplied version of the file defaults to software breakpoints.
With this default, hardware breakpoints can still be set from GDB
using the hbreak command. The default can be
changed to hardware breakpoints, and remember to use the
boot command on the BDI3000 command line
interface.
On the BDI3000, debugging can be performed either via the telnet interface or using arm-eabi-gdb. In the case of the latter, arm-eabi-gdb needs to connect to TCP port 2001 on the BDI3000's IP address. For example:
(gdb) target remote 111.222.333.444:2001
By default when the BDI3000 is powered up, the target will always
run the initialization section of the
bdi3000.stm32.cfg
file, and halts the target.
This behaviour is repeated with the reset
command.
If the board is reset with the 'reset' command, or by pressing the reset button and the 'go' command is then given, then the board will boot from ROM as normal. A similar effect can be achieved in GDB by connecting with target remote and immediately typing continue or c.
It is also possible for the target to always run, without initialization, after the reset button has been pressed. This mode is selected with the reset run command. This conveniently allows the target to be connected to the JTAG debugger, and be able to reset it with the reset button, without being required to always type 'go' every time. Thereafter, invoking the reset command will repeat the previous reset style. Also in this mode, exceptions will be handled by board software, rather than causing the JTAG debugger to halt the CPU.
Suitably configured RAM applications can be loaded either via GDB, or directly via the telnet CLI. For example:
STM3210C> load 0x20000400 test.bin bin
Loading /test.bin , please wait ....
Loading program file passed
STM3210C> go 0x20000400
Consult the BDI3000 documentation for information on other formats and loading mechanisms.
Configuration of JTAG applications
JTAG applications can be loaded directly into RAM without requiring a ROM monitor. This loading can be done directly through the JTAG device, or where supported by the JTAG device, through GDB.
In order to configure the application to support this mode, some configuration settings are required, and a memory layout selected which will take advantage of the extra RAM space available. All necessary settings are made automatically if the JTAG startup type is selected.
2024-12-10 | eCosPro Non-Commercial Public License |