docs: Provide CN translation for appleveltracing.rst

Author: Shen7436

docs/en/additionalfeatures/appleveltracing.rst

@@ -1,7 +1,9 @@
 Application Level Tracing
 =========================
 
-ESP-IDF provides a useful feature for program behavior analysis called `Application Level Tracing <https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/api-guides/app_trace.html?>`_. The IDF-Eclipse plugin has a UI that allows you to start and stop tracing commands and process the received data. To familiarize yourself with this library, you can use the `app_trace_to_host <https://github.com/espressif/esp-idf/tree/release/v5.0/examples/system/app_trace_to_host>`_ project or the `app_trace_basic <https://github.com/espressif/esp-idf/tree/release/v5.1/examples/system/app_trace_basic>`_ project (if using esp-idf 5.1 and higher). These projects can be created from the plugin itself:
+:link_to_translation:`zh_CN:[中文]`
+
+ESP-IDF provides a useful feature for program behavior analysis called `Application Level Tracing <https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/api-guides/app_trace.html?>`_. The IDF-Eclipse plugin provides a UI that allows you to start and stop tracing commands and process the received data. To get familiar with using this library, you can use the `app_trace_to_host <https://github.com/espressif/esp-idf/tree/release/v5.0/examples/system/app_trace_to_host>`_ project or the `app_trace_basic <https://github.com/espressif/esp-idf/tree/release/v5.1/examples/system/app_trace_basic>`_ project (if you are using ESP-IDF 5.1 or higher). You can create these projects directly from the plugin.
 
 .. image::  ../../../media/AppLvlTracing_1.png
    :alt: Application Level Tracing project creation
@@ -11,17 +13,18 @@ Before using application-level tracing, create a debug configuration for the pro
 .. image::  ../../../media/AppLvlTracing_3.png
    :alt: Debug configuration setup
 
-After creating the debug configuration, right-click on the project in the Project Explorer and select *ESP-IDF > Application Level Tracing*:
+After creating the debug configuration, right-click on the project in the Project Explorer and select ``ESP-IDF: Application Level Tracing``:
 
 .. image::  ../../../media/AppLvlTracing_2.png
    :alt: Application Level Tracing option in the context menu
 
