Update IDF

tools/sdk/include/driver/driver/ledc.h

@@ -29,8 +29,7 @@ extern "C" {
 
 typedef enum {
     LEDC_HIGH_SPEED_MODE = 0, /*!< LEDC high speed speed_mode */
-    //in this version, we only support high speed speed_mode. We will access low speed speed_mode later
-    //LEDC_LOW_SPEED_MODE,    /*!< LEDC low speed speed_mode */
+    LEDC_LOW_SPEED_MODE,    /*!< LEDC low speed speed_mode */
     LEDC_SPEED_MODE_MAX,      /*!< LEDC speed limit */
 } ledc_mode_t;
 
@@ -137,8 +136,6 @@ esp_err_t ledc_timer_config(ledc_timer_config_t* timer_conf);
  *        After ledc_set_duty, ledc_set_fade, we need to call this function to update the settings.
  *
  * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode,
- *        now we only support high-speed mode.
- *        We will access low-speed mode in next version
  * @param channel LEDC channel(0-7), select from ledc_channel_t
  *
  * @return
@@ -152,7 +149,7 @@ esp_err_t ledc_update_duty(ledc_mode_t speed_mode, ledc_channel_t channel);
  * @brief LEDC stop.
  *        Disable LEDC output, and set idle level
  *
- * @param  speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, now we only support high-speed mode. We will access low-speed mode in next version
+ * @param  speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode
  * @param  channel LEDC channel(0-7), select from ledc_channel_t
  * @param  idle_level Set output idle level after LEDC stops.
  *
@@ -165,7 +162,7 @@ esp_err_t ledc_stop(ledc_mode_t speed_mode, ledc_channel_t channel, uint32_t idl
 /**
  * @brief LEDC set channel frequency(Hz)
  *
- * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, now we only support high-speed mode. We will access low-speed mode in next version
+ * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode
  * @param  timer_num LEDC timer index(0-3), select from ledc_timer_t
  * @param  freq_hz Set the LEDC frequency
  *
@@ -179,7 +176,7 @@ esp_err_t ledc_set_freq(ledc_mode_t speed_mode, ledc_timer_t timer_num, uint32_t
 /**
  * @brief      LEDC get channel frequency(Hz)
  *
- * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, now we only support high-speed mode. We will access low-speed mode in next version
+ * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode
  * @param timer_num LEDC timer index(0-3), select from ledc_timer_t
  *
  * @return
@@ -192,7 +189,7 @@ uint32_t ledc_get_freq(ledc_mode_t speed_mode, ledc_timer_t timer_num);
  * @brief LEDC set duty
  *        Only after calling ledc_update_duty will the duty update.
  *
- * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, now we only support high-speed mode. We will access low-speed mode in next version
+ * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode
  * @param channel LEDC channel(0-7), select from ledc_channel_t
  * @param duty Set the LEDC duty, the duty range is [0, (2**bit_num) - 1]
  *
@@ -205,7 +202,7 @@ esp_err_t ledc_set_duty(ledc_mode_t speed_mode, ledc_channel_t channel, uint32_t
 /**
  * @brief LEDC get duty
  *
- * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, now we only support high-speed mode. We will access low-speed mode in next version
+ * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode
  * @param channel LEDC channel(0-7), select from ledc_channel_t
  *
  * @return
@@ -218,7 +215,7 @@ int ledc_get_duty(ledc_mode_t speed_mode, ledc_channel_t channel);
  * @brief LEDC set gradient
  *        Set LEDC gradient, After the function calls the ledc_update_duty function, the function can take effect.
  *
- * @param  speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, now we only support high-speed mode. We will access low-speed mode in next version
+ * @param  speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode
  * @param  channel LEDC channel(0-7), select from ledc_channel_t
  * @param  duty Set the start of the gradient duty, the duty range is [0, (2**bit_num) - 1]
  * @param  gradule_direction Set the direction of the gradient
@@ -254,7 +251,7 @@ esp_err_t ledc_isr_register(void (*fn)(void*), void * arg, int intr_alloc_flags,
 /**
  * @brief Configure LEDC settings
  *
- * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, now we only support high-speed mode. We will access low-speed mode in next version
+ * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode
  * @param timer_sel  Timer index(0-3), there are 4 timers in LEDC module
  * @param div_num Timer clock divide number, the timer clock is divided from the selected clock source
  * @param bit_num The count number of one period, counter range is 0 ~ ((2 ** bit_num) - 1)
@@ -269,7 +266,7 @@ esp_err_t ledc_timer_set(ledc_mode_t speed_mode, ledc_timer_t timer_sel, uint32_
 /**
  * @brief Reset LEDC timer
  *
- * @param  speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, now we only support high-speed mode. We will access low-speed mode in next version
+ * @param  speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode
  * @param  timer_sel LEDC timer index(0-3), select from ledc_timer_t
  *
  * @return
@@ -281,7 +278,7 @@ esp_err_t ledc_timer_rst(ledc_mode_t speed_mode, uint32_t timer_sel);
 /**
  * @brief Pause LEDC timer counter
  *
- * @param  speed_mode  Select the LEDC speed_mode, high-speed mode and low-speed mode, now we only support high-speed mode. We will access low-speed mode in next version
+ * @param  speed_mode  Select the LEDC speed_mode, high-speed mode and low-speed mode
  * @param  timer_sel LEDC timer index(0-3), select from ledc_timer_t
  *
  * @return
@@ -294,7 +291,7 @@ esp_err_t ledc_timer_pause(ledc_mode_t speed_mode, uint32_t timer_sel);
 /**
  * @brief Resume LEDC timer
  *
- * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, now we only support high-speed mode. We will access low-speed mode in next version
+ * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode
  * @param timer_sel LEDC timer index(0-3), select from ledc_timer_t
  *
  * @return
@@ -306,7 +303,7 @@ esp_err_t ledc_timer_resume(ledc_mode_t speed_mode, uint32_t timer_sel);
 /**
  * @brief Bind LEDC channel with the selected timer
  *
- * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode, now we only support high-speed mode. We will access low-speed mode in next version
+ * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode
  * @param channel LEDC channel index(0-7), select from ledc_channel_t
  * @param timer_idx LEDC timer index(0-3), select from ledc_timer_t
  *
@@ -321,7 +318,6 @@ esp_err_t ledc_bind_channel_timer(ledc_mode_t speed_mode, uint32_t channel, uint
  *        Call ledc_fade_start() after this to start fading.
  *
  * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode,
- *                   For now we only support high-speed mode. We will access low-speed mode soon.
  * @param channel LEDC channel index(0-7), select from ledc_channel_t
  * @param target_duty Target duty of fading.( 0 - (2 ** bit_num - 1)))
  * @param scale Controls the increase or decrease step scale.
@@ -331,6 +327,7 @@ esp_err_t ledc_bind_channel_timer(ledc_mode_t speed_mode, uint32_t channel, uint
  *     - ESP_ERR_INVALID_ARG Parameter error
  *     - ESP_OK Success
  *     - ESP_ERR_INVALID_STATE Fade function not installed.
+ *     - ESP_FAIL Fade function init error
  */
 esp_err_t ledc_set_fade_with_step(ledc_mode_t speed_mode, ledc_channel_t channel, int target_duty, int scale, int cycle_num);
 
@@ -339,7 +336,6 @@ esp_err_t ledc_set_fade_with_step(ledc_mode_t speed_mode, ledc_channel_t channel
  *        Call ledc_fade_start() after this to start fading.
  *
  * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode,
- *                   For now we only support high-speed mode. We will access low-speed mode soon.
  * @param channel LEDC channel index(0-7), select from ledc_channel_t
  * @param target_duty Target duty of fading.( 0 - (2 ** bit_num - 1)))
  * @param max_fade_time_ms The maximum time of the fading ( ms ).
@@ -348,6 +344,7 @@ esp_err_t ledc_set_fade_with_step(ledc_mode_t speed_mode, ledc_channel_t channel
  *     - ESP_ERR_INVALID_ARG Parameter error
  *     - ESP_OK Success
  *     - ESP_ERR_INVALID_STATE Fade function not installed.
+ *     - ESP_FAIL Fade function init error
  */
 esp_err_t ledc_set_fade_with_time(ledc_mode_t speed_mode, ledc_channel_t channel, int target_duty, int max_fade_time_ms);
 
@@ -358,7 +355,6 @@ esp_err_t ledc_set_fade_with_time(ledc_mode_t speed_mode, ledc_channel_t channel
  *        ESP_INTR_FLAG_* values. See esp_intr_alloc.h for more info.
  *
  * @return
- *     - ESP_ERR_NO_MEM No enough memory
  *     - ESP_OK Success
  *     - ESP_ERR_INVALID_STATE Fade function already installed.
  */
@@ -373,6 +369,7 @@ void ledc_fade_func_uninstall();
 /**
  * @brief Start LEDC fading.
  *
+ * @param speed_mode Select the LEDC speed_mode, high-speed mode and low-speed mode
  * @param channel LEDC channel number
  * @param wait_done Whether to block until fading done.
  *
@@ -381,7 +378,7 @@ void ledc_fade_func_uninstall();
  *     - ESP_ERR_INVALID_STATE Fade function not installed.
  *     - ESP_ERR_INVALID_ARG Parameter error.
  */
-esp_err_t ledc_fade_start(ledc_channel_t channel, ledc_fade_mode_t wait_done);
+esp_err_t ledc_fade_start(ledc_mode_t speed_mode, ledc_channel_t channel, ledc_fade_mode_t wait_done);
 
 #ifdef __cplusplus
 }

tools/sdk/include/driver/driver/rmt.h

@@ -619,22 +619,17 @@ esp_err_t rmt_fill_tx_items(rmt_channel_t channel, rmt_item32_t* item, uint16_t
  *
  * @param channel RMT channel (0 - 7)
  *
- * @param rx_buf_size Size of RMT RX ringbuffer.
+ * @param rx_buf_size Size of RMT RX ringbuffer. Can be 0 if the RX ringbuffer is not used.
  *
- *        @note
- *        If we do not need RX ringbuffer, just set rx_buf_size to 0.
- *
- *        @note
- *        When we call rmt_driver_install function, it will register a driver ISR handler,
- *        DO NOT REGISTER ISR HANDLER AGAIN.
- *
- * @param rmt_intr_num RMT interrupt number.
+ * @param intr_alloc_flags Flags for the RMT driver interrupt handler. Pass 0 for default flags. See esp_intr_alloc.h for details.
  *
  * @return
+ *     - ESP_ERR_INVALID_STATE Driver is already installed, call rmt_driver_uninstall first.
+ *     - ESP_ERR_NO_MEM Memory allocation failure
  *     - ESP_ERR_INVALID_ARG Parameter error
  *     - ESP_OK Success
  */
-esp_err_t rmt_driver_install(rmt_channel_t channel, size_t rx_buf_size, int rmt_intr_num);
+esp_err_t rmt_driver_install(rmt_channel_t channel, size_t rx_buf_size, int intr_alloc_flags);
 
 /**
  * @brief Uninstall RMT driver.

tools/sdk/include/driver/driver/rtc_io.h

@@ -38,7 +38,8 @@ typedef struct {
     uint32_t pulldown;  /*!< Mask of pulldown enable */
     uint32_t slpsel;    /*!< If slpsel bit is set, slpie will be used as pad input enabled signal in sleep mode */
     uint32_t slpie;     /*!< Mask of input enable in sleep mode */
-    uint32_t hold;      /*!< Mask of hold_force bit for RTC IO in RTC_CNTL_HOLD_FORCE_REG */
+    uint32_t hold;      /*!< Mask of hold enable */
+    uint32_t hold_force;/*!< Mask of hold_force bit for RTC IO in RTC_CNTL_HOLD_FORCE_REG */
     int rtc_num;        /*!< RTC IO number, or -1 if not an RTC GPIO */
 } rtc_gpio_desc_t;
 
@@ -192,15 +193,44 @@ esp_err_t rtc_gpio_pullup_dis(gpio_num_t gpio_num);
 esp_err_t rtc_gpio_pulldown_dis(gpio_num_t gpio_num);
 
 /**
- * @brief Disable "hold" signal for all RTC IOs
+ * @brief Enable hold function on an RTC IO pad
  *
- * Each RTC pad has a "hold" input signal from the RTC controller.
- * If hold signal is set, pad latches current values of input enable,
+ * Enabling HOLD function will cause the pad to latch current values of
+ * input enable, output enable, output value, function, drive strength values.
+ * This function is useful when going into light or deep sleep mode to prevent
+ * the pin configuration from changing.
+ *
+ * @param gpio_num GPIO number (e.g. GPIO_NUM_12)
+ * @return
+ *     - ESP_OK Success
+ *     - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
+ */
+esp_err_t rtc_gpio_hold_en(gpio_num_t gpio_num);
+
+/**
+ * @brief Disable hold function on an RTC IO pad
+ *
+ * Disabling hold function will allow the pad receive the values of
+ * input enable, output enable, output value, function, drive strength from
+ * RTC_IO peripheral.
+ *
+ * @param gpio_num GPIO number (e.g. GPIO_NUM_12)
+ * @return
+ *     - ESP_OK Success
+ *     - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
+ */
+esp_err_t rtc_gpio_hold_dis(gpio_num_t gpio_num);
+
+/**
+ * @brief Disable force hold signal for all RTC IOs
+ *
+ * Each RTC pad has a "force hold" input signal from the RTC controller.
+ * If this signal is set, pad latches current values of input enable,
  * function, output enable, and other signals which come from the RTC mux.
- * Hold signal is enabled before going into deep sleep for pins which
+ * Force hold signal is enabled before going into deep sleep for pins which
  * are used for EXT1 wakeup.
  */
-void rtc_gpio_unhold_all();
+void rtc_gpio_force_hold_dis_all();
 
 
 #ifdef __cplusplus

tools/sdk/include/driver/driver/spi_master.h

@@ -153,6 +153,9 @@ esp_err_t spi_bus_free(spi_host_device_t host);
  * peripheral and routes it to the indicated GPIO. All SPI master devices have three CS pins and can thus control
  * up to three devices.
  *
+ * @note While in general, speeds up to 80MHz on the dedicated SPI pins and 40MHz on GPIO-matrix-routed pins are
+ *       supported, full-duplex transfers routed over the GPIO matrix only support speeds up to 26MHz.
+ *
  * @param host SPI peripheral to allocate device on
  * @param dev_config SPI interface protocol config for the device
  * @param handle Pointer to variable to hold the device handle

tools/sdk/include/driver/driver/touch_pad.h

@@ -43,10 +43,21 @@ typedef intr_handle_t touch_isr_handle_t;
  *
  *This function int touch pad module ,enable touch module
  *
- * @return    None
+ * @return
+ *     - ESP_OK Success
+ *     - ESP_FAIL Touch pad init error
  *
  */
-void touch_pad_init();
+esp_err_t touch_pad_init();
+
+/**
+ * @brief Uninstall TouchPad driver.
+ *
+ * @return
+ *     - ESP_OK   Success
+ *     - ESP_FAIL Touch pad deinit error
+ */
+esp_err_t touch_pad_deinit();
 
 /**
  * @brief       Configure touch pad interrupt threshold.
@@ -60,6 +71,7 @@ void touch_pad_init();
  *
  * @return    - ESP_OK Success
  *            - ESP_ERR_INVALID_ARG Touch pad error
+ *            - ESP_FAIL Touch pad not initialized
  *
  */
 esp_err_t touch_pad_config(touch_pad_t touch_num, uint16_t threshold);
@@ -76,6 +88,7 @@ esp_err_t touch_pad_config(touch_pad_t touch_num, uint16_t threshold);
  *
  *  @return   - ESP_OK Success
  *            - ESP_ERR_INVALID_ARG Touch pad error
+ *            - ESP_FAIL Touch pad not initialized
  *
  */
 esp_err_t touch_pad_read(touch_pad_t touch_num, uint16_t * touch_value);