diff --git a/components/driver/uart/include/driver/uart.h b/components/driver/uart/include/driver/uart.h
index 502012d53d..7063594bac 100644
--- a/components/driver/uart/include/driver/uart.h
+++ b/components/driver/uart/include/driver/uart.h
@@ -208,7 +208,9 @@ esp_err_t uart_get_parity(uart_port_t uart_num, uart_parity_t* parity_mode);
 esp_err_t uart_get_sclk_freq(uart_sclk_t sclk, uint32_t* out_freq_hz);
 
 /**
- * @brief Set UART baud rate.
+ * @brief Set desired UART baud rate.
+ *
+ * Note that the actual baud rate set could have a slight deviation from the user-configured value due to rounding error.
  *
  * @param uart_num UART port number, the max port number is (UART_NUM_MAX -1).
  * @param baudrate UART baud rate.
@@ -220,7 +222,9 @@ esp_err_t uart_get_sclk_freq(uart_sclk_t sclk, uint32_t* out_freq_hz);
 esp_err_t uart_set_baudrate(uart_port_t uart_num, uint32_t baudrate);
 
 /**
- * @brief Get the UART baud rate configuration.
+ * @brief Get the actual UART baud rate.
+ *
+ * It returns the real UART rate set in the hardware. It could have a slight deviation from the user-configured baud rate.
  *
  * @param uart_num UART port number, the max port number is (UART_NUM_MAX -1).
  * @param baudrate Pointer to accept value of UART baud rate
diff --git a/components/hal/include/hal/uart_types.h b/components/hal/include/hal/uart_types.h
index 6062d4355a..fdf877c528 100644
--- a/components/hal/include/hal/uart_types.h
+++ b/components/hal/include/hal/uart_types.h
@@ -118,7 +118,8 @@ typedef struct {
  * @brief UART configuration parameters for uart_param_config function
  */
 typedef struct {
-    int baud_rate;                      /*!< UART baud rate*/
+    int baud_rate;                      /*!< UART baud rate
+                                             Note that the actual baud rate set could have a slight deviation from the user-configured value due to rounding error*/
     uart_word_length_t data_bits;       /*!< UART byte size*/
     uart_parity_t parity;               /*!< UART parity mode*/
     uart_stop_bits_t stop_bits;         /*!< UART stop bits*/