feat: migrate i2cdev to new ESP-IDF I2C master driver API

- Replace legacy command-based I2C with handle-based master API
- Add device handle tracking and automatic resource cleanup
- Enhance addressing support (7-bit/10-bit) and error handling
- Implement smart retry logic with exponential backoff
- Add buffer overflow protection and memory optimization
- Maintain backward compatibility via i2cdev_legacy.c bridge
- Preserve existing sensor driver API compatibility
potentialy fixes #667 #713 #741

Author: quinkq

components/i2cdev/.eil.yml

@@ -1,7 +1,6 @@
----
 name: i2cdev
 description: ESP-IDF I2C master thread-safe utilities
-version: 1.5.0
+version: 2.0.0
 groups:
   - common
 code_owners:
@@ -26,4 +25,4 @@ targets:
 license: MIT
 copyrights:
   - name: UncleRus
-    year: 2018
+    year: 2018

components/i2cdev/CMakeLists.txt

@@ -1,11 +1,37 @@
-if(${IDF_TARGET} STREQUAL esp8266)
-    set(req esp8266 freertos esp_idf_lib_helpers)
+# ESP-IDF CMake component for i2cdev library
+set(req driver freertos esp_idf_lib_helpers)
+
+# ESP-IDF version detection for automatic driver selection
+# Check for manual override via Kconfig
+if(CONFIG_I2CDEV_USE_LEGACY_DRIVER)
+    set(USE_LEGACY_DRIVER TRUE)
+    message(STATUS "i2cdev: Manual override - using legacy driver (CONFIG_I2CDEV_USE_LEGACY_DRIVER=y)")
+elseif(NOT DEFINED IDF_VERSION_MAJOR)
+    # In case older ESP-IDF versions that don't define IDF_VERSION_MAJOR
+    set(USE_LEGACY_DRIVER TRUE)
+    message(STATUS "i2cdev: IDF_VERSION_MAJOR not defined, using legacy driver")
+elseif(IDF_VERSION_MAJOR LESS 5)
+    set(USE_LEGACY_DRIVER TRUE)
+    message(STATUS "i2cdev: ESP-IDF v${IDF_VERSION_MAJOR}.x detected, using legacy driver")
+elseif(IDF_VERSION_MAJOR EQUAL 5 AND IDF_VERSION_MINOR LESS 3)
+    set(USE_LEGACY_DRIVER TRUE) 
+    message(STATUS "i2cdev: ESP-IDF v${IDF_VERSION_MAJOR}.${IDF_VERSION_MINOR} detected, using legacy driver")
 else()
-    set(req driver freertos esp_idf_lib_helpers)
+    set(USE_LEGACY_DRIVER FALSE)
+    message(STATUS "i2cdev: ESP-IDF v${IDF_VERSION_MAJOR}.${IDF_VERSION_MINOR} detected, using new i2c_master driver")
 endif()
 
-idf_component_register(
-    SRCS i2cdev.c
-    INCLUDE_DIRS .
-    REQUIRES ${req}
-)
+# Conditionally set the source file based on version detection or Kconfig override
+if(USE_LEGACY_DRIVER)
+    set(SRCS "i2cdev_legacy.c")
+    message(STATUS "i2cdev: Compiling with legacy I2C driver (i2cdev_legacy.c)")
+else()
+    set(SRCS "i2cdev.c")
+    message(STATUS "i2cdev: Compiling with new I2C master driver (i2cdev.c)")
+endif()
+
+# Register the component
+idf_component_register(SRCS ${SRCS}
+                       INCLUDE_DIRS "."
+                       REQUIRES ${req})
+

components/i2cdev/Kconfig

@@ -1,5 +1,34 @@
 menu "I2C"
 
+config I2CDEV_USE_LEGACY_DRIVER
+	bool "Use Legacy I2C Driver API"
+	default n
+	help
+		Select this option to use the older ESP-IDF I2C driver API (driver/i2c.h)
+		instead of the newer driver API (driver/i2c_master.h).
+		
+		This is automatically determined by the build system based on your ESP-IDF version.
+		For ESP-IDF versions prior to v5.3, the legacy driver will be used automatically.
+		You can manually override this setting if needed.
+
+config I2CDEV_DEFAULT_SDA_PIN
+	int "Default I2C SDA pin"
+	default 21
+	help
+		Default SDA pin for I2C devices.
+
+config I2CDEV_DEFAULT_SCL_PIN
+	int "Default I2C SCL pin"
+	default 22
+	help
+		Default SCL pin for I2C devices.
+
+config I2CDEV_MAX_DEVICES_PER_PORT
+	int "Maximum number of devices per I2C port"
+	default 8
+	help
+		Maximum number of devices that can be registered on a single I2C port.
+
 config I2CDEV_TIMEOUT
     int "I2C transaction timeout, milliseconds"
     default 1000
@@ -13,5 +42,5 @@ config I2CDEV_NOLOCK
 		drivers will become non-thread safe. 
 		Use this option if you need to access your I2C devices
 		from interrupt handlers. 
-    
+
 endmenu

components/i2cdev/component.mk

@@ -2,6 +2,28 @@ COMPONENT_ADD_INCLUDEDIRS = .
 
 ifdef CONFIG_IDF_TARGET_ESP8266
 COMPONENT_DEPENDS = esp8266 freertos esp_idf_lib_helpers
+# ESP8266 RTOS SDK auto-detects all .c files, so use COMPONENT_OBJS to override
+# This prevents both i2cdev.c and i2cdev_legacy.c from being compiled
+COMPONENT_OBJS := i2cdev_legacy.o
+COMPONENT_SRCDIRS := .
 else
 COMPONENT_DEPENDS = driver freertos esp_idf_lib_helpers
+# For ESP32 family, check for manual override first
+ifdef CONFIG_I2CDEV_USE_LEGACY_DRIVER
+COMPONENT_SRCS = i2cdev_legacy.c
+else
+# Check if version variables are available, fallback to legacy if not
+ifdef IDF_VERSION_MAJOR
+ifeq ($(shell test $(IDF_VERSION_MAJOR) -lt 5 && echo 1),1)
+COMPONENT_SRCS = i2cdev_legacy.c
+else ifeq ($(shell test $(IDF_VERSION_MAJOR) -eq 5 -a $(IDF_VERSION_MINOR) -lt 3 && echo 1),1)
+COMPONENT_SRCS = i2cdev_legacy.c
+else
+COMPONENT_SRCS = i2cdev.c
+endif
+else
+# Version variables not available - fallback to legacy driver for safety
+COMPONENT_SRCS = i2cdev_legacy.c
+endif
+endif
 endif