feedc0de/esp-idf
1
0
Fork 0
forked from espressif/esp-idf
Code Pull Requests Activity

Fix issued raised in the merge request

Browse Source
This commit is contained in:
Jeroen Domburg
2016-08-30 11:30:03 +08:00
parent 16956f6474
commit 6858d2993f
2 changed files with 14 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/esp32.cfg
View File

@@ -19,7 +19,7 @@ transport select jtag
adapter_khz 200 adapter_khz 200
# With no variables set, openocd will configure JTAG for the two cores of the ESP32 and # With no variables set, openocd will configure JTAG for the two cores of the ESP32 and
# will not automatic RTOS detection. This can be be adjusted by uncommenting any of the # will do automatic RTOS detection. This can be be adjusted by uncommenting any of the
# following lines: # following lines:
# Only configure the PRO CPU # Only configure the PRO CPU
@@ -36,7 +36,7 @@ source [find target/esp32.cfg]
# The TDI pin of ESP32 is also a bootstrap pin that selects the voltage the SPI flash # The TDI pin of ESP32 is also a bootstrap pin that selects the voltage the SPI flash
# chip runs at. When a hard reset happens (e.g. because someone switches the bord off # chip runs at. When a hard reset happens (e.g. because someone switches the board off
# and on) the ESP32 will use the current TDI value as the bootstrap value because the # and on) the ESP32 will use the current TDI value as the bootstrap value because the
# JTAG adapter overrides the pull-up or pull-down resistor that is supposed to do the # JTAG adapter overrides the pull-up or pull-down resistor that is supposed to do the
# bootstrapping. These lines basically set the idle value of the TDO line to a # bootstrapping. These lines basically set the idle value of the TDO line to a

18
docs/openocd.rst
View File

@@ -28,7 +28,7 @@ devices and give a good throughput. We also tested a J-link-compatible and an Ea
somewhat slower. somewhat slower.
The minimal signalling to get a working JTAG connection are TDI, TDO, TCK, TMS and Gnd. Some JTAG debuggers also need a connection The minimal signalling to get a working JTAG connection are TDI, TDO, TCK, TMS and Gnd. Some JTAG debuggers also need a connection
from the ESP32 power line to a line called e.g. Vtar to set the working voltage. SRST can optionally be connected to the /reset of from the ESP32 power line to a line called e.g. Vtar to set the working voltage. SRST can optionally be connected to the CH_PD of
the ESP32, although for now, support in OpenOCD for that line is pretty minimal. the ESP32, although for now, support in OpenOCD for that line is pretty minimal.
Installing OpenOCD Installing OpenOCD
@@ -81,10 +81,11 @@ You should now see something like this::
Connecting a debugger to OpenOCD Connecting a debugger to OpenOCD
-------------------------------- --------------------------------
OpenOCD should now be ready to accept gdb connections. If you have compiled the ESP32 toolchain using Crosstool-NG, you OpenOCD should now be ready to accept gdb connections. If you have compiled the ESP32 toolchain using Crosstool-NG, or
should already have xtensa-esp32-elf-gdb, a version of gdb that can be used for this. First, make sure the project if you have downloaded a precompiled toolchain from the Espressif website, you should already have xtensa-esp32-elf-gdb,
you want to debug is compiled and flashed into the ESP32s SPI flash. Then, in a different console than OpenOCD is running a version of gdb that can be used for this. First, make sure the project you want to debug is compiled and flashed
in, invoke gdb. For example, for the template app, you would do this like such:: into the ESP32s SPI flash. Then, in a different console than OpenOCD is running in, invoke gdb. For example, for the
template app, you would do this like such::
cd esp-idf-template cd esp-idf-template
xtensa-esp32-elf-gdb -ex 'target remote localhost:3333' ./build/app-template.elf xtensa-esp32-elf-gdb -ex 'target remote localhost:3333' ./build/app-template.elf
@@ -121,4 +122,9 @@ The ESP-IDF code has the option of compiling in various support options for Open
is started and break the system if a panic or unhandled exception is thrown. Please see the ``make menuconfig`` menu for more is started and break the system if a panic or unhandled exception is thrown. Please see the ``make menuconfig`` menu for more
details. details.
Normally, under OpenOCD, a board can be reset by entering 'mon reset' or 'mon reset halt' into gdb. For
the ESP32, these commands work more or less, but have side effects. First of all, an OpenOCD reset only
resets the CPU cores, not the peripherals, which may lead to undefined behaviour if software assumes the
after-reset state of peripherals. Secondly, 'mon reset halt' stops before FreeRTOS is initialized.
OpenOCD assumes (in the default configuration, you can change this by editing esp32.cfg) a running
FreeRTOS and may get confused.