How to debug Tasmota on ESP32 device?

[jluthiger]

I’m working with an ESP32-S3-DevKitC-1N8R8 and a JTAG/serial adapter, using Visual Studio Code with the PlatformIO extension (link). Build, Upload, and Monitor all work fine.

However, I’m unable to debug Tasmota on this setup.

As a reference, I was able to successfully debug a basic Hello World app on the same device using esptool, so the hardware and debug connection seem to be functional.

I’ve gone through the Tasmota documentation, but couldn’t find anything related to JTAG or debugging support.

Am I missing something? Has anyone successfully debugged Tasmota via JTAG or with PlatformIO? Any hints or suggestions would be greatly appreciated!

[s-hadinger]

Jason added support for JTAG debugging a long time ago. But as far as I know, none of the core developers use JTAG.

Alas I'm debugging the old way: logs

[arendst]

On Tasmota init we do a lot of trickery to get serial console functional:

#ifdef ESP32
/*
#if CONFIG_IDF_TARGET_ESP32C3 ||            // support USB via HWCDC using JTAG interface
    CONFIG_IDF_TARGET_ESP32C6 ||            // support USB via HWCDC using JTAG interface
    CONFIG_IDF_TARGET_ESP32S2 ||            // support USB via USBCDC
    CONFIG_IDF_TARGET_ESP32S3               // support USB via HWCDC using JTAG interface or USBCDC
*/
#if CONFIG_IDF_TARGET_ESP32C3 || CONFIG_IDF_TARGET_ESP32C6 || CONFIG_IDF_TARGET_ESP32S2 || CONFIG_IDF_TARGET_ESP32S3

//#if CONFIG_TINYUSB_CDC_ENABLED              // This define is not recognized here so use USE_USB_CDC_CONSOLE
#ifdef USE_USB_CDC_CONSOLE
//#warning **** TasConsole use USB ****
bool tasconsole_serial = false;

#if ARDUINO_USB_MODE
//#warning **** TasConsole ARDUINO_USB_MODE ****
#if !ARDUINO_USB_CDC_ON_BOOT
HWCDC HWCDCSerial;
#endif  // ARDUINO_USB_CDC_ON_BOOT
TASCONSOLE TasConsole{HWCDCSerial};         // ESP32C3/C6/S3 embedded USB using JTAG interface
//#warning **** TasConsole uses HWCDC ****
#else   // No ARDUINO_USB_MODE
#include "USB.h"
#include "USBCDC.h"
#if !ARDUINO_USB_CDC_ON_BOOT
USBCDC USBSerial;                           // Already defined in USBCDC.cpp
#endif  // ARDUINO_USB_CDC_ON_BOOT
TASCONSOLE TasConsole{USBSerial};           // ESP32Sx embedded USB interface
//#warning **** TasConsole uses USBCDC ****
#endif  // ARDUINO_USB_MODE

#else   // No USE_USB_CDC_CONSOLE
TASCONSOLE TasConsole{Serial};
bool tasconsole_serial = true;
//#warning **** TasConsole uses Serial ****
#endif  // USE_USB_CDC_CONSOLE
#else   // No ESP32C3, S2 or S3
TASCONSOLE TasConsole{Serial};
bool tasconsole_serial = true;
//#warning **** TasConsole uses Serial ****
#endif  // ESP32C3, S2 or S3

#else   // No ESP32
HardwareSerial TasConsole = Serial;         // Only serial interface
#endif  // ESP32

This may well interfere with plain JTAG use on some S3...

BTW me also never used JTAG on ESP32. Did it once on msp432 and I liked it very much. Never missed it though on ESP8266/ESP32