Skip to content

Commit ed366b5

Browse files
committed
Merge branch 'docs/translate_configure-builtin-jtag' into 'master'
docs: Provide translation for cofigure-builtin-jtag.rst in jtag-debugging Closes DOC-7523 See merge request espressif/esp-idf!29867
2 parents 57a8012 + 6d81e70 commit ed366b5

File tree

2 files changed

+45
-1
lines changed

2 files changed

+45
-1
lines changed

docs/en/api-guides/jtag-debugging/configure-builtin-jtag.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@
66
Configure {IDF_TARGET_NAME} Built-in JTAG Interface
77
===================================================
88

9+
:link_to_translation:`zh_CN:[中文]`
10+
911
{IDF_TARGET_JTAG_PIN_Dneg:default="Not Updated!", esp32c3="GPIO18", esp32c6="GPIO12", esp32s3="GPIO19", esp32h2="GPIO26"}
1012
{IDF_TARGET_JTAG_PIN_Dpos:default="Not Updated!", esp32c3="GPIO19", esp32c6="GPIO13", esp32s3="GPIO20", esp32h2="GPIO27"}
1113

Lines changed: 43 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,43 @@
1-
.. include:: ../../../en/api-guides/jtag-debugging/configure-builtin-jtag.rst
1+
.. include:: {IDF_TARGET_PATH_NAME}.inc
2+
:start-after: devkit-defs
3+
:end-before: ---
4+
5+
6+
配置 {IDF_TARGET_NAME} 内置 JTAG 接口
7+
=====================================
8+
9+
:link_to_translation:`en:[English]`
10+
11+
{IDF_TARGET_JTAG_PIN_Dneg:default="未更新!", esp32c3="GPIO18", esp32c6="GPIO12", esp32s3="GPIO19", esp32h2="GPIO26"}
12+
{IDF_TARGET_JTAG_PIN_Dpos:default="未更新!", esp32c3="GPIO19", esp32c6="GPIO13", esp32s3="GPIO20", esp32h2="GPIO27"}
13+
14+
{IDF_TARGET_NAME} 配备了内置的 JTAG 电路,无需额外芯片,即可进行调试。只需将 USB 电缆连接到 D+/D- 管脚即可。必要的连接如下所示。
15+
16+
配置硬件
17+
^^^^^^^^
18+
19+
.. list-table:: {IDF_TARGET_NAME} 管脚及 USB 信号
20+
:widths: 25 75
21+
:header-rows: 1
22+
23+
* - {IDF_TARGET_NAME} 管脚
24+
- USB 信号
25+
* - {IDF_TARGET_JTAG_PIN_Dneg}
26+
- D-
27+
* - {IDF_TARGET_JTAG_PIN_Dpos}
28+
- D+
29+
* - 5V
30+
- V_BUS
31+
* - GND
32+
- 接地
33+
34+
请不要将用于 USB 通信的 {IDF_TARGET_NAME} 管脚连接到可能会干扰 JTAG 操作的其他硬件上。
35+
36+
配置 USB 驱动程序
37+
^^^^^^^^^^^^^^^^^
38+
39+
JTAG 通信在所有支持的平台上都可工作。Windows 用户可能会遇到 `LIBUSB_ERROR_NOT_FOUND` 错误。请使用 2.8 版本(或更新版本)的 :ref:`get-started-windows-tools-installer`,并选择驱动程序“Espressif - WinUSB 支持 JTAG (ESP32-C3/S3)”以解决此问题。如果您不想重新运行安装程序,则可以通过 `idf-env <https://github.com/espressif/idf-env>`_ 实现相同的效果。请在 PowerShell 运行以下命令::
40+
41+
Invoke-WebRequest 'https://dl.espressif.com/dl/idf-env/idf-env.exe' -OutFile .\idf-env.exe; .\idf-env.exe driver install --espressif
42+
43+
在 Linux 上,需要添加 OpenOCD udev 规则。方法是将以下 `udev 规则文件 <https://github.com/espressif/openocd-esp32/blob/master/contrib/60-openocd.rules>`_ 放置在 ``/etc/udev/rules.d`` 文件夹中。

0 commit comments

Comments
 (0)