From 8138f8bb02b52bfd0f70575560815e3a87d32866 Mon Sep 17 00:00:00 2001
From: morris <maoshengrong@espressif.com>
Date: Sat, 14 May 2022 19:12:13 +0800
Subject: [PATCH] driver: remove deprecated code

that declared as deprecated in the previous release
---
 .../deprecated/driver/rmt_types_legacy.h      |  1 -
 components/driver/deprecated/driver/timer.h   | 49 -----------
 .../deprecated/driver/timer_types_legacy.h    |  7 --
 components/driver/deprecated/timer_legacy.c   | 36 ---------
 components/driver/include/driver/ledc.h       |  5 +-
 components/driver/include/driver/mcpwm.h      | 81 -------------------
 components/driver/include/driver/rtc_io.h     |  2 +-
 components/driver/include/driver/sdmmc_host.h | 20 -----
 components/driver/include/driver/spi_master.h | 17 +---
 components/driver/include/driver/uart.h       | 28 +------
 components/driver/mcpwm.c                     | 73 -----------------
 components/driver/sdmmc_host.c                |  3 -
 components/driver/spi_master.c                |  5 --
 components/hal/include/hal/i2c_types.h        | 10 ---
 components/hal/include/hal/uart_types.h       |  5 +-
 .../api-reference/system/power_management.rst |  2 +-
 docs/en/migration-guides/peripherals.rst      | 70 +++++++++++++++-
 .../api-reference/system/power_management.rst |  2 +-
 18 files changed, 75 insertions(+), 341 deletions(-)

diff --git a/components/driver/deprecated/driver/rmt_types_legacy.h b/components/driver/deprecated/driver/rmt_types_legacy.h
index b297999b9f..f21c8851e5 100644
--- a/components/driver/deprecated/driver/rmt_types_legacy.h
+++ b/components/driver/deprecated/driver/rmt_types_legacy.h
@@ -18,7 +18,6 @@ extern "C" {
 
 #define RMT_CHANNEL_FLAGS_AWARE_DFS (1 << 0) /*!< Channel can work during APB clock scaling */
 #define RMT_CHANNEL_FLAGS_INVERT_SIG (1 << 1) /*!< Invert RMT signal */
-#define RMT_CHANNEL_FLAGS_ALWAYS_ON _Pragma ("GCC warning \"'RMT_CHANNEL_FLAGS_ALWAYS_ON' macro is deprecated\"") RMT_CHANNEL_FLAGS_AWARE_DFS
 
 /**
  * @brief Define memory space of each RMT channel (in words = 4 bytes)
diff --git a/components/driver/deprecated/driver/timer.h b/components/driver/deprecated/driver/timer.h
index e035d16522..2569718641 100644
--- a/components/driver/deprecated/driver/timer.h
+++ b/components/driver/deprecated/driver/timer.h
@@ -315,14 +315,6 @@ esp_err_t timer_enable_intr(timer_group_t group_num, timer_idx_t timer_num);
  */
 esp_err_t timer_disable_intr(timer_group_t group_num, timer_idx_t timer_num);
 
-/** @brief Clear timer interrupt status, just used in ISR
- *
- * @param group_num Timer group number, 0 for TIMERG0 or 1 for TIMERG1
- * @param timer_num Timer index.
- *
- */
-void timer_group_intr_clr_in_isr(timer_group_t group_num, timer_idx_t timer_num) __attribute__((deprecated));
-
 /** @brief Clear timer interrupt status, just used in ISR
  *
  * @param group_num Timer group number, 0 for TIMERG0 or 1 for TIMERG1
@@ -367,14 +359,6 @@ void timer_group_set_alarm_value_in_isr(timer_group_t group_num, timer_idx_t tim
  */
 void timer_group_set_counter_enable_in_isr(timer_group_t group_num, timer_idx_t timer_num, timer_start_t counter_en);
 
-/** @brief Get the masked interrupt status, just used in ISR
- *
- * @param group_num Timer group number, 0 for TIMERG0 or 1 for TIMERG1
- *
- * @return
- *     - Interrupt status
- */
-timer_intr_t timer_group_intr_get_in_isr(timer_group_t group_num) __attribute__((deprecated));
 
 /** @brief Get interrupt status, just used in ISR
  *
@@ -384,15 +368,6 @@ timer_intr_t timer_group_intr_get_in_isr(timer_group_t group_num) __attribute__(
  *     - Interrupt status
  */
 uint32_t timer_group_get_intr_status_in_isr(timer_group_t group_num);
-
-/** @brief Clear the masked interrupt status, just used in ISR
- *
- * @param group_num Timer group number, 0 for TIMERG0 or 1 for TIMERG1
- * @param intr_mask Masked interrupt.
- *
- */
-void timer_group_clr_intr_sta_in_isr(timer_group_t group_num, timer_intr_t intr_mask) __attribute__((deprecated));
-
 /** @brief Get auto reload enable status, just used in ISR
  *
  * @param group_num Timer group number, 0 for TIMERG0 or 1 for TIMERG1
@@ -404,30 +379,6 @@ void timer_group_clr_intr_sta_in_isr(timer_group_t group_num, timer_intr_t intr_
  */
 bool timer_group_get_auto_reload_in_isr(timer_group_t group_num, timer_idx_t timer_num);
 
-/** @brief Take timer spinlock to enter critical protect
- *
- *  @note Deprecated, the recommended way is to use ISR callbacks instead, see timer_group_example_main
- *
- * @param group_num Timer group number, 0 for TIMERG0 or 1 for TIMERG1
- *
- * @return
- *     - ESP_OK Success
- *     - ESP_ERR_INVALID_ARG Parameter error
- */
-esp_err_t timer_spinlock_take(timer_group_t group_num) __attribute__ ((deprecated));
-
-/** @brief Give timer spinlock to exit critical protect
- *
- *  @note Deprecated, the recommended way is to use ISR callbacks instead, see timer_group_example_main
- *
- * @param group_num Timer group number, 0 for TIMERG0 or 1 for TIMERG1
- *
- * @return
- *     - ESP_OK Success
- *     - ESP_ERR_INVALID_ARG Parameter error
- */
-esp_err_t timer_spinlock_give(timer_group_t group_num) __attribute__ ((deprecated));
-
 #ifdef __cplusplus
 }
 #endif
