diff --git a/docs/en/api-reference/peripherals/temp_sensor.rst b/docs/en/api-reference/peripherals/temp_sensor.rst index 1e18f13053..192dfae27e 100644 --- a/docs/en/api-reference/peripherals/temp_sensor.rst +++ b/docs/en/api-reference/peripherals/temp_sensor.rst @@ -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 ` 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 ` 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:: diff --git a/docs/en/migration-guides/release-5.x/5.2/wifi.rst b/docs/en/migration-guides/release-5.x/5.2/wifi.rst index 3e006d0be0..069052bb0c 100644 --- a/docs/en/migration-guides/release-5.x/5.2/wifi.rst +++ b/docs/en/migration-guides/release-5.x/5.2/wifi.rst @@ -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: diff --git a/docs/zh_CN/api-reference/peripherals/temp_sensor.rst b/docs/zh_CN/api-reference/peripherals/temp_sensor.rst index a1d4a15e8c..743bcc7acf 100644 --- a/docs/zh_CN/api-reference/peripherals/temp_sensor.rst +++ b/docs/zh_CN/api-reference/peripherals/temp_sensor.rst @@ -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 模块进行交互。: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 文档。 + 意外情况 -------------------- @@ -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 diff --git a/docs/zh_CN/api-reference/protocols/esp_crt_bundle.rst b/docs/zh_CN/api-reference/protocols/esp_crt_bundle.rst index 4fa8fa85d6..e5de6f6861 100644 --- a/docs/zh_CN/api-reference/protocols/esp_crt_bundle.rst +++ b/docs/zh_CN/api-reference/protocols/esp_crt_bundle.rst @@ -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%。 此外，还可指定证书文件的路径或包含证书的目录，将其他证书添加到生成的证书包中。 diff --git a/docs/zh_CN/api-reference/system/power_management.rst b/docs/zh_CN/api-reference/system/power_management.rst index 03a2f997bf..05acedc2c1 100644 --- a/docs/zh_CN/api-reference/system/power_management.rst +++ b/docs/zh_CN/api-reference/system/power_management.rst @@ -172,6 +172,7 @@ Light-sleep 外设下电 当外设电源域在睡眠期间断电时，IO_MUX 和 GPIO 模块都处于下电状态，这意味着芯片引脚的状态不会受这些模块控制。要在休眠期间保持 IO 的状态，需要在配置 GPIO 状态前后调用 :cpp:func:`gpio_hold_dis` 和 :cpp:func:`gpio_hold_en`。此操作可确保 IO 配置被锁存，防止 IO 在睡眠期间浮空。 + API 参考 ------------- diff --git a/docs/zh_CN/migration-guides/release-5.x/5.3/gcc.rst b/docs/zh_CN/migration-guides/release-5.x/5.3/gcc.rst index d2312c21ef..44638befd9 100644 --- a/docs/zh_CN/migration-guides/release-5.x/5.3/gcc.rst +++ b/docs/zh_CN/migration-guides/release-5.x/5.3/gcc.rst @@ -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 + /* .... */ + 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 + /* .... */ + DIR* dir = opendir("test_dir");