From 49a0ff616007ea17a473c84f51f8a916165c3ced Mon Sep 17 00:00:00 2001 From: Zhang Shuxian Date: Wed, 6 May 2026 12:06:35 +0800 Subject: [PATCH] docs: Update CN translation for jtag-debugging --- docs/en/api-guides/jtag-debugging/tips-and-quirks.rst | 2 +- docs/zh_CN/api-guides/jtag-debugging/index.rst | 2 +- .../api-guides/jtag-debugging/tips-and-quirks.rst | 10 +++++----- 3 files changed, 7 insertions(+), 7 deletions(-) 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 814c44b50ea..2545654752e 100644 --- a/docs/en/api-guides/jtag-debugging/tips-and-quirks.rst +++ b/docs/en/api-guides/jtag-debugging/tips-and-quirks.rst @@ -175,7 +175,7 @@ It is important to set the variable before including the ESP-specific configurat * - ``ESP_RTOS`` - Set to ``none`` to disable RTOS support. In this case, thread list will not be available in GDB. Can be useful when debugging FreeRTOS itself, and stepping through the scheduler code. * - ``ESP_FLASH_SIZE`` - - Set to ``0`` to disable Flash breakpoints support. If set to ``0``, target will not be reset when GDB connects. + - Set to ``0`` to disable flash breakpoints support. If set to ``0``, target will not be reset when GDB connects. * - ``ESP_SEMIHOST_BASEDIR`` - Set to the path (on the host) which will be the default directory for semihosting functions. * - ``ESP_ONLYCPU`` diff --git a/docs/zh_CN/api-guides/jtag-debugging/index.rst b/docs/zh_CN/api-guides/jtag-debugging/index.rst index 6d22082f560..be2cff576d8 100644 --- a/docs/zh_CN/api-guides/jtag-debugging/index.rst +++ b/docs/zh_CN/api-guides/jtag-debugging/index.rst @@ -233,7 +233,7 @@ OpenOCD 安装完成后就可以配置 {IDF_TARGET_NAME} 目标（即带 JTAG - ``no_clock_boost`` - 禁用在烧写前将目标时钟频率设置为其最大可能值（可选）。默认情况下禁用该选项，即默认启用时钟提升。 - ``restore_clock`` - 可选。烧写完成后将时钟频率恢复到初始值。默认情况下不启用。 - ``no_skip_loaded`` - 可选。烧写前不检查该二进制文件是否已被加载，默认情况下不启用。 -- ``force`` - 可选。禁用从镜像文件中检测到的芯片类型和版本范围的目标兼容性检查。此检查默认启用。 +- ``force`` - 可选。禁用对镜像文件中检测到的芯片类型和版本范围进行目标兼容性检查。此检查默认启用。 替代方法：使用 program_esp_bins ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/docs/zh_CN/api-guides/jtag-debugging/tips-and-quirks.rst b/docs/zh_CN/api-guides/jtag-debugging/tips-and-quirks.rst index 8a0460df273..feccea49647 100644 --- a/docs/zh_CN/api-guides/jtag-debugging/tips-and-quirks.rst +++ b/docs/zh_CN/api-guides/jtag-debugging/tips-and-quirks.rst @@ -175,7 +175,7 @@ TCL 语言中为变量赋值的语法是: * - ``ESP_RTOS`` - 设置成 ``none`` 可以关闭 OpenOCD 对 RTOS 的支持，这样的话，你将无法在 GDB 中查看到线程列表。这个功能在调试 FreeRTOS 本身的时候会很有用，可以单步调试调度器的代码。 * - ``ESP_FLASH_SIZE`` - - 设置成 ``0`` 可以关闭对 flash 断点的支持。如果设置为 ``0``，GDB 连接时不会复位目标。 + - 设置成 ``0`` 可以关闭对 flash 断点的支持。如果设置为 ``0``，GDB 连接时不会复位目标芯片。 * - ``ESP_SEMIHOST_BASEDIR`` - 设置 semihosting 在主机端的默认目录。 * - ``ESP_ONLYCPU`` @@ -229,14 +229,14 @@ JTAG 管脚是否能用于其他功能 .. _jtag-debugging-security-features: -JTAG 与 flash 加密和安全引导 +JTAG 与 flash 加密和安全启动 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -默认情况下，开启了 flash 加密和（或者）安全引导后，系统在首次启动时，引导程序会烧写 eFuse 的某个比特，从而将 JTAG 永久关闭。 +默认情况下，开启了 flash 加密和（或者）安全启动后，系统在首次启动时，引导加载程序会烧写 eFuse 的某个比特，从而将 JTAG 永久关闭。 -Kconfig 配置项 :ref:`CONFIG_SECURE_BOOT_ALLOW_JTAG` 可以改变这个默认行为，使得用户即使开启了安全引导或者 flash 加密，仍会保留 JTAG 的功能。 +Kconfig 配置项 :ref:`CONFIG_SECURE_BOOT_ALLOW_JTAG` 可以改变这个默认行为，使得用户即使开启了安全启动或者 flash 加密，仍会保留 JTAG 的功能。 -然而，为了设置 :ref:`软件断点 `，OpenOCD 可能会尝试自动读写 flash。设置软件断点会改变被签名程序的摘要并使签名失效。这意味着如果启用了安全引导、设置了软件断点，然后进行复位，签名验证将在启动时失败。 +然而，为了设置 :ref:`软件断点 `，OpenOCD 可能会尝试自动读写 flash。设置软件断点会改变被签名程序的摘要并使签名失效。这意味着如果启用了安全启动、设置了软件断点，然后进行复位，启动时的签名验证将会失败。 关闭 JTAG 的软件断点功能，可以在启动 OpenOCD 时在命令行额外加一项配置参数 ``-c 'set ESP_FLASH_SIZE 0'``，请参考 :ref:`jtag-debugging-tip-openocd-config-vars`。