diff --git a/components/driver/deprecated/driver/timer_types_legacy.h b/components/driver/deprecated/driver/timer_types_legacy.h
index 1099b4580f..16eaaf2061 100644
--- a/components/driver/deprecated/driver/timer_types_legacy.h
+++ b/components/driver/deprecated/driver/timer_types_legacy.h
@@ -16,13 +16,6 @@
 extern "C" {
 #endif
 
-/**
- * @brief Frequency of the clock on the input of the timer groups
- * @note  This macro is not correct for Timer Groups with multiple clock sources (e.g. APB, XTAL)
- *        So please don't use it in your application, we keep it here only for backward compatible
- */
-#define TIMER_BASE_CLK _Pragma ("GCC warning \"'TIMER_BASE_CLK' macro is deprecated\"") APB_CLK_FREQ
-
 /**
  * @brief Timer-Group ID
  */
diff --git a/components/driver/deprecated/timer_legacy.c b/components/driver/deprecated/timer_legacy.c
index f43a38652b..d753a75f16 100644
--- a/components/driver/deprecated/timer_legacy.c
+++ b/components/driver/deprecated/timer_legacy.c
@@ -406,12 +406,6 @@ esp_err_t timer_group_intr_disable(timer_group_t group_num, timer_intr_t disable
     return ESP_OK;
 }
 
-/* This function is deprecated */
-timer_intr_t IRAM_ATTR timer_group_intr_get_in_isr(timer_group_t group_num)
-{
-    return timer_ll_get_intr_status(TIMER_LL_GET_HW(group_num));
-}
-
 uint32_t IRAM_ATTR timer_group_get_intr_status_in_isr(timer_group_t group_num)
 {
     uint32_t intr_status = 0;
@@ -431,12 +425,6 @@ void IRAM_ATTR timer_group_clr_intr_status_in_isr(timer_group_t group_num, timer
     timer_ll_clear_intr_status(p_timer_obj[group_num][timer_num]->hal.dev, TIMER_LL_EVENT_ALARM(timer_num));
 }
 
-/* This function is deprecated */
-void IRAM_ATTR timer_group_intr_clr_in_isr(timer_group_t group_num, timer_idx_t timer_num)
-{
-    timer_group_clr_intr_status_in_isr(group_num, timer_num);
-}
-
 void IRAM_ATTR timer_group_enable_alarm_in_isr(timer_group_t group_num, timer_idx_t timer_num)
 {
     timer_ll_enable_alarm(p_timer_obj[group_num][timer_num]->hal.dev, timer_num, true);
@@ -460,35 +448,11 @@ void IRAM_ATTR timer_group_set_counter_enable_in_isr(timer_group_t group_num, ti
     p_timer_obj[group_num][timer_num]->counter_en = counter_en;
 }
 
-/* This function is deprecated */
-void IRAM_ATTR timer_group_clr_intr_sta_in_isr(timer_group_t group_num, timer_intr_t intr_mask)
-{
-    for (uint32_t timer_idx = 0; timer_idx < TIMER_MAX; timer_idx++) {
-        if (intr_mask & BIT(timer_idx)) {
-            timer_group_clr_intr_status_in_isr(group_num, timer_idx);
-        }
-    }
-}
-
 bool IRAM_ATTR timer_group_get_auto_reload_in_isr(timer_group_t group_num, timer_idx_t timer_num)
 {
     return p_timer_obj[group_num][timer_num]->auto_reload_en;
 }
 
-esp_err_t IRAM_ATTR timer_spinlock_take(timer_group_t group_num)
-{
-    ESP_RETURN_ON_FALSE(group_num < TIMER_GROUP_MAX, ESP_ERR_INVALID_ARG, TIMER_TAG,  TIMER_GROUP_NUM_ERROR);
-    TIMER_ENTER_CRITICAL(&timer_spinlock[group_num]);
-    return ESP_OK;
-}
-
-esp_err_t IRAM_ATTR timer_spinlock_give(timer_group_t group_num)
-{
-    ESP_RETURN_ON_FALSE(group_num < TIMER_GROUP_MAX, ESP_ERR_INVALID_ARG, TIMER_TAG,  TIMER_GROUP_NUM_ERROR);
-    TIMER_EXIT_CRITICAL(&timer_spinlock[group_num]);
-    return ESP_OK;
-}
-
 /**
  * @brief This function will be called during start up, to check that this legacy timer group driver is not running along with the gptimer driver
  */
diff --git a/components/driver/include/driver/ledc.h b/components/driver/include/driver/ledc.h
index 5754292414..05b499e2dc 100644
--- a/components/driver/include/driver/ledc.h
+++ b/components/driver/include/driver/ledc.h
@@ -55,10 +55,7 @@ typedef struct {
  */
 typedef struct {
     ledc_mode_t speed_mode;                /*!< LEDC speed speed_mode, high-speed mode or low-speed mode */
-    union {
-        ledc_timer_bit_t duty_resolution;  /*!< LEDC channel duty resolution */
-        ledc_timer_bit_t bit_num __attribute__((deprecated)); /*!< Deprecated in ESP-IDF 3.0. This is an alias to 'duty_resolution' for backward compatibility with ESP-IDF 2.1 */
-    };
+    ledc_timer_bit_t duty_resolution;      /*!< LEDC channel duty resolution */
     ledc_timer_t  timer_num;               /*!< The timer source of channel (0 - 3) */
     uint32_t freq_hz;                      /*!< LEDC timer frequency (Hz) */
     ledc_clk_cfg_t clk_cfg;                /*!< Configure LEDC source clock from ledc_clk_cfg_t.
diff --git a/components/driver/include/driver/mcpwm.h b/components/driver/include/driver/mcpwm.h
index aa435a71a3..7f900f78d4 100644
--- a/components/driver/include/driver/mcpwm.h
+++ b/components/driver/include/driver/mcpwm.h
@@ -170,16 +170,6 @@ typedef enum {
     MCPWM_BOTH_EDGE = BIT(1) | BIT(0), /*!<Capture both edges*/
 } mcpwm_capture_on_edge_t;
 
-/**
- * @brief Interrupt masks for MCPWM capture
- */
-__attribute__ ((deprecated("please use callback function to avoid directly accessing registers")))
-typedef enum {
-    MCPWM_LL_INTR_CAP0 = BIT(27), ///< Capture 0 happened
-    MCPWM_LL_INTR_CAP1 = BIT(28), ///< Capture 1 happened
-    MCPWM_LL_INTR_CAP2 = BIT(29), ///< Capture 2 happened
-} mcpwm_intr_t;
-
 /**
  * @brief Select type of MCPWM counter
  */
@@ -739,39 +729,6 @@ esp_err_t mcpwm_fault_set_cyc_mode(mcpwm_unit_t mcpwm_num, mcpwm_timer_t timer_n
  */
 esp_err_t mcpwm_fault_deinit(mcpwm_unit_t mcpwm_num, mcpwm_fault_signal_t fault_sig);
 
-/**
- * @brief Initialize capture submodule
- *
- * @note Enabling capture feature would also enable the capture interrupt event,
- *       users have to register an interrupt handler by `mcpwm_isr_register`, and in there, query the capture data.
- * @note The capture timer uses APB_CLK (typically 80MHz) as the count source.
- *
- * @param mcpwm_num set MCPWM unit(0-1)
- * @param cap_edge set capture edge, BIT(0) - negative edge, BIT(1) - positive edge
- * @param cap_sig capture pin, which needs to be enabled
- * @param num_of_pulse Input capture signal prescaling, ranges from 0 to 255, representing prescaling from 1 to 256.
- *
- * @return
- *     - ESP_OK Success
- *     - ESP_ERR_INVALID_ARG Parameter error
- */
-__attribute__((deprecated("please use mcpwm_capture_enable_channel instead")))
-esp_err_t mcpwm_capture_enable(mcpwm_unit_t mcpwm_num, mcpwm_capture_signal_t cap_sig, mcpwm_capture_on_edge_t cap_edge,
-                               uint32_t num_of_pulse);
-
-/**
- * @brief Disable capture signal
- *
- * @param mcpwm_num set MCPWM unit(0-1)
- * @param cap_sig capture pin, which needs to be disabled
- *
- * @return
- *     - ESP_OK Success
- *     - ESP_ERR_INVALID_ARG Parameter error
- */
-__attribute__((deprecated("please use mcpwm_capture_disable_channel instead")))
-esp_err_t mcpwm_capture_disable(mcpwm_unit_t mcpwm_num, mcpwm_capture_signal_t cap_sig);
-
 /**
  * @brief Enable capture channel
  *
@@ -819,24 +776,6 @@ uint32_t mcpwm_capture_signal_get_value(mcpwm_unit_t mcpwm_num, mcpwm_capture_si
  */
 uint32_t mcpwm_capture_signal_get_edge(mcpwm_unit_t mcpwm_num, mcpwm_capture_signal_t cap_sig);
 
-/**
- * @brief Initialize sync submodule and sets the signal that will cause the timer be loaded with pre-defined value
- *
- * @param mcpwm_num set MCPWM unit(0-1)
- * @param timer_num set timer number(0-2) of MCPWM, each MCPWM unit has 3 timers
- * @param sync_sig set the synchronization input signal
- * @param phase_val phase value in 1/1000 (for 86.7%, phase_val = 867) which timer moves to on sync signal
- *
- * @note Count direction is undefined within this API
- *
- * @return
- *     - ESP_OK Success
- *     - ESP_ERR_INVALID_ARG Parameter error
- */
-__attribute__((deprecated("please use mcpwm_sync_configure() instead")))
-esp_err_t mcpwm_sync_enable(mcpwm_unit_t mcpwm_num, mcpwm_timer_t timer_num, mcpwm_sync_signal_t sync_sig,
-                            uint32_t phase_val);
-
 /**
  * @brief Initialize sync submodule and sets the signal that will cause the timer be loaded with pre-defined value
  *
@@ -905,26 +844,6 @@ esp_err_t mcpwm_timer_trigger_soft_sync(mcpwm_unit_t mcpwm_num, mcpwm_timer_t ti
  */
 esp_err_t mcpwm_sync_invert_gpio_synchro(mcpwm_unit_t mcpwm_num, mcpwm_sync_signal_t sync_sig, bool invert);
 
-/**
- * @brief Register MCPWM interrupt handler, the handler is an ISR.
- *        the handler will be attached to the same CPU core that this function is running on.
- *
- * @param mcpwm_num set MCPWM unit(0-1)
- * @param fn interrupt handler function.
- * @param arg user-supplied argument passed to the handler function.
- * @param intr_alloc_flags flags used to allocate the interrupt. One or multiple (ORred)
- *        ESP_INTR_FLAG_* values. see esp_intr_alloc.h for more info.
- * @param handle pointer to return handle. If non-NULL, a handle for the interrupt will
- *        be returned here.
- *
- * @return
- *     - ESP_OK Success
- *     - ESP_ERR_INVALID_ARG Function pointer error.
- */
-__attribute__((deprecated("interrupt events are handled by driver, please use callback")))
-esp_err_t mcpwm_isr_register(mcpwm_unit_t mcpwm_num, void (*fn)(void *), void *arg, int intr_alloc_flags,
-                             intr_handle_t *handle);
-
 #ifdef __cplusplus
 }
 #endif
diff --git a/components/driver/include/driver/rtc_io.h b/components/driver/include/driver/rtc_io.h
index ffa51d5846..b428afc3c0 100644
--- a/components/driver/include/driver/rtc_io.h
+++ b/components/driver/include/driver/rtc_io.h
@@ -26,7 +26,7 @@ extern "C" {
  */
 bool rtc_gpio_is_valid_gpio(gpio_num_t gpio_num);
 
-#define RTC_GPIO_IS_VALID_GPIO(gpio_num) rtc_gpio_is_valid_gpio(gpio_num) // Deprecated, use rtc_gpio_is_valid_gpio()
+#define RTC_GPIO_IS_VALID_GPIO(gpio_num) rtc_gpio_is_valid_gpio(gpio_num)
 
 #if SOC_RTCIO_INPUT_OUTPUT_SUPPORTED
 /**
diff --git a/components/driver/include/driver/sdmmc_host.h b/components/driver/include/driver/sdmmc_host.h
index ff5ae71d01..cab4c82955 100644
--- a/components/driver/include/driver/sdmmc_host.h
+++ b/components/driver/include/driver/sdmmc_host.h
@@ -259,26 +259,6 @@ esp_err_t sdmmc_host_io_int_wait(int slot, TickType_t timeout_ticks);
  */
 esp_err_t sdmmc_host_deinit(void);
 
-/**
- * @brief Enable the pull-ups of sd pins.
- *
- * This function is deprecated. Please set SDMMC_SLOT_FLAG_INTERNAL_PULLUP flag in
- * sdmmc_slot_config_t::flags instead.
- *
- * @note You should always place actual pullups on the lines instead of using
- * this function. Internal pullup resistance are high and not sufficient, may
- * cause instability in products. This is for debug or examples only.
- *
- * @param slot Slot to use, normally set it to 1.
- * @param width Bit width of your configuration, 1 or 4.
- *
- * @return
- *      - ESP_OK: if success
- *      - ESP_ERR_INVALID_ARG: if configured width larger than maximum the slot can
- *              support
- */
-esp_err_t sdmmc_host_pullup_en(int slot, int width) __attribute__((deprecated));
-
 #ifdef __cplusplus
 }
 #endif
diff --git a/components/driver/include/driver/spi_master.h b/components/driver/include/driver/spi_master.h
index eaf391c821..3c599ae9e0 100644
--- a/components/driver/include/driver/spi_master.h
+++ b/components/driver/include/driver/spi_master.h
@@ -331,21 +331,6 @@ esp_err_t spi_device_acquire_bus(spi_device_handle_t device, TickType_t wait);
  */
 void spi_device_release_bus(spi_device_handle_t dev);
 
-
-/**
- * @brief Calculate the working frequency that is most close to desired frequency, and also the register value.
- *
- * @param fapb The frequency of apb clock, should be ``APB_CLK_FREQ``.
- * @param hz Desired working frequency
- * @param duty_cycle Duty cycle of the spi clock
- * @param reg_o Output of value to be set in clock register, or NULL if not needed.
- *
- * @deprecated The app shouldn't care about the register. Call ``spi_get_actual_clock`` instead.
- *
- * @return Actual working frequency that most fit.
- */
-int spi_cal_clock(int fapb, int hz, int duty_cycle, uint32_t *reg_o) __attribute__((deprecated));
-
 /**
  * @brief Calculate the working frequency that is most close to desired frequency.
  *
@@ -362,7 +347,7 @@ int spi_get_actual_clock(int fapb, int hz, int duty_cycle);
   *
   * @param gpio_is_used True if using GPIO matrix, or False if iomux pins are used.
   * @param input_delay_ns Input delay from SCLK launch edge to MISO data valid.
-  * @param eff_clk Effective clock frequency (in Hz) from spi_cal_clock.
+  * @param eff_clk Effective clock frequency (in Hz) from `spi_get_actual_clock()`.
   * @param dummy_o Address of dummy bits used output. Set to NULL if not needed.
   * @param cycles_remain_o Address of cycles remaining (after dummy bits are used) output.
   *         - -1 If too many cycles remaining, suggest to compensate half a clock.
diff --git a/components/driver/include/driver/uart.h b/components/driver/include/driver/uart.h
index 765f14cc4a..3e3a0dbe31 100644
--- a/components/driver/include/driver/uart.h
+++ b/components/driver/include/driver/uart.h
@@ -579,31 +579,6 @@ esp_err_t uart_get_buffered_data_len(uart_port_t uart_num, size_t* size);
  */
 esp_err_t uart_disable_pattern_det_intr(uart_port_t uart_num);
 
-#if CONFIG_IDF_TARGET_ESP32
-/**
- * @brief UART enable pattern detect function.
- *        Designed for applications like 'AT commands'.
- *        When the hardware detect a series of one same character, the interrupt will be triggered.
- * @note  This function only works for esp32. And this function is deprecated, please use
- *        uart_enable_pattern_det_baud_intr instead.
- *
- * @param uart_num UART port number.
- * @param pattern_chr character of the pattern.
- * @param chr_num number of the character, 8bit value.
- * @param chr_tout timeout of the interval between each pattern characters, 24bit value, unit is APB (80Mhz) clock cycle.
- *        When the duration is less than this value, it will not take this data as at_cmd char.
- * @param post_idle idle time after the last pattern character, 24bit value, unit is APB (80Mhz) clock cycle.
- *        When the duration is less than this value, it will not take the previous data as the last at_cmd char
- * @param pre_idle idle time before the first pattern character, 24bit value, unit is APB (80Mhz) clock cycle.
- *        When the duration is less than this value, it will not take this data as the first at_cmd char.
- *
- * @return
- *     - ESP_OK Success
- *     - ESP_FAIL Parameter error
- */
-esp_err_t uart_enable_pattern_det_intr(uart_port_t uart_num, char pattern_chr, uint8_t chr_num, int chr_tout, int post_idle, int pre_idle) __attribute__((deprecated));
-#endif
-
 /**
  * @brief UART enable pattern detect function.
  *        Designed for applications like 'AT commands'.
@@ -768,8 +743,7 @@ esp_err_t uart_get_collision_flag(uart_port_t uart_num, bool* collision_flag);
  * be obtained from UART FIFO). Depending on the baud rate, a few characters
  * after that will also not be received. Note that when the chip enters and exits
  * light sleep mode, APB frequency will be changing. To make sure that UART has
- * correct baud rate all the time, select REF_TICK as UART clock source,
- * by setting use_ref_tick field in uart_config_t to true.
+ * correct baud rate all the time, select UART_SCLK_REF_TICK or UART_SCLK_XTAL as UART clock source in uart_config_t::source_clk.
  *
  * @note in ESP32, the wakeup signal can only be input via IO_MUX (i.e.
  *       GPIO3 should be configured as function_1 to wake up UART0,
diff --git a/components/driver/mcpwm.c b/components/driver/mcpwm.c
index 9dcd904cd4..e780de19c9 100644
--- a/components/driver/mcpwm.c
+++ b/components/driver/mcpwm.c
@@ -761,47 +761,6 @@ static void MCPWM_ISR_ATTR mcpwm_default_isr_handler(void *arg) {
     }
 }
 
-esp_err_t mcpwm_capture_enable(mcpwm_unit_t mcpwm_num, mcpwm_capture_signal_t cap_sig, mcpwm_capture_on_edge_t cap_edge,
-                               uint32_t num_of_pulse)
-{
-    ESP_RETURN_ON_FALSE(mcpwm_num < SOC_MCPWM_GROUPS, ESP_ERR_INVALID_ARG, TAG, MCPWM_GROUP_NUM_ERROR);
-    ESP_RETURN_ON_FALSE(num_of_pulse <= MCPWM_LL_MAX_CAPTURE_PRESCALE, ESP_ERR_INVALID_ARG, TAG, MCPWM_PRESCALE_ERROR);
-    ESP_RETURN_ON_FALSE(cap_sig < SOC_MCPWM_CAPTURE_CHANNELS_PER_TIMER, ESP_ERR_INVALID_ARG, TAG, MCPWM_CAPTURE_ERROR);
-    mcpwm_hal_context_t *hal = &context[mcpwm_num].hal;
-    // enable MCPWM module incase user don't use `mcpwm_init` at all
-    periph_module_enable(mcpwm_periph_signals.groups[mcpwm_num].module);
-    mcpwm_hal_init_config_t init_config = {
-        .host_id = mcpwm_num,
-    };
-    mcpwm_critical_enter(mcpwm_num);
-    mcpwm_hal_init(hal, &init_config);
-    mcpwm_ll_group_set_clock_prescale(hal->dev, context[mcpwm_num].group_pre_scale);
-    mcpwm_ll_capture_enable_timer(hal->dev, true);
-    mcpwm_ll_capture_enable_channel(hal->dev, cap_sig, true);
-    mcpwm_ll_capture_enable_negedge(hal->dev, cap_sig, cap_edge & MCPWM_NEG_EDGE);
-    mcpwm_ll_capture_enable_posedge(hal->dev, cap_sig, cap_edge & MCPWM_POS_EDGE);
-    mcpwm_ll_capture_set_prescale(hal->dev, cap_sig, num_of_pulse + 1);
-    // capture feature should be used with interupt, so enable it by default
-    mcpwm_ll_intr_enable_capture(hal->dev, cap_sig, true);
-    mcpwm_ll_intr_clear_capture_status(hal->dev, 1 << cap_sig);
-    mcpwm_critical_exit(mcpwm_num);
-    return ESP_OK;
-}
-
-esp_err_t mcpwm_capture_disable(mcpwm_unit_t mcpwm_num, mcpwm_capture_signal_t cap_sig)
-{
-    ESP_RETURN_ON_FALSE(mcpwm_num < SOC_MCPWM_GROUPS, ESP_ERR_INVALID_ARG, TAG, MCPWM_GROUP_NUM_ERROR);
-    ESP_RETURN_ON_FALSE(cap_sig < SOC_MCPWM_CAPTURE_CHANNELS_PER_TIMER, ESP_ERR_INVALID_ARG, TAG, MCPWM_CAPTURE_ERROR);
-    mcpwm_hal_context_t *hal = &context[mcpwm_num].hal;
-
-    mcpwm_critical_enter(mcpwm_num);
-    mcpwm_ll_capture_enable_channel(hal->dev, cap_sig, false);
-    mcpwm_ll_intr_enable_capture(hal->dev, cap_sig, false);
-    mcpwm_critical_exit(mcpwm_num);
-    periph_module_disable(mcpwm_periph_signals.groups[mcpwm_num].module);
-    return ESP_OK;
-}
-
 esp_err_t mcpwm_capture_enable_channel(mcpwm_unit_t mcpwm_num, mcpwm_capture_channel_id_t cap_channel, const mcpwm_capture_config_t *cap_conf)
 {
     ESP_RETURN_ON_FALSE(mcpwm_num < SOC_MCPWM_GROUPS, ESP_ERR_INVALID_ARG, TAG, MCPWM_GROUP_NUM_ERROR);
@@ -897,29 +856,6 @@ uint32_t MCPWM_ISR_ATTR mcpwm_capture_signal_get_edge(mcpwm_unit_t mcpwm_num, mc
     return mcpwm_ll_capture_is_negedge(hal->dev, cap_sig) ? 2 : 1;
 }
 
-esp_err_t mcpwm_sync_enable(mcpwm_unit_t mcpwm_num, mcpwm_timer_t timer_num, mcpwm_sync_signal_t sync_sig,
-                            uint32_t phase_val)
-{
-    MCPWM_TIMER_CHECK(mcpwm_num, timer_num);
-    ESP_RETURN_ON_FALSE(sync_sig <= MCPWM_SELECT_GPIO_SYNC2, ESP_ERR_INVALID_ARG, TAG, "invalid sync_sig");
-    ESP_RETURN_ON_FALSE(phase_val < 1000, ESP_ERR_INVALID_ARG, TAG, "phase_val must within 0~999");
-    mcpwm_hal_context_t *hal = &context[mcpwm_num].hal;
-
-    mcpwm_critical_enter(mcpwm_num);
-    uint32_t set_phase = mcpwm_ll_timer_get_peak(hal->dev, timer_num, false) * phase_val / 1000;
-    mcpwm_ll_timer_set_sync_phase_value(hal->dev, timer_num, set_phase);
-    if (sync_sig == MCPWM_SELECT_NO_INPUT) {
-        mcpwm_ll_timer_set_soft_synchro(hal->dev, timer_num);
-    } else if (sync_sig <= MCPWM_SELECT_TIMER2_SYNC) {
-        mcpwm_ll_timer_set_timer_synchro(hal->dev, timer_num, sync_sig - MCPWM_SELECT_TIMER0_SYNC);
-    } else {
-        mcpwm_ll_timer_set_gpio_synchro(hal->dev, timer_num, sync_sig - MCPWM_SELECT_GPIO_SYNC0);
-    }
-    mcpwm_ll_timer_enable_sync_input(hal->dev, timer_num, true);
-    mcpwm_critical_exit(mcpwm_num);
-    return ESP_OK;
-}
-
 esp_err_t mcpwm_sync_configure(mcpwm_unit_t mcpwm_num, mcpwm_timer_t timer_num, const mcpwm_sync_config_t *sync_conf)
 {
     MCPWM_TIMER_CHECK(mcpwm_num, timer_num);
@@ -1003,12 +939,3 @@ esp_err_t mcpwm_set_timer_sync_output(mcpwm_unit_t mcpwm_num, mcpwm_timer_t time
     mcpwm_critical_exit(mcpwm_num);
     return ESP_OK;
 }
-
-esp_err_t mcpwm_isr_register(mcpwm_unit_t mcpwm_num, void (*fn)(void *), void *arg, int intr_alloc_flags, intr_handle_t *handle)
-{
-    esp_err_t ret;
-    ESP_RETURN_ON_FALSE(mcpwm_num < SOC_MCPWM_GROUPS, ESP_ERR_INVALID_ARG, TAG, MCPWM_GROUP_NUM_ERROR);
-    ESP_RETURN_ON_FALSE(fn, ESP_ERR_INVALID_ARG, TAG, MCPWM_PARAM_ADDR_ERROR);
-    ret = esp_intr_alloc(mcpwm_periph_signals.groups[mcpwm_num].irq_id, intr_alloc_flags, fn, arg, handle);
-    return ret;
-}
diff --git a/components/driver/sdmmc_host.c b/components/driver/sdmmc_host.c
index d2773518e4..1f2b281602 100644
--- a/components/driver/sdmmc_host.c
+++ b/components/driver/sdmmc_host.c
@@ -718,6 +718,3 @@ static esp_err_t sdmmc_host_pullup_en_internal(int slot, int width)
     }
     return ESP_OK;
 }
-
-/* Deprecared public function */
-esp_err_t sdmmc_host_pullup_en(int slot, int width) __attribute__((alias("sdmmc_host_pullup_en_internal")));
diff --git a/components/driver/spi_master.c b/components/driver/spi_master.c
index 456b051c2e..30d5a2fb5c 100644
--- a/components/driver/spi_master.c
+++ b/components/driver/spi_master.c
@@ -456,11 +456,6 @@ esp_err_t spi_bus_remove_device(spi_device_handle_t handle)
     return ESP_OK;
 }
 
-int spi_cal_clock(int fapb, int hz, int duty_cycle, uint32_t *reg_o)
-{
-    return spi_ll_master_cal_clock(fapb, hz, duty_cycle, reg_o);
-}
-
 int spi_get_actual_clock(int fapb, int hz, int duty_cycle)
 {
     return spi_hal_master_cal_clock(fapb, hz, duty_cycle);
diff --git a/components/hal/include/hal/i2c_types.h b/components/hal/include/hal/i2c_types.h
index fba0bc9c70..1864b696cc 100644
--- a/components/hal/include/hal/i2c_types.h
+++ b/components/hal/include/hal/i2c_types.h
@@ -76,16 +76,6 @@ typedef enum {
 /// Use the highest speed that is available for the clock source picked by clk_flags
 #define I2C_CLK_FREQ_MAX                  (-1)
 
-#if CONFIG_IDF_TARGET_ESP32
-typedef enum{
-    I2C_CMD_RESTART = 0,   /*!<I2C restart command */
-    I2C_CMD_WRITE,         /*!<I2C write command */
-    I2C_CMD_READ,          /*!<I2C read command */
-    I2C_CMD_STOP,          /*!<I2C stop command */
-    I2C_CMD_END            /*!<I2C end command */
-} i2c_opmode_t __attribute__((deprecated));
-#endif
-
 #ifdef __cplusplus
 }
 #endif
diff --git a/components/hal/include/hal/uart_types.h b/components/hal/include/hal/uart_types.h
index 8a22673bcc..6062d4355a 100644
--- a/components/hal/include/hal/uart_types.h
+++ b/components/hal/include/hal/uart_types.h
@@ -124,10 +124,7 @@ typedef struct {
     uart_stop_bits_t stop_bits;         /*!< UART stop bits*/
     uart_hw_flowcontrol_t flow_ctrl;    /*!< UART HW flow control mode (cts/rts)*/
     uint8_t rx_flow_ctrl_thresh;        /*!< UART HW RTS threshold*/
-    union {
-        uart_sclk_t source_clk;         /*!< UART source clock selection */
-        bool use_ref_tick  __attribute__((deprecated)); /*!< Deprecated method to select ref tick clock source, set source_clk field instead */
-    };
+    uart_sclk_t source_clk;             /*!< UART source clock selection */
 } uart_config_t;
 
 #ifdef __cplusplus
diff --git a/docs/en/api-reference/system/power_management.rst b/docs/en/api-reference/system/power_management.rst
index d13e0f480d..1f2f704764 100644
--- a/docs/en/api-reference/system/power_management.rst
+++ b/docs/en/api-reference/system/power_management.rst
@@ -100,7 +100,7 @@ When DFS is enabled, the APB frequency can be changed multiple times within a si
 
 The following peripherals work normally even when the APB frequency is changing:
 
-- **UART**: if REF_TICK is used as a clock source. See cpp:member:`uart_config_t::use_ref_tick`.
+- **UART**: if REF_TICK or XTAL is used as a clock source. See :cpp:member:`uart_config_t::source_clk`.
 - **LEDC**: if REF_TICK is used as a clock source. See :cpp:func:`ledc_timer_config` function.
 - **RMT**: if REF_TICK or XTAL is used as a clock source. See :cpp:member:`rmt_config_t::flags` and macro `RMT_CHANNEL_FLAGS_AWARE_DFS`.
 - **GPTimer**: if APB is used as the clock source. See :cpp:member:`gptimer_config_t::clk_src`.
diff --git a/docs/en/migration-guides/peripherals.rst b/docs/en/migration-guides/peripherals.rst
index 4d039c49a2..19230105db 100644
--- a/docs/en/migration-guides/peripherals.rst
+++ b/docs/en/migration-guides/peripherals.rst
@@ -75,12 +75,60 @@ Breaking Changes in Usage
 UART
 ----
 
-- ``uart_isr_register`` and ``uart_isr_free`` have been removed as the UART interrupt handling is closely related to the driver implementation.
++-----------------------------------------------+-----------------------------------------------+----------------------------------------------------------+
+| Removed/Deprecated items                      | Replacement                                   | Remarks                                                  |
++===============================================+===============================================+==========================================================+
+| ``uart_isr_register()``                       | None                                          | UART interrupt handling is implemented by driver itself. |
++-----------------------------------------------+-----------------------------------------------+----------------------------------------------------------+
+| ``uart_isr_free()``                           | None                                          | UART interrupt handling is implemented by driver itself. |
++-----------------------------------------------+-----------------------------------------------+----------------------------------------------------------+
+| ``use_ref_tick`` in :cpp:type:`uart_config_t` | :cpp:member:`uart_config_t::source_clk`       | Select the clock source.                                 |
++-----------------------------------------------+-----------------------------------------------+----------------------------------------------------------+
+| ``uart_enable_pattern_det_intr()``            | :cpp:func:`uart_enable_pattern_det_baud_intr` | Enable pattern detection interrupt.                      |
++-----------------------------------------------+-----------------------------------------------+----------------------------------------------------------+
 
 I2C
 ---
 
-- ``i2c_isr_register`` and ``i2c_isr_free`` have been removed as the I2C interrupt handling is closely related to the driver implementation.
++--------------------------+-------------+---------------------------------------------------------+
+| Removed/Deprecated items | Replacement | Remarks                                                 |
++==========================+=============+=========================================================+
+| ``i2c_isr_register()``   | None        | I2C interrupt handling is implemented by driver itself. |
++--------------------------+-------------+---------------------------------------------------------+
+| ``i2c_isr_register()``   | None        | I2C interrupt handling is implemented by driver itself. |
++--------------------------+-------------+---------------------------------------------------------+
+| ``i2c_opmode_t``         | None        | It's not used anywhere in esp-idf.                      |
++--------------------------+-------------+---------------------------------------------------------+
+
+SPI
+---
+
++--------------------------+----------------------------------+---------------------------------+
+| Removed/Deprecated items | Replacement                      | Remarks                         |
++==========================+==================================+=================================+
+| ``spi_cal_clock()``      | :cpp:func:`spi_get_actual_clock` | Get SPI real working frequency. |
++--------------------------+----------------------------------+---------------------------------+
+
+.. only:: SOC_SDMMC_HOST_SUPPORTED
+
+    SDMMC
+    -----
+
+    +----------------------------+----------------------------------------------+--------------------------+
+    | Removed/Deprecated items   | Replacement                                  | Remarks                  |
+    +============================+==============================================+==========================+
+    | ``sdmmc_host_pullup_en()`` | set ``SDMMC_SLOT_FLAG_INTERNAL_PULLUP`` flag | Enable internal pull up. |
+    |                            | in :cpp:member:`sdmmc_slot_config_t::flags`  |                          |
+    +----------------------------+----------------------------------------------+--------------------------+
+
+LEDC
+-----
+
++------------------------------------------------+----------------------------------------------------+-----------------------------------+
+| Removed/Deprecated items                       | Replacement                                        | Remarks                           |
++================================================+====================================================+===================================+
+| ``bit_num`` in :cpp:type:`ledc_timer_config_t` | :cpp:member:`ledc_timer_config_t::duty_resolution` | Set resolution of the duty cycle. |
++------------------------------------------------+----------------------------------------------------+-----------------------------------+
 
 .. only:: SOC_PCNT_SUPPORTED
 
@@ -189,3 +237,21 @@ LCD
 
 - The LCD panel initialization flow is slightly changed. Now the :cpp:func:`esp_lcd_panel_init` won't turn on the display automatically. User needs to call :cpp:func:`esp_lcd_panel_disp_on_off` to manually turn on the display. Note, this is different from turning on backlight. With this breaking change, user can flush a predefined pattern to the screen before turning on the screen. This can help avoid random noise on the screen after a power on reset.
 - :cpp:func:`esp_lcd_panel_disp_off` is deprecated, please use :cpp:func:`esp_lcd_panel_disp_on_off` instead.
+
+.. only:: SOC_MCPWM_SUPPORTED
+
+    MCPWM
+    -----
+
+    +---------------------------+---------------------------------------------------+-----------------------------------------------------------+
+    | Removed/Deprecated items  | Replacement                                       | Remarks                                                   |
+    +===========================+===================================================+===========================================================+
+    | ``mcpwm_capture_enable``  | :cpp:func:`mcpwm_capture_enable_channel`          | Enable capture channel.                                   |
+    +---------------------------+---------------------------------------------------+-----------------------------------------------------------+
+    | ``mcpwm_capture_disable`` | :cpp:func:`mcpwm_capture_capture_disable_channel` | Disable capture channel.                                  |
+    +---------------------------+---------------------------------------------------+-----------------------------------------------------------+
+    | ``mcpwm_sync_enable``     | :cpp:func:`mcpwm_sync_configure`                  | Configure synchronization.                                |
+    +---------------------------+---------------------------------------------------+-----------------------------------------------------------+
+    | ``mcpwm_isr_register``    | By registering event callbacks, e.g.              | MCPWM interrupt handling is implemented by driver itself. |
+    |                           | :cpp:member:`mcpwm_capture_config_t::capture_cb`  |                                                           |
+    +---------------------------+---------------------------------------------------+-----------------------------------------------------------+
diff --git a/docs/zh_CN/api-reference/system/power_management.rst b/docs/zh_CN/api-reference/system/power_management.rst
index edaca5104d..0c38ed5a45 100644
--- a/docs/zh_CN/api-reference/system/power_management.rst
+++ b/docs/zh_CN/api-reference/system/power_management.rst
@@ -100,7 +100,7 @@ ESP-IDF 中集成的电源管理算法可以根据应用程序组件的需求，
 
 以下外设不受 APB 频率变更的影响：
 
-- **UART**：如果 REF_TICK 用作时钟源，则 UART 不受 APB 频率变更影响。请查看 :cpp:member:`uart_config_t::use_ref_tick`。
+- **UART**：如果 REF_TICK 或者 XTAL 用作时钟源，则 UART 不受 APB 频率变更影响。请查看 :cpp:member:`uart_config_t::source_clk`。
 - **LEDC**：如果 REF_TICK 用作时钟源，则 LEDC 不受 APB 频率变更影响。请查看 :cpp:func:`ledc_timer_config` 函数。
 - **RMT**：如果 REF_TICK 或者 XTAL 被用作时钟源，则 RMT 不受 APB 频率变更影响。请查看 :cpp:member:`rmt_config_t::flags` 以及 `RMT_CHANNEL_FLAGS_AWARE_DFS` 宏。
 - **GPTimer**：如果 XTAL 用作时钟源，则 GPTimer 不受 APB 频率变更影响。请查看 :cpp:member:`gptimer_config_t::clk_src`。