docs: Provide translation for system.rst in migration-guides

This commit is contained in:
shenmengjing
2024-03-27 16:33:33 +08:00
committed by BOT
parent 95ab3ccf96
commit 49ba4c0268
2 changed files with 33 additions and 3 deletions

View File

@@ -11,7 +11,7 @@ Power Management
Unit Testing
-----------------------
In the past versions of Unity framework, it was possible to omit a semicolon at the end of a ``TEST_ASSERT_*`` macro statement. This is no longer the case in the newer version of Unity, used in IDF v5.3.
In the past versions of Unity framework, it was possible to omit a semicolon at the end of a ``TEST_ASSERT_*`` macro statement. This is no longer the case in the newer version of Unity, used in ESP-IDF v5.3.
For example, the following code:
@@ -28,4 +28,4 @@ Partition Table
Partition Table generation tool has been fixed to ensure that the size of partition of type ``app`` is having flash sector (minimum erase size) aligned size (please see :ref:`partition-offset-and-size`). If the partition does not have aligned size, partition table generator tool will raise an error. This fix ensures that OTA updates for a case where the file size is close or equal to the size of partition works correctly (erase operation does not go beyond the partition size).
In case you have the ``app`` partition size which is not a multiple of the 4 KB then please note that while migrating to ESP-IDF 5.3, you must align this size to its lower 4 KB boundary for the build to succeed. This does not impact the partition table for existing devices as such but ensures that generated firmware size remains within the OTA update capablilty limit.
In case you have the ``app`` partition size which is not a multiple of the 4 KB then please note that while migrating to ESP-IDF v5.3, you must align this size to its lower 4 KB boundary for the build to succeed. This does not impact the partition table for existing devices as such but ensures that generated firmware size remains within the OTA update capability limit.

View File

@@ -1 +1,31 @@
.. include:: ../../../../en/migration-guides/release-5.x/5.3/system.rst
系统
====
:link_to_translation:`en:[English]`
电源管理
--------
* ``esp_sleep_enable_ext1_wakeup_with_level_mask`` 已被弃用,请用 :cpp:func:`esp_sleep_enable_ext1_wakeup_io` 以及 :cpp:func:`esp_sleep_disable_ext1_wakeup_io`
单元测试
--------
旧版 Unity 框架版本允许省略 ``TEST_ASSERT_*`` 宏语句末尾的分号,但 ESP-IDF v5.3 所使用的新版本 Unity 不再允许这一操作。
例如,以下代码:
.. code-block:: c
TEST_ASSERT(some_func() == ESP_OK)
现在将导致编译错误。要修复此问题,请如下所示,在语句末尾添加分号:
TEST_ASSERT(some_func() == ESP_OK);
分区表
------
分区表生成工具已修复,确保类型为 ``app`` 的分区大小与 flash 扇区(最小擦除单元)大小对齐(请参阅 :ref:`partition-offset-and-size`。如果分区大小不对齐分区表生成工具将报错。此修复确保在文件大小接近或等于分区大小的情况下OTA 更新能够正常进行(擦除操作不会超出分区大小)。
如果 ``app`` 分区大小不是 4 KB 的倍数,请注意,在迁移到 ESP-IDF v5.3 时,必须将此分区的大小与 4 KB或 4 KB 的倍数)对齐,以确保能成功构建。这不会影响现有设备的分区表,但能确保生成的固件大小保持在可以 OTA 更新的大小范围内。