Improve debuging section

[SergioGasquez]

Tasks

Beta Give feedback

1. Document how to install GDB/openOCD, see gdb missing since esp-12.2.0_20230208 espup#257 (comment)
2. Improve current sections
3. The "Debugging in Visual Studio Code" section should be updated to reflect all supported chips
4. note that esp8266 is not supported via openocd-esp32
5. Explain the differences between openOCD, VsCode and probe-rs

[SergioGasquez]

Closed via #128

[lure23]

I'm still confused about how to install OpenOCD - in my case for ESP32-C3 development.

The #128 changelog suggests installing https://github.com/espressif/binutils-gdb

GDB with all the Espressif products supported can be obtained in [`espressif/binutils-gdb`][binutils-repo].
Once installed, it's as simple as running `openocd` with the correct arguments. For chips with the built-in  [`USB-JTAG-SERIAL` peripheral][usb-jtag-serial], there is normally a config file that will work out of the box, for example on the ESP32-C3:

The releases of binutils-gdb don't provide an openocd binary. What are the packages I should install - and how - to get suggested command openocd -f board/esp32c3-builtin.cfg runnable (on Linux)?

I presume this part was left somewhat undone. The first checkbox of this issue (closed as duplicate) remains unchecked.

cc @SergioGasquez

[SergioGasquez]

I'm still confused about how to install OpenOCD - in my case for ESP32-C3 development.

OpenOCD comes with the ESP-IDF installation: https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html#installation. From the docs:

If you have already set up ESP-IDF with CMake build system according to the Getting Started Guide, then OpenOCD is already installed. After setting up the environment in your terminal, you should be able to run OpenOCD. Check this by executing the following command:

[lure23]

Thanks, got it.