JTAG programming ESP32-C3 devKit M (OCD-384)

[Wasabinary]

Hi,

After successfully flashing my code using a JLINK and JTAG pins( TDO, TDI, TCK and TMS) of an ESP32-S2-SAOLA-1 board, I tried to do the same with an ESP32-C3-DevKitM-1, following the instruction given here

Unfortunately, I am not able to use JTAG with this ESP32-C3 board, even after downloading the newest version of openocd-esp32 and checking my connections multiple times.

I keep receiving an error when launching the command

C:/path/to/openocd.exe -f C:/path/to/interface/jlink.cfg -f C:/path/to/target/esp32c3.cfg -c "program_esp test.bin 0x10000 verify exit"

Error: JTAG scan chain interrogation failed: all zeroes
Error: Check JTAG interface, timings, target power, etc.
Error: Trying to use configured scan chain anyway...
Error: esp32c3.cpu: IR capture error; saw 0x00 not 0x01
Warn : Bypassing JTAG setup events due to errors

I tried changing the adapter frequency in the jlink.cfg file, but it does not change anything.

Any idea?

[igrr]

Could you please run espefuse.py summary to check eFuse settings and the chip revision? ESP32-C3 starting from revision 3 defaults to JTAG over the built-in USB-SERIAL-JTAG adapter. If you'd like to use it with J-Link, an eFuse should be burned. Sorry that this is not mentioned in the linked document.

[Wasabinary]

Thanks for your help! I tried running espefuse summary, which outputs a lot of information I don't really understand...

I get the following Config:

Config fuses:
DIS_RTC_RAM_BOOT (BLOCK0) Disables boot from RTC RAM = False R/W (0b0)
DIS_ICACHE (BLOCK0) Disables ICache = False R/W (0b0)
DIS_DOWNLOAD_ICACHE (BLOCK0) Disables Icache when SoC is in Download mode = False R/W (0b0)
DIS_FORCE_DOWNLOAD (BLOCK0) Disables forcing chip into Download mode = False R/W (0b0)
DIS_CAN (BLOCK0) Disables the TWAI Controller hardware = False R/W (0b0)
VDD_SPI_AS_GPIO (BLOCK0) Set this bit to vdd spi pin function as gpio = False R/W (0b0)
BTLC_GPIO_ENABLE (BLOCK0) Enable btlc gpio = 0 R/W (0b00)
POWERGLITCH_EN (BLOCK0) Set this bit to enable power glitch function = False R/W (0b0)
POWER_GLITCH_DSENSE (BLOCK0) Sample delay configuration of power glitch = 0 R/W (0b00)
DIS_LEGACY_SPI_BOOT (BLOCK0) Disables Legacy SPI boot mode = False R/W (0b0)
UART_PRINT_CHANNEL (BLOCK0) Selects the default UART for printing boot msg = UART0 R/W (0b0)
UART_PRINT_CONTROL (BLOCK0) Sets the default UART boot message output mode = Enabled R/W (0b00)
FORCE_SEND_RESUME (BLOCK0) Force ROM code to send a resume command during SPI = False R/W (0b0)
...
Efuse fuses:
WR_DIS (BLOCK0) Disables programming of individual eFuses = 0 R/W (0x00000000)
RD_DIS (BLOCK0) Disables software reading from BLOCK4-10 = 0 R/W (0b0000000)

I also have a part of the output which says something about JTAG:

Jtag Config fuses:
JTAG_SEL_ENABLE (BLOCK0) = False R/W (0b0)
Set this bit to enable selection between usb_to_jtag and pad_to_jtag through strapping gpio10 when both reg_dis_usb_jtag and reg_dis_pad_jtag are equal to 0.
SOFT_DIS_JTAG (BLOCK0) = 0 R/W (0b00)
Software disables JTAG. When software disabled, JTAG can be activated temporarily by HMAC peripheral
DIS_PAD_JTAG (BLOCK0) = False R/W (0b0)
Permanently disable JTAG access via pads. USB JTAG is controlled separately.

