From 1d06b6b07ee721504da79a0d3d63aa4bf719bc7c Mon Sep 17 00:00:00 2001 From: Kirill Chalov Date: Wed, 20 Nov 2019 15:01:56 +0800 Subject: [PATCH] Add information on compatibility issue between JTAG and AT firmware. --- docs/en/api-guides/jtag-debugging/index.rst | 1 + docs/en/api-guides/jtag-debugging/tips-and-quirks.rst | 10 ++++++++++ 2 files changed, 11 insertions(+) diff --git a/docs/en/api-guides/jtag-debugging/index.rst b/docs/en/api-guides/jtag-debugging/index.rst index c27d89015..902f0cca8 100644 --- a/docs/en/api-guides/jtag-debugging/index.rst +++ b/docs/en/api-guides/jtag-debugging/index.rst @@ -287,6 +287,7 @@ This section provides collection of links to all tips and quirks referred to fro * :ref:`jtag-debugging-tip-openocd-configure-target` * :ref:`jtag-debugging-tip-reset-by-debugger` * :ref:`jtag-debugging-tip-jtag-pins-reconfigured` +* :ref:`jtag-debugging-tip-at-firmware-issue` * :ref:`jtag-debugging-tip-reporting-issues` diff --git a/docs/en/api-guides/jtag-debugging/tips-and-quirks.rst b/docs/en/api-guides/jtag-debugging/tips-and-quirks.rst index 7fb45e5da..cc09e25eb 100644 --- a/docs/en/api-guides/jtag-debugging/tips-and-quirks.rst +++ b/docs/en/api-guides/jtag-debugging/tips-and-quirks.rst @@ -235,6 +235,16 @@ Below is an excerpt from series of errors reported by GDB after the application cpu1: xtensa_resume (line 431): DSR (FFFFFFFF) indicates DIR instruction generated an overrun! +.. _jtag-debugging-tip-at-firmware-issue: + +JTAG and ESP32-WROOM-32 AT firmware Compatibility Issue +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The ESP32-WROOM series of modules come pre-flashed with AT firmware. This firmware configures the pins GPIO12 to GPIO15 as SPI slave interface, which makes using JTAG impossible. + +To make JTAG available, build new firmware that is not using pins GPIO12 to GPIO15 dedicated to JTAG communication. After that, flash the firmware onto your module. See also :ref:`jtag-debugging-tip-jtag-pins-reconfigured`. + + .. _jtag-debugging-tip-reporting-issues: Reporting issues with OpenOCD / GDB