docs: Update CN translation

This commit is contained in:
renpeiying
2025-07-28 14:49:28 +08:00
committed by Erhan Kurubas
parent a877a070cb
commit d1df341c5d
4 changed files with 36 additions and 6 deletions

View File

@@ -36,7 +36,7 @@ The :ref:`CONFIG_ESP_COREDUMP_MAX_TASKS_NUM` option configures the number of tas
Data Integrity Check Data Integrity Check
^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^
Core dump files include a SHA256 checksum, which can be used to verify the integrity of the core dump file and ensure it has not been corrupted. The SHA256 hash algorithm provides a high probability of detecting corruption, including multiple-bit errors. Core dump files include a SHA256 checksum that verifies the integrity of the file and ensure it has not been corrupted. The SHA256 hash algorithm provides a high probability of detecting corruption, including multiple-bit errors.
Reserved Stack Size Reserved Stack Size
^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^

View File

@@ -57,6 +57,7 @@ The deprecated ``soc_memory_types.h`` header file has been removed. Please inclu
App Trace App Trace
---------- ----------
Removed extra data buffering option. `CONFIG_APPTRACE_PENDING_DATA_SIZE_MAX` is no longer supported. Removed extra data buffering option. `CONFIG_APPTRACE_PENDING_DATA_SIZE_MAX` is no longer supported.
Removed deprecated `ESP_APPTRACE_DEST_TRAX` enum value. Use `ESP_APPTRACE_DEST_JTAG` instead. Removed deprecated `ESP_APPTRACE_DEST_TRAX` enum value. Use `ESP_APPTRACE_DEST_JTAG` instead.
@@ -97,7 +98,7 @@ The function :cpp:func:`pxTaskGetStackStart` has been deprecated. Use :cpp:func:
Core Dump Core Dump
--------- ---------
Binary data format has been dropped. `CONFIG_ESP_COREDUMP_DATA_FORMAT_BIN` is no longer supported. Elf is now the default data format. Binary data format has been dropped. `CONFIG_ESP_COREDUMP_DATA_FORMAT_BIN` is no longer supported. ELF is now the default data format.
CRC data integrity check has been dropped. `ESP_COREDUMP_CHECKSUM_CRC32` is no longer supported. SHA256 is now the default checksum algorithm. CRC data integrity check has been dropped. `ESP_COREDUMP_CHECKSUM_CRC32` is no longer supported. SHA256 is now the default checksum algorithm.

View File

@@ -29,14 +29,14 @@
格式和大小 格式和大小
^^^^^^^^^^^^^ ^^^^^^^^^^^^^
核心转储文件以 ELF 格式生成,该格式具扩展性,支持在发生崩溃时保存关于错误任务和崩溃软件的全面信息。ELF 格式足够灵活,可以在未来的修订版本中进行扩展,保存更多信息。 核心转储文件以 ELF 格式生成,该格式具有可扩展性,能够在系统崩溃时完整保存错误任务和故障软件的详细信息。ELF 格式具备良好的扩展灵活性,便于未来版本升级时存储更多诊断信息。
选项 :ref:`CONFIG_ESP_COREDUMP_MAX_TASKS_NUM` 配置核心转储保存的任务快照数量。 选项 :ref:`CONFIG_ESP_COREDUMP_MAX_TASKS_NUM` 可用于配置核心转储保存的任务快照数量。
数据完整性检查 数据完整性检查
^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^
核心转储文件包含 SHA256 校验和,用于验证核心转储文件的完整性确保文件未被损坏。SHA256 哈希算法在检测损坏方面具有很高的准确率,包括多位错误。 核心转储文件包含 SHA256 校验和,用于验证核心转储文件的完整性确保文件未被损坏。SHA256 哈希算法在检测损坏方面具有很高的准确率,包括多位错误。
保留栈大小 保留栈大小

View File

@@ -55,11 +55,31 @@ Xtensa 特殊寄存器头文件已更新,使用新的命名约定。旧的 ``s
已弃用的头文件 ``soc_memory_types.h`` 已被移除,请改用替代头文件 ``esp_memory_utils.h`` 已弃用的头文件 ``soc_memory_types.h`` 已被移除,请改用替代头文件 ``esp_memory_utils.h``
App Trace App 追踪
---------- ----------
已移除额外数据缓冲选项。不再支持 `CONFIG_APPTRACE_PENDING_DATA_SIZE_MAX` 配置项。 已移除额外数据缓冲选项。不再支持 `CONFIG_APPTRACE_PENDING_DATA_SIZE_MAX` 配置项。
已移除弃用的 `ESP_APPTRACE_DEST_TRAX` 枚举值。请改用 `ESP_APPTRACE_DEST_JTAG`
函数 :cpp:func:`esp_apptrace_down_buffer_config` 现在需要一个目标参数,并返回一个错误代码以便进行适当的错误处理。
旧代码:
.. code-block:: c
esp_apptrace_down_buffer_config(down_buf, sizeof(down_buf));
现在需要修改成:
.. code-block:: c
esp_err_t res = esp_apptrace_down_buffer_config(ESP_APPTRACE_DEST_JTAG, down_buf, sizeof(down_buf));
if (res != ESP_OK) {
ESP_LOGE(TAG, "Failed to config down buffer!");
return res;
}
FreeRTOS FreeRTOS
-------- --------
@@ -74,3 +94,12 @@ FreeRTOS
**已弃用的函数** **已弃用的函数**
函数 :cpp:func:`pxTaskGetStackStart` 已弃用。请使用 :cpp:func:`xTaskGetStackStart` 替代以提高类型安全性。 函数 :cpp:func:`pxTaskGetStackStart` 已弃用。请使用 :cpp:func:`xTaskGetStackStart` 替代以提高类型安全性。
核心转储
--------
二进制数据格式已被弃用。`CONFIG_ESP_COREDUMP_DATA_FORMAT_BIN` 表示该功能已完全删除,不再可用。现在默认的数据格式是 ELF。
CRC 数据完整性检查已被弃用。`ESP_COREDUMP_CHECKSUM_CRC32` 表示该功能已完全删除,不再可用。现在默认的校验和算法为 SHA256。
函数 :cpp:func:`esp_core_dump_partition_and_size_get()` 现在对空白(已擦除)分区返回 `ESP_ERR_NOT_FOUND`,而不是 `ESP_ERR_INVALID_SIZE`