docs: sync up translation for several documents

This commit is contained in:
daiziyan 2024-03-25 17:45:19 +08:00
parent 3f486c4477
commit 5fb96ec687
6 changed files with 67 additions and 9 deletions

View File

@ -185,7 +185,7 @@ In the temperature sensor driver, we do not add any protection to ensure the thr
ETM Event and Task
^^^^^^^^^^^^^^^^^^
Temperature Sensor is able to generate events that can interact with the :doc:`ETM </api-reference/peripherals/etm>` module. The supported events are listed in the :cpp:type:`temperature_sensor_etm_event_type_t`. You can call :cpp:func:`temperature_sensor_new_etm_event` to get the corresponding ETM event handle. The supported tasks are listed in the :cpp:type:`temperature_sensor_etm_task_type_t`. You can call :cpp:func:`temperature_sensor_new_etm_task` to get the corresponding ETM event handle.
Temperature Sensor is able to generate events that can interact with the :doc:`ETM </api-reference/peripherals/etm>` module. The supported events are listed in the :cpp:type:`temperature_sensor_etm_event_type_t`. You can call :cpp:func:`temperature_sensor_new_etm_event` to get the corresponding ETM event handle. The supported tasks are listed in the :cpp:type:`temperature_sensor_etm_task_type_t`. You can call :cpp:func:`temperature_sensor_new_etm_task` to get the corresponding ETM task handle.
.. note::

View File

@ -1,17 +1,17 @@
WiFi
====
Wi-Fi
======
:link_to_translation:`zh_CN:[中文]`
WiFi Enterprise Security
------------------------
Wi-Fi Enterprise Security
---------------------------
APIs defined in `esp_wpa2.h` have been deprecated. Please use newer APIs from `esp_eap_client.h`.
WiFi Disconnect Reason Codes
----------------------------
Wi-Fi Disconnect Reason Codes
------------------------------
For the event WIFI_EVENT_STA_DISCONNECTED, the original reason code WIFI_REASON_NO_AP_FOUND has been split as follows:

View File

@ -46,6 +46,7 @@
- :ref:`temp-power-management` - 介绍更改功耗模式(如 Light-sleep 模式)对温度传感器造成的影响。
:SOC_TEMPERATURE_SENSOR_INTR_SUPPORT: - :ref:`temp-iram-safe` - 介绍在禁用 cache 时如何提高温度传感器的性能。
- :ref:`temp-thread-safety` - 介绍如何使驱动程序具备线程安全性。
:SOC_TEMPERATURE_SENSOR_SUPPORT_ETM: - :ref:`temperature-sensor-etm-event-and-task` - 介绍哪些事件和任务可以连接到 ETM 通道。
.. _temp-resource-allocation:
@ -177,6 +178,21 @@
温度传感器中并未添加任何确保线程安全的额外保护,因为温度传感器通常只在一个任务中调用。如果要在不同任务中使用该驱动程序,请设置额外的锁进行保护。
.. only:: SOC_TEMPERATURE_SENSOR_SUPPORT_ETM
.. _temperature-sensor-etm-event-and-task:
ETM 事件和任务
^^^^^^^^^^^^^^^^^^
温度传感器能够生成事件,这些事件可以与 :doc:ETM </api-reference/peripherals/etm> 模块进行交互。:cpp:type:temperature_sensor_etm_event_type_t 中列出了所有支持的事件。可以调用 :cpp:func:temperature_sensor_new_etm_event 来获取相应的 ETM 事件句柄。:cpp:type:temperature_sensor_etm_task_type_t 中列出了所有支持的任务。可以调用 :cpp:func:temperature_sensor_new_etm_task 来获取相应的 ETM 任务句柄。
.. note::
- 对于 :cpp:member:`temperature_sensor_etm_event_type_t::event_type`:cpp:enumerator:`TEMPERATURE_SENSOR_EVENT_OVER_LIMIT` 取决于首先设置的阈值类型。如果是通过 :cpp:func:`temperature_sensor_set_absolute_threshold` 设置了绝对阈值,那么 :cpp:enumerator:`TEMPERATURE_SENSOR_EVENT_OVER_LIMIT` 将指代绝对阈值。同样,如果是通过 :cpp:func:`temperature_sensor_set_delta_threshold` 设置了增量阈值,那么 :cpp:enumerator:`TEMPERATURE_SENSOR_EVENT_OVER_LIMIT` 将指代增量阈值。
有关如何将事件和任务连接到 ETM 通道的详细信息,请参阅 :doc:ETM </api-reference/peripherals/etm> 文档。
意外情况
--------------------
@ -199,3 +215,8 @@ API 参考
----------------------------------
.. include-build-file:: inc/temperature_sensor.inc
.. include-build-file:: inc/temperature_sensor_types.inc
.. only:: SOC_TEMPERATURE_SENSOR_SUPPORT_ETM
.. include-build-file:: inc/temperature_sensor_etm.inc

View File

@ -16,7 +16,7 @@ ESP x509 证书包 API 提供了一种简便的方法,帮助你安装自定义
生成证书包时,你需选择:
* 来自 Mozilla 的完整根证书包,包含超过 130 份证书。目前提供的证书包更新于 2023 年 1 月 10 日星期二04:12:06 (GMT)。
* 来自 Mozilla 的完整根证书包,包含超过 130 份证书。目前提供的证书包更新于 2024 年 3 月 11 日星期一15:25:27 (GMT)。
* 一组预先筛选的常用根证书。其中仅包含约 41 份证书,但根据 SSL 证书颁发机构统计数据,其绝对使用率约达到 90%,市场覆盖率约达 99%。
此外,还可指定证书文件的路径或包含证书的目录,将其他证书添加到生成的证书包中。

View File

@ -172,6 +172,7 @@ Light-sleep 外设下电
当外设电源域在睡眠期间断电时IO_MUX 和 GPIO 模块都处于下电状态,这意味着芯片引脚的状态不会受这些模块控制。要在休眠期间保持 IO 的状态,需要在配置 GPIO 状态前后调用 :cpp:func:`gpio_hold_dis`:cpp:func:`gpio_hold_en`。此操作可确保 IO 配置被锁存,防止 IO 在睡眠期间浮空。
API 参考
-------------

View File

@ -1,4 +1,40 @@
GCC
***
.. include:: ../../../../en/migration-guides/release-5.x/5.3/gcc.rst
:link_to_translation:`en:[English]`
常见的移植问题及解决方法
=================================
``sys/dirent.h`` 不再包含一些函数原型
-------------------------------------------------------
问题
^^^^^^
使用旧工具链的代码可能会出现编译错误。例如:
.. code-block:: c
#include <sys/dirent.h>
/* .... */
DIR* dir = opendir("test_dir");
/* .... */
/**
* Compile error:
* test.c: In function 'test_opendir':
* test.c:100:16: error: implicit declaration of function 'opendir' [-Werror=implicit-function-declaration]
* 100 | DIR* dir = opendir(path);
* | ^~~~~~~
*/
解决方法
^^^^^^^^^
包含正确的头文件即可解决此问题。请将代码重构如下:
.. code-block:: c
#include <dirent.h>
/* .... */
DIR* dir = opendir("test_dir");