esp-idf/docs/zh_CN/api-guides/jtag-debugging/esp32c3.inc

169 wiersze
3.9 KiB
PHP
Czysty Zwykły widok Historia

2020-10-29 01:57:09 +00:00
.. This file gets included from other .rst files in this folder.
.. It contains target-specific snippets.
.. Comments and '---' lines act as delimiters.
..
.. This is necessary mainly because RST doesn't support substitutions
.. (defined in RST, not in Python) inside code blocks. If that is ever implemented,
.. These code blocks can be moved back to the main .rst files, with target-specific
.. file names being replaced by substitutions.
.. run-openocd
::
openocd -f board/esp32c3-builtin.cfg
2020-10-29 01:57:09 +00:00
.. |run-openocd-device-name| replace:: 通过内置 USB 连接的 ESP32-C3
2020-10-29 01:57:09 +00:00
---
.. run-openocd-output
::
user-name@computer-name:~/esp/esp-idf$ openocd -f board/esp32c3-builtin.cfg
Open On-Chip Debugger v0.10.0-esp32-20201202-26-g05a036c2 (2021-03-15-17:18)
2020-10-29 01:57:09 +00:00
Licensed under GNU GPL v2
For bug reports, read
http://openocd.org/doc/doxygen/bugs.html
Info : only one transport option; autoselect 'jtag'
Warn : Transport "jtag" was already selected
2020-10-29 01:57:09 +00:00
force hard breakpoints
Info : Listening on port 6666 for tcl connections
Info : Listening on port 4444 for telnet connections
Info : esp_usb_jtag: Device found. Base speed 40000KHz, div range 1 to 255
Info : clock speed 40000 kHz
Info : JTAG tap: esp32c3.cpu tap/device found: 0x00005c25 (mfg: 0x612 (Espressif Systems), part: 0x0005, ver: 0x0)
Info : datacount=2 progbufsize=16
Info : Examined RISC-V core; found 1 harts
Info : hart 0: XLEN=32, misa=0x40101104
Info : Listening on port 3333 for gdb connections
2020-10-29 01:57:09 +00:00
.. |run-openocd-cfg-file-err| replace:: ``Can't find board/esp32c3-builtin.cfg``
2020-10-29 01:57:09 +00:00
---
.. run-openocd-upload
::
openocd -f board/esp32c3-builtin.cfg -c "program_esp filename.bin 0x10000 verify exit"
2020-10-29 01:57:09 +00:00
---
.. run-openocd-src-linux
.. code-block:: bash
src/openocd -f board/esp32c3-builtin.cfg
2020-10-29 01:57:09 +00:00
---
.. run-openocd-src-win
.. code-block:: batch
src\openocd -f board/esp32c3-builtin.cfg
2020-10-29 01:57:09 +00:00
---
.. idf-py-openocd-default-cfg
.. |idf-py-def-cfg| replace:: ``-f board/esp32c3-builtin.cfg``
2020-10-29 01:57:09 +00:00
---
.. run-openocd-appimage-offset
::
openocd -f board/esp32c3-builtin.cfg -c "init; halt; esp appimage_offset 0x210000"
2020-10-29 01:57:09 +00:00
---
.. openocd-cfg-files
.. list-table:: ESP32-C3 相关的 OpenOCD 配置文件
2020-10-29 01:57:09 +00:00
:widths: 25 75
:header-rows: 1
* - 名称
2020-10-29 01:57:09 +00:00
- 描述
* - ``board/esp32c3-builtin.cfg``
- 通过内置 USB 连接的 ESP32-C3 系列开发板配置文件,包含 ESP32-C3 目标配置和 JTAG 适配器配置。
* - ``board/esp32c3-ftdi.cfg``
- 通过与 ESP-Prog 兼容的 FTDI ESP32-C3 调试的配置文件,包括 ESP32-C3 目标配置和 JTAG 适配器配置。
* - ``target/esp32c3.cfg``
- ESP32-C3 目标配置文件。可以和某个 ``interface/`` 下的配置文件一同使用。
* - ``interface/esp_usb_jtag.cfg``
- 适用于 ESP32-C3 JTAG 适配器配置文件。
2020-10-29 01:57:09 +00:00
* - ``interface/ftdi/esp32_devkitj_v1.cfg``
- 适用于 ESP-Prog JTAG 适配器配置文件。
2020-10-29 01:57:09 +00:00
---
.. openocd-target-specific-config-vars
---
---
.. jtag-pins
.. list-table:: ESP32-C3 管脚和 JTAG 接口信号
2020-10-29 01:57:09 +00:00
:widths: 25 75
:header-rows: 1
* - ESP32-C3 管脚
2020-10-29 01:57:09 +00:00
- JTAG 信号
* - MTDO / GPIO7
2020-10-29 01:57:09 +00:00
- TDO
* - MTDI / GPIO5
2020-10-29 01:57:09 +00:00
- TDI
* - MTCK / GPIO6
2020-10-29 01:57:09 +00:00
- TCK
* - MTMS / GPIO4
2020-10-29 01:57:09 +00:00
- TMS
.. |jtag-sel-gpio| replace:: GPIO10
.. |jtag-gpio-list| replace:: GPIO4-GPIO7
2020-10-29 01:57:09 +00:00
---
.. run-openocd-d3
::
openocd -l openocd_log.txt -d3 -f board/esp32c3-builtin.cfg
2020-10-29 01:57:09 +00:00
---
.. run-openocd-d3-tee
::
openocd -d3 -f board/esp32c3-builtin.cfg 2>&1 | tee openocd.log
2020-10-29 01:57:09 +00:00
---
.. run-gdb-remotelog
::
riscv32-esp-elf-gdb -ex "set remotelogfile gdb_log.txt" <all other options>
2020-10-29 01:57:09 +00:00
---
.. devkit-defs
.. |devkit-name| replace:: ESP32-C3
.. |devkit-name-with-link| replace:: :doc:`ESP32-C3 <../../hw-reference/index>`
2020-10-29 01:57:09 +00:00
---
.. devkit-hw-config
* 开箱即用ESP32-C3 不需要任何其他硬件配置即可进行 JTAG 调试。
2020-10-29 01:57:09 +00:00
---