Merge branch 'feat/i2c_bus_support_soft_i2c' into 'master'

feat(i2c_bus): support software i2c

Closes AEGHB-955

See merge request ae_group/esp-iot-solution!1207

Author: YanKE01

.gitlab/ci/rules.yml

@@ -1081,6 +1081,8 @@
       changes: *patterns-components_motor_esp_simplefoc
     - <<: *if-dev-push
       changes: *patterns-example_motor_foc_openloop_control
+    - <<: *if-dev-push
+      changes: *patterns-components_i2c_bus
 
 .rules:build:example_motor_foc_velocity_control:
   rules:
@@ -2056,6 +2058,8 @@
       changes: *patterns-build_system
     - <<: *if-dev-push
       changes: *patterns-components_sensors_gesture_apds9960
+    - <<: *if-dev-push
+      changes: *patterns-components_i2c_bus
 
 .rules:build:components_sensors_humiture_hdc2010_test_apps:
   rules:
@@ -2067,6 +2071,8 @@
       changes: *patterns-build_system
     - <<: *if-dev-push
       changes: *patterns-components_sensors_humiture_hdc2010
+    - <<: *if-dev-push
+      changes: *patterns-components_i2c_bus
 
 .rules:build:components_sensors_humiture_hts221_test:
   rules:
@@ -2089,6 +2095,8 @@
       changes: *patterns-build_system
     - <<: *if-dev-push
       changes: *patterns-components_sensors_humiture_mvh3004d
+    - <<: *if-dev-push
+      changes: *patterns-components_i2c_bus
 
 .rules:build:components_sensors_humiture_sht3x_test_apps:
   rules:
@@ -2100,6 +2108,8 @@
       changes: *patterns-build_system
     - <<: *if-dev-push
       changes: *patterns-components_sensors_humiture_sht3x
+    - <<: *if-dev-push
+      changes: *patterns-components_i2c_bus
 
 .rules:build:components_sensors_imu_lis2dh12_test_apps:
   rules:
@@ -2111,6 +2121,8 @@
       changes: *patterns-build_system
     - <<: *if-dev-push
       changes: *patterns-components_sensors_imu_lis2dh12
+    - <<: *if-dev-push
+      changes: *patterns-components_i2c_bus
 
 .rules:build:components_sensors_imu_mpu6050_test:
   rules:
@@ -2144,6 +2156,8 @@
       changes: *patterns-build_system
     - <<: *if-dev-push
       changes: *patterns-components_sensors_light_sensor_veml6040
+    - <<: *if-dev-push
+      changes: *patterns-components_i2c_bus
 
 .rules:build:components_sensors_light_sensor_veml6075_test_apps:
   rules:
@@ -2155,6 +2169,8 @@
       changes: *patterns-build_system
     - <<: *if-dev-push
       changes: *patterns-components_sensors_light_sensor_veml6075
+    - <<: *if-dev-push
+      changes: *patterns-components_i2c_bus
 
 .rules:build:components_sensors_pressure_bme280_test_apps:
   rules:
@@ -2166,6 +2182,8 @@
       changes: *patterns-build_system
     - <<: *if-dev-push
       changes: *patterns-components_sensors_pressure_bme280
+    - <<: *if-dev-push
+      changes: *patterns-components_i2c_bus
 
 .rules:build:components_sensors_sensor_hub_test_apps:
   rules:
@@ -2177,6 +2195,8 @@
       changes: *patterns-build_system
     - <<: *if-dev-push
       changes: *patterns-components_sensors_sensor_hub
+    - <<: *if-dev-push
+      changes: *patterns-components_i2c_bus
 
 .rules:build:components_spi_bus_test_apps:
   rules:
@@ -2335,6 +2355,8 @@
       changes: *patterns-components_sensors_power_monitor_ina236
     - <<: *if-dev-push
       changes: *patterns-components_bus
+    - <<: *if-dev-push
+      changes: *patterns-components_i2c_bus
 
 .rules:build:components_i2c_bus_test_apps:
   rules:

components/i2c_bus/CHANGELOG.md

@@ -1,5 +1,11 @@
 # ChangeLog
 
+## v1.2.0 - 2025-1-14
+
+### Enhancements:
+
+- Support enabling software I2C to extend the number of I2C ports.
+
 ## v1.1.0 - 2024-11-22
 
 ### Enhancements:

components/i2c_bus/CMakeLists.txt

@@ -6,8 +6,14 @@ else()
     set(REQ esp_driver_i2c driver)
 endif()
 
+if (CONFIG_I2C_BUS_SUPPORT_SOFTWARE)
+    list(APPEND SRC_FILE "i2c_bus_soft.c")
+endif()
+
 idf_component_register(SRCS ${SRC_FILE}
                         INCLUDE_DIRS "include"
+                        PRIV_INCLUDE_DIRS "private_include"
                         REQUIRES ${REQ})
+
 include(package_manager)
 cu_pkg_define_version(${CMAKE_CURRENT_LIST_DIR})

components/i2c_bus/Kconfig

@@ -25,6 +25,22 @@ menu "Bus Options"
             depends on ESP_IDF_VERSION >= 5.3
             help
                 Enable this option for backward compatibility with the old I2C driver
+
+        config I2C_BUS_SUPPORT_SOFTWARE
+            bool "Enable software I2C support"
+            default n
+            help
+                Enable this option to use a software-implemented I2C driver. This can be useful for scenarios where
+                hardware I2C is unavailable or additional I2C buses are needed beyond the hardware support.
+
+        config I2C_BUS_SOFTWARE_MAX_PORT
+            int "Maximum number of software I2C ports"
+            default 2
+            range 1 5
+            depends on I2C_BUS_SUPPORT_SOFTWARE
+            help
+                Set the maximum number of software I2C ports that can be used. This option is only applicable when
+                software I2C support is enabled.
     endmenu
 
 endmenu

components/i2c_bus/README.md

@@ -6,6 +6,8 @@ The I2C bus component (Bus) is a set of application-layer code built on top of t
 1. Simplified peripheral initialization processes
 2. Thread-safe device operations
 3. Simple and flexible RW operations
+4. Compatible with `driver/i2c` and `esp_driver_i2c`
+5. Supports additional software I2C
 
 This component abstracts the following concepts: