docs: Update CN translation for jtag-debugging

This commit is contained in:
Zhang Shuxian
2026-05-06 12:06:35 +08:00
committed by Samuel Obuch
parent 477ada26a5
commit 45fde87d92
3 changed files with 7 additions and 7 deletions

View File

@@ -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``

View File

@@ -233,7 +233,7 @@ OpenOCD 安装完成后就可以配置 {IDF_TARGET_NAME} 目标(即带 JTAG
- ``no_clock_boost`` - 禁用在烧写前将目标时钟频率设置为其最大可能值(可选)。默认情况下禁用该选项,即默认启用时钟提升。
- ``restore_clock`` - 可选。烧写完成后将时钟频率恢复到初始值。默认情况下不启用。
- ``no_skip_loaded`` - 可选。烧写前不检查该二进制文件是否已被加载,默认情况下不启用。
- ``force`` - 可选。禁用镜像文件中检测到的芯片类型和版本范围目标兼容性检查。此检查默认启用。
- ``force`` - 可选。禁用镜像文件中检测到的芯片类型和版本范围进行目标兼容性检查。此检查默认启用。
替代方法:使用 program_esp_bins
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

View File

@@ -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,18 +229,18 @@ JTAG 管脚是否能用于其他功能
.. _jtag-debugging-security-features:
JTAG 与 flash 加密和安全引导
JTAG 与 flash 加密和安全启动
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
默认情况下,开启了 flash 加密和(或者)安全引导后,系统在首次启动时,引导程序会烧写 eFuse 的某个比特,从而将 JTAG 永久关闭。
默认情况下,开启了 flash 加密和(或者)安全启动后,系统在首次启动时,引导加载程序会烧写 eFuse 的某个比特,从而将 JTAG 永久关闭。
.. only:: SOC_HMAC_SUPPORTED
请注意,一旦 JTAG 被永久禁用,就无法重新启用以访问 JTAG。但是我们也提供了暂时禁用 (soft disable) JTAG 的选项。有关如何暂时禁用以及重新启用 JTAG请参考 :ref:`hmac_for_enabling_jtag`
Kconfig 配置项 :ref:`CONFIG_SECURE_BOOT_ALLOW_JTAG` 可以改变这个默认行为,使得用户即使开启了安全引导或者 flash 加密,仍会保留 JTAG 的功能。
Kconfig 配置项 :ref:`CONFIG_SECURE_BOOT_ALLOW_JTAG` 可以改变这个默认行为,使得用户即使开启了安全启动或者 flash 加密,仍会保留 JTAG 的功能。
然而,为了设置 :ref:`软件断点 <jtag-debugging-tip-where-breakpoints>`OpenOCD 可能会尝试自动读写 flash。设置软件断点会改变被签名程序的摘要并使签名失效。这意味着如果启用了安全引导、设置了软件断点,然后进行复位,签名验证将在启动时失败。
然而,为了设置 :ref:`软件断点 <jtag-debugging-tip-where-breakpoints>`OpenOCD 可能会尝试自动读写 flash。设置软件断点会改变被签名程序的摘要并使签名失效。这意味着如果启用了安全启动、设置了软件断点,然后进行复位,启动时的签名验证将失败。
关闭 JTAG 的软件断点功能,可以在启动 OpenOCD 时在命令行额外加一项配置参数 ``-c 'set ESP_FLASH_SIZE 0'``,请参考 :ref:`jtag-debugging-tip-openocd-config-vars`