Merge branch 'feat/i2c_slave_v2_v5.4' into 'release/v5.4'

feat(i2c_slave): Add new i2c slave driver --version two with great stretch handling (backport v5.4)

See merge request espressif/esp-idf!34907

Author: suda-morris

components/esp_driver_i2c/CMakeLists.txt

@@ -10,7 +10,11 @@ if(CONFIG_SOC_I2C_SUPPORTED)
                      "i2c_common.c"
         )
     if(CONFIG_SOC_I2C_SUPPORT_SLAVE)
-        list(APPEND srcs "i2c_slave.c")
+        if(CONFIG_I2C_ENABLE_SLAVE_DRIVER_VERSION_2)
+            list(APPEND srcs "i2c_slave_v2.c")
+        else()
+            list(APPEND srcs "i2c_slave.c")
+        endif()
     endif()
 
 endif()

components/esp_driver_i2c/Kconfig

@@ -17,4 +17,10 @@ menu "ESP-Driver:I2C Configurations"
 
             note: This cannot be used in the I2C legacy driver.
 
+    config I2C_ENABLE_SLAVE_DRIVER_VERSION_2
+        bool "Enable I2C slave driver version 2"
+        default n
+        help
+            I2C slave version 2 solves some existing known issues. Such as write/read workflow, stretch handling, etc.
+
 endmenu # I2C Configurations

components/esp_driver_i2c/i2c_private.h

@@ -19,6 +19,7 @@
 #include "driver/i2c_slave.h"
 #include "esp_private/periph_ctrl.h"
 #include "esp_pm.h"
+#include "sdkconfig.h"
 
 #ifdef __cplusplus
 extern "C" {
@@ -196,6 +197,8 @@ typedef struct {
     uint32_t rcv_fifo_cnt;      // receive fifo count.
 } i2c_slave_receive_t;
 
+#if !CONFIG_I2C_ENABLE_SLAVE_DRIVER_VERSION_2
+
 struct i2c_slave_dev_t {
     i2c_bus_t *base;                            // bus base class
     SemaphoreHandle_t slv_rx_mux;               // Mutex for slave rx direction
@@ -213,6 +216,22 @@ struct i2c_slave_dev_t {
     uint32_t already_receive_len;               // Data length already received in ISR.
 };
 
+#else // CONFIG_I2C_ENABLE_SLAVE_DRIVER_VERSION_2
+
+struct i2c_slave_dev_t {
+    i2c_bus_t *base;                                  // bus base class
+    SemaphoreHandle_t operation_mux;                  // Mux for i2c slave operation
+    i2c_slave_request_callback_t request_callback;    // i2c slave request callback
+    i2c_slave_received_callback_t receive_callback;   // i2c_slave receive callback
+    void *user_ctx;                                   // Callback user context
+    RingbufHandle_t rx_ring_buf;                      // receive ringbuffer
+    RingbufHandle_t tx_ring_buf;                      // transmit ringbuffer
+    uint32_t rx_data_count;                           // receive data count
+    i2c_slave_receive_t receive_desc;                 // slave receive descriptor
+};
+
+#endif // CONFIG_I2C_ENABLE_SLAVE_DRIVER_VERSION_2
+
 /**
  * @brief Acquire I2C bus handle
  *