What's the part I need to check ?

[Wasabinary]

BTW, i checked the chip revision using:

esptool read_mac

And i got the following output

Detecting chip type... ESP32-C3
Chip is unknown ESP32-C3 (revision 3)

Isn't it strange that it says the chip is unknown ?

[igrr]

Chip is unknown ESP32-C3 (revision 3)
Isn't it strange that it says the chip is unknown ?

This should be solved by espressif/esptool@dbbf83f, but ESP-IDF still uses a slightly older version of esptool, so the fix hasn't propagated there yet.

ESP32-C3, starting from revision 3, supports a built-in USB to SERIAL/JTAG adapter. It should be useable both for console (flash/monitor) and OpenOCD out of the box, provided you connect a USB cable to specific pins, described here. On Windows, there is an extra step to install the driver to make JTAG work.

If you want to use JTAG via GPIOs using an external adapter such as J-link, there are two options.

One option is to burn DIS_USB_JTAG efuse. This is a one-time (irreversible) operation, afterwards JTAG will only be accessible over GPIOs. Built-in USB to Serial part of USB_SERIAL_JTAG peripheral will still work.

The other option is to burn JTAG_SEL_ENABLE efuse. This is also an irreversible operation. When this efuse is burned, JTAG connection will be determined by the state of GPIO10 pin on power-on reset. If GPIO10 is low on reset, USB_SERIAL_JTAG will be used. With it is high on reset, JTAG via GPIOs will be used.

[Wasabinary]

Thank you @igrr for these very clear explanations! I am now able to connect to my esp32c3 board using my JLINK.

I tried running

C:/path/to/openocd.exe -f C:/path/to/interface/jlink.cfg -f C:/path/to/target/esp32c3.cfg -c "program_esp test.bin 0x10000 verify exit"

but I have now another issue:

.espressif/tools/openocd-esp32/v0.10.0-esp32-20210401/openocd-esp32/share/openocd/scripts/target/esp_common.cfg: 100: Error: invalid command name "esp"

Something is probably wrong with my config, I'm trying to figure this out. I'll let you know when I'm able to flash my ESP32-C3-DevKitM-1 using JTAG

[igrr]

I'm sorry i missed the fact you are trying to flash an ESP32-C3 over JTAG, not debug it! This feature was implemented in OpenOCD recently (e950ede) but is not part of a release yet. We'll make a new release soon; in the meantime you can use these binaries provided by @gerekon in another issue: #162 (comment).

[Wasabinary]

Oh that's why! I will wait for the new release then. Thank you for your help!

Closing the issue now

[Wasabinary]

Now that openocd-esp32 supports JTAG programming on ESP32-C3, I successfully flashed my ESP32-C3-DevKitM-1 after burning the JTAG_SEL_ENABLE efuse.

The thing is, I also wanted to flash ESP32-C3 modules placed on custom PCBs. However, I cannot use USB to burn the JTAG_SEL_ENABLE efuse of these modules, therefore I cannot use my ESP32-C3...

@igrr what's the best way to proceed to successfully use JTAG to flash my modules without using USB ?

[gerekon]

@Wasabinary I think you do not need USB to program efuses. It is done over UART0 (@igrr @Spritetm please correct me). So you need to have TXD/RXD connected to your PC in some way (e.g. via external USB-UART bridge). Having that you can program, efuses to use ESP32-C3 JTAG pads to connect external JTAG adapter. So you need TXD, RXD and JTAG pins to be accessible on your custom PCB for external connection.

[gerekon]

To clear it a bit...
When you use esptool.py efuses are read/programmed by the stub or ROM code. Communication with stub/ROM is done over UART0.

[Spritetm]

Almost correct. It's done using either ROM or USB serial/JTAG; the ROM and stub understand both. But yeah, you need to zap the efuse either way before JTAG-over-GPIOs work.

[Wasabinary]

@gerekon @Spritetm, thank you for your help ! As far as I understand, I could use an FTDI cable connected to TXD/RXD pins in order to burn the efuse ?