Merge branch 'feature/support_lp_uart_for_uart_driver' into 'master'

uart: Support LP_UART port with UART driver for esp32c6

Closes IDF-7061 and IDF-7374

See merge request espressif/esp-idf!22914

docs/en/api-reference/peripherals/uart.rst

@@ -8,9 +8,13 @@ Introduction
 
 A Universal Asynchronous Receiver/Transmitter (UART) is a hardware feature that handles communication (i.e., timing requirements and data framing) using widely-adopted asynchronous serial communication interfaces, such as RS232, RS422, and RS485. A UART provides a widely adopted and cheap method to realize full-duplex or half-duplex data exchange among different devices.
 
-The {IDF_TARGET_NAME} chip has {IDF_TARGET_SOC_UART_NUM} UART controllers (also referred to as port), each featuring an identical set of registers to simplify programming and for more flexibility.
+The {IDF_TARGET_NAME} chip has {IDF_TARGET_SOC_UART_HP_NUM} UART controllers (also referred to as port), each featuring an identical set of registers to simplify programming and for more flexibility.
 
-Each UART controller is independently configurable with parameters such as baud rate, data bit length, bit ordering, number of stop bits, parity bit, etc. All the controllers are compatible with UART-enabled devices from various manufacturers and can also support Infrared Data Association (IrDA) protocols.
+Each UART controller is independently configurable with parameters such as baud rate, data bit length, bit ordering, number of stop bits, parity bit, etc. All the regular UART controllers are compatible with UART-enabled devices from various manufacturers and can also support Infrared Data Association (IrDA) protocols.
+
+.. only:: SOC_UART_LP_NUM
+
+    Additionally, the {IDF_TARGET_NAME} chip has one low-power (LP) UART controller. It is the cut-down version of regular UART. Usually, the LP UART controller only support basic UART functionality with a much smaller RAM size, and does not support IrDA or RS485 protocols. For a full list of difference between UART and LP UART, please refer to the *{IDF_TARGET_NAME} Technical Reference Manual* > *UART Controller (UART)* > *Features* [`PDF <{IDF_TARGET_TRM_EN_URL}#uart>`__]).
 
 Functional Overview
 -------------------
@@ -238,7 +242,7 @@ The API provides a convenient way to handle specific interrupts discussed in thi
 Macros
 ^^^^^^
 
-The API also defines several macros. For example, :c:macro:`UART_FIFO_LEN` defines the length of hardware FIFO buffers; :c:macro:`UART_BITRATE_MAX` gives the maximum baud rate supported by the UART controllers, etc.
+The API also defines several macros. For example, :c:macro:`UART_HW_FIFO_LEN` defines the length of hardware FIFO buffers; :c:macro:`UART_BITRATE_MAX` gives the maximum baud rate supported by the UART controllers, etc.
 
 
 .. _uart-api-deleting-driver:

docs/en/migration-guides/index.rst

@@ -11,3 +11,4 @@ ESP-IDF 5.x Migration Guide
 
     release-5.x/5.0/index
     release-5.x/5.1/index
+    release-5.x/5.2/index

docs/en/migration-guides/release-5.x/5.2/index.rst

@@ -0,0 +1,9 @@
+Migration from 5.1 to 5.2
+-------------------------
+
+:link_to_translation:`zh_CN:[中文]`
+
+.. toctree::
+    :maxdepth: 1
+
+    peripherals

docs/en/migration-guides/release-5.x/5.2/peripherals.rst

@@ -0,0 +1,11 @@
+Peripherals
+===========
+
+:link_to_translation:`zh_CN:[中文]`
+
+.. only:: SOC_UART_SUPPORTED
+
+    UART
+    ----
+
+    - :c:macro:`UART_FIFO_LEN` is deprecated. Please use :c:macro:`UART_HW_FIFO_LEN` instead.

docs/zh_CN/api-reference/peripherals/uart.rst

@@ -8,9 +8,13 @@
 
 通用异步接收器/发送器 (UART) 属于一种硬件功能，通过使用 RS232、RS422、RS485 等常见异步串行通信接口来处理通信时序要求和数据帧。UART 是实现不同设备之间全双工或半双工数据交换的一种常用且经济的方式。
 
-{IDF_TARGET_NAME} 芯片有{IDF_TARGET_SOC_UART_NUM}个 UART 控制器（也称为端口），每个控制器都有一组相同的寄存器以简化编程并提高灵活性。
+{IDF_TARGET_NAME} 芯片有{IDF_TARGET_SOC_UART_HP_NUM}个 UART 控制器（也称为端口），每个控制器都有一组相同的寄存器以简化编程并提高灵活性。
 
-每个 UART 控制器可以独立配置波特率、数据位长度、位顺序、停止位位数、奇偶校验位等参数。所有控制器都与不同制造商的 UART 设备兼容，并且支持红外数据协会 (IrDA) 定义的标准协议。
+每个 UART 控制器可以独立配置波特率、数据位长度、位顺序、停止位位数、奇偶校验位等参数。所有具备完整功能的 UART 控制器都能与不同制造商的 UART 设备兼容，并且支持红外数据协会 (IrDA) 定义的标准协议。
+
+.. only:: SOC_UART_LP_NUM
+
+    此外，{IDF_TARGET_NAME} 芯片还有一个满足低功耗需求的 LP UART 控制器。LP UART 是原 UART 的功能剪裁版本。它只支持基础 UART 功能，不支持 IrDA 或 RS485 协议，并且只有一块较小的 RAM 存储空间。想要全面了解的 UART 及 LP UART 功能区别，请参考 *{IDF_TARGET_NAME} 技术参考手册* > UART 控制器 (UART) > 主要特性 [`PDF <{IDF_TARGET_TRM_EN_URL}#uart>`__]。
 
 功能概述
 -------------------
@@ -238,7 +242,7 @@ API 提供了一种便利的方法来处理本文所讨论的特定中断，即
 宏指令
 ^^^^^^^^^^^^
 
-API 还定义了一些宏指令。例如，:c:macro:`UART_FIFO_LEN` 定义了硬件 FIFO 缓冲区的长度，:c:macro:`UART_BITRATE_MAX` 定义了 UART 控制器支持的最大波特率。
+API 还定义了一些宏指令。例如，:c:macro:`UART_HW_FIFO_LEN` 定义了硬件 FIFO 缓冲区的长度，:c:macro:`UART_BITRATE_MAX` 定义了 UART 控制器支持的最大波特率。
 
 
 .. _uart-api-deleting-driver:

docs/zh_CN/migration-guides/index.rst

@@ -11,3 +11,4 @@
 
     release-5.x/5.0/index
     release-5.x/5.1/index
+    release-5.x/5.2/index

docs/zh_CN/migration-guides/release-5.x/5.2/index.rst

@@ -0,0 +1,9 @@
+从 5.1 迁移到 5.2
+-----------------
+
+:link_to_translation:`en:[English]`
+
+.. toctree::
+    :maxdepth: 1
+
+    peripherals

docs/zh_CN/migration-guides/release-5.x/5.2/peripherals.rst

@@ -0,0 +1,11 @@
+外设
+============
+
+:link_to_translation:`en:[English]`
+
+.. only:: SOC_UART_SUPPORTED
+
+    UART
+    ----
+
+    - :c:macro:`UART_FIFO_LEN` 已弃用，更新为 :c:macro:`UART_HW_FIFO_LEN`。