Skip to content

Commit

Permalink
improved debugging instructions for ESP32
Browse files Browse the repository at this point in the history
  • Loading branch information
ricardoquesada committed Jan 3, 2025
1 parent 3f8503f commit b4a27be
Showing 1 changed file with 18 additions and 3 deletions.
21 changes: 18 additions & 3 deletions examples/esp32/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ Supports the different ESP32 chips:

## Debugging

In case you need to debug an ESP32-S3 (or ESP32-C3) using JTAG, follow these steps: (or
In case you need to debug an ESP32-S3 (or ESP32-C3 / C6) using JTAG, follow these steps: (or
read [ESP32 JTAG Debugging][esp32-gdb]).

*Note: If you have a standard ESP32, you can do it with an [ESP-PROG][esp-prog] module.*
Expand All @@ -55,6 +55,12 @@ TL;DR: Open 3 terminals, and do:

### Terminal 1

```shell
idf.py openocd
```

Or if you prefer the verbose way (but not both):

```shell
# Open OpenOCD
# Valid for ESP32-S3. Change it to "esp32c3-builtin.cfg" for ESP32-C3
Expand All @@ -63,11 +69,20 @@ sudo openocd -f board/esp32s3-builtin.cfg -c "adapter speed 5000"

### Terminal 2

```shell
idf.py gdb
```

Or if you prefer the verbose way (but not both):

```shell
xtensa-esp32s3-elf-gdb bluepad32_esp32_example_app.elf
> target remote :3333
> monitor reset init
> continue
> set remote hardware-watchpoint-limit 2
> mon reset halt
> maintenance flush register-cache
> thb app_main
> c
```

### Terminal 3
Expand Down

0 comments on commit b4a27be

Please sign in to comment.