-It may take a moment to open the application level tracing dialog, as the OpenOCD server starts first. At the top of the dialog, you will find auto-configured fields that you can adjust for the trace start command.
+It may take a moment to open the application level tracing dialog, as the OpenOCD server starts first. At the top of the dialog, you will find auto-configured fields that you can adjust if needed for the trace start command.
 
 **Start Command:**
 
 - Syntax: ``start <outfile> [poll_period [trace_size [stop_tmo [wait4halt [skip_size]]]]``
 - Arguments:
+
   - ``outfile``: Path to the file where data from both CPUs will be saved, with format ``file://path/to/file``.
   - ``poll_period``: Data polling period (in ms). If greater than 0, the command runs in non-blocking mode. Default: 1 ms.
   - ``trace_size``: Maximum data size to collect (in bytes). Tracing stops after the specified amount of data is received. Default: -1 (disabled).
@@ -34,14 +37,14 @@ Additional information can be found `here <https://docs.espressif.com/projects/e
 .. image::  ../../../media/AppLvlTracing_4.png
    :alt: Application Level Tracing dialog
 
-The next two fields, *Trace Processing Script* and *Start Parsing Command*, are used to parse the output file.
+The next two fields, ``Trace Processing Script`` and ``Start Parsing Command``, are used to parse the output file.
 
-- **Trace Processing Script**: Path to the parsing script, which by default is ``logtrace_proc.py`` from esp-idf.
-- **Start Parsing Command**: Allows you to check and edit the parsing command if necessary. By default, it is configured as: ``$IDF_PATH/tools/esp_app_trace/logtrace_proc.py/path/to/trace/file/path/to/program/elf/file``.
+- ``Trace Processing Script``: Path to the parsing script, which by default is ``logtrace_proc.py`` from ESP-IDF.
+- ``Start Parsing Command``: Allows you to check and edit the parsing command if necessary. By default, it is configured as: ``$IDF_PATH/tools/esp_app_trace/logtrace_proc.py/path/to/trace/file/path/to/program/elf/file``.
 
-The *Start parse* button is disabled until a dump file is generated. To generate it, click the *Start* button at the bottom of the dialog box. This button changes to *Stop* once tracing starts, allowing you to stop it.
+The ``Start parse`` button is disabled until a dump file is generated. To generate the dump file, click the ``Start`` button at the bottom of the dialog box. This button changes to ``Stop`` once tracing starts, allowing you to stop tracing.
 
-When the output file is available, click *Start parse* to view the parsed script output in the Eclipse console:
+When the output file is available, click ``Start parse`` to view the parsed script output in the Eclipse console.
 
 .. image::  ../../../media/AppLvlTracing_5.png
    :alt: Parsed script output in Eclipse console

docs/zh_CN/additionalfeatures/appleveltracing.rst

@@ -1 +1,50 @@
-.. include:: ../../en/additionalfeatures/appleveltracing.rst
+应用级跟踪
+==========
+
+:link_to_translation:`en:[English]`
+
+ESP-IDF 提供了用于程序行为分析的实用功能，称为 `应用级跟踪 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32c3/api-guides/app_trace.html>`_。IDF-Eclipse 插件提供了 UI 界面，可用于启动和停止跟踪命令并处理接收的数据。为了熟悉该库，你可以参考 `app_trace_to_host <https://github.com/espressif/esp-idf/tree/release/v5.0/examples/system/app_trace_to_host>`_ 示例项目，或者 `app_trace_basic <https://github.com/espressif/esp-idf/tree/release/v5.1/examples/system/app_trace_basic>`_ 示例项目（要求使用 ESP-IDF 5.1 及以上）。这些示例项目可以直接通过插件创建。
+
+.. image::  ../../../media/AppLvlTracing_1.png
+   :alt: 应用级跟踪项目创建
+
+在使用应用级跟踪之前，需要为项目创建调试配置，并选择所用的开发板，以便成功启动 OpenOCD 服务器。
+
+.. image::  ../../../media/AppLvlTracing_3.png
+   :alt: 调试配置设置
+
+创建好调试配置后，在项目管理器中右键单击项目并选择 ``ESP-IDF: Application Level Tracing``：
+
+.. image::  ../../../media/AppLvlTracing_2.png
+   :alt: 上下文菜单中的应用级跟踪选项
+
+打开应用级跟踪对话框可能需要一些时间，因为需要先启动 OpenOCD 服务器。对话框顶部有一些预配置的字段，这些字段用于启动跟踪命令，并可根据需要进行调整。
+
+**启动命令：**
+
+- 语法：``start <outfile> [poll_period [trace_size [stop_tmo [wait4halt [skip_size]]]]``
+- 参数：
+
+  - ``outfile``：保存来自两个 CPU 的数据的文件路径，格式为 ``file://path/to/file``。
+  - ``poll_period``：数据轮询周期（单位：毫秒）。如果大于 0，则以非阻塞模式运行。默认值：1 ms。
+  - ``trace_size``：可收集的最大数据量（单位：字节）。在接收到指定的数据量后停止跟踪。默认值：-1（禁用）。
+  - ``stop_tmo``：空闲超时时间（单位：秒）。在指定时间段内无数据则停止跟踪。默认值：-1（禁用）。
+  - ``wait4halt``：为 0 时立即开始跟踪，否则等待目标暂停后再开始。默认值：0。
+  - ``skip_size``：开始时要跳过的字节数。默认值：0。
+
+更多信息请参阅 `此处 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32c3/api-guides/app_trace.html>`_。
+
+.. image::  ../../../media/AppLvlTracing_4.png
+   :alt: 应用级跟踪对话框
+
+接下来的两个字段 ``Trace Processing Script`` 和 ``Start Parsing Command`` 用于解析输出文件。
+
+- ``Trace Processing Script``：解析脚本的路径，默认使用 ESP-IDF 提供的 ``logtrace_proc.py``。
+- ``Start Parsing Command``：用于在需要时检查并编辑解析命令。默认配置为：``$IDF_PATH/tools/esp_app_trace/logtrace_proc.py/path/to/trace/file/path/to/program/elf/file``。
+
+在生成转储文件之前，``Start parse`` 按钮处于禁用状态。要生成该文件，请单击对话框底部的 ``Start`` 按钮。开始跟踪后，该按钮会变为 ``Stop``，你可以用点击该按钮停止跟踪。
+
+输出文件生成后，可单击 ``Start parse``，在 Eclipse 控制台中查看解析脚本的输出。
+
+.. image::  ../../../media/AppLvlTracing_5.png
+   :alt: Eclipse 控制台中的解析脚本输出