Merge branch 'feat/add_spi_bus' into 'master'

feat(spi_bus): Separate spi from bus components

Closes AEG-1906

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

Author: YanKE01

.github/workflows/upload_component.yml

@@ -62,6 +62,7 @@ jobs:
             components/sensors/humiture/aht20;
             components/sensors/ntc_driver;
             components/sensors/radar/at581x;
+            components/spi_bus;
             components/touch/touch_proximity_sensor;
             components/usb/esp_msc_ota;
             components/usb/esp_tinyuf2;

.gitlab/ci/build.yml

@@ -1174,6 +1174,14 @@ build_components_sensors_radar_at581x_test_apps:
   variables:
     EXAMPLE_DIR: components/sensors/radar/at581x/test_apps
 
+build_components_spi_bus_test_apps:
+  extends:
+    - .build_examples_template
+    - .rules:build:components_spi_bus_test_apps
+    - .build_idf_active_release_version
+  variables:
+    EXAMPLE_DIR: components/spi_bus/test_apps
+
 build_components_touch_touch_proximity_sensor_test_apps:
   extends:
     - .build_examples_template

.gitlab/ci/rules.yml

@@ -239,6 +239,10 @@
 .patterns-components_sensors_sensor_hub: &patterns-components_sensors_sensor_hub
   - "components/sensors/sensor_hub/**/*"
 
+.patterns-components_spi_bus: &patterns-components_spi_bus
+  - "components/spi_bus/**/*"
+  - "components/tools/cmake_utilities/package_manager.cmake"
+
 .patterns-components_storage_eeprom_at24c02: &patterns-components_storage_eeprom_at24c02
   - "components/storage/eeprom/at24c02/**/*"
 
@@ -320,7 +324,6 @@
   - "components/bluetooth/ble_services/hrs/include/esp_hrs.h"
   - "components/bluetooth/ble_services/hts/include/esp_hts.h"
   - "components/bluetooth/ble_services/tps/include/esp_tps.h"
-  - "components/bus/include/spi_bus.h"
   - "components/button/include/iot_button.h"
   - "components/display/screen/interface_driver/scr_interface_driver.h"
   - "components/display/screen/screen_driver.h"
@@ -344,6 +347,7 @@
   - "components/sensors/sensor_hub/include/hal/light_sensor_hal.h"
   - "components/sensors/sensor_hub/include/iot_sensor_hub.h"
   - "components/sensors/sensor_hub/include/sensor_type.h"
+  - "components/spi_bus/include/spi_bus.h"
   - "components/touch/touch_proximity_sensor/include/touch_proximity_sensor.h"
   - "components/usb/esp_msc_ota/include/esp_msc_ota.h"
   - "components/usb/esp_tinyuf2/esp_tinyuf2.h"
@@ -2007,6 +2011,17 @@
     - <<: *if-dev-push
       changes: *patterns-components_sensors_sensor_hub
 
+.rules:build:components_spi_bus_test_apps:
+  rules:
+    - <<: *if-protected
+    - <<: *if-label-build
+    - <<: *if-label-target_test
+    - <<: *if-trigger-job
+    - <<: *if-dev-push
+      changes: *patterns-build_system
+    - <<: *if-dev-push
+      changes: *patterns-components_spi_bus
+
 .rules:build:components_storage_eeprom_at24c02_test:
   rules:
     - <<: *if-protected

components/bus/test/CMakeLists.txt

@@ -18,5 +18,5 @@ set(SCREEN_DIR "controller_driver/ili9341"
 idf_component_register(SRC_DIRS "${SCREEN_DIR}" "screen_utility" "interface_driver" "."
                         INCLUDE_DIRS "${SCREEN_DIR}" "interface_driver" "."
                         PRIV_INCLUDE_DIRS "screen_utility"
-                        REQUIRES bus i2c_bus
+                        REQUIRES bus i2c_bus spi_bus
                         )

components/bus/test/test_spi_bus.c

@@ -4,5 +4,5 @@ set(TOUCH_DIR "xpt2046" "ft5x06" "ns2016")
 idf_component_register(SRC_DIRS "." "${TOUCH_DIR}" "calibration" "calibration/basic_painter" "calibration/basic_painter/fonts"
                         INCLUDE_DIRS "." "${TOUCH_DIR}" "calibration/basic_painter" "calibration/basic_painter/fonts"
                         PRIV_INCLUDE_DIRS "calibration"
-                        PRIV_REQUIRES bus nvs_flash
+                        PRIV_REQUIRES i2c_bus spi_bus nvs_flash
                         REQUIRES screen)

components/display/screen/CMakeLists.txt

@@ -0,0 +1,7 @@
+# Changelog
+
+## v1.0.0 - 2024-10-16
+
+First release version.
+
+- Support SPI bus

components/display/touch_panel/CMakeLists.txt

@@ -0,0 +1,5 @@
+idf_component_register(SRC_DIRS "."
+                        INCLUDE_DIRS "include"
+                        REQUIRES driver)
+include(package_manager)
+cu_pkg_define_version(${CMAKE_CURRENT_LIST_DIR})

components/spi_bus/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Component: SPI BUS
+
+The SPI bus component (Bus) is a set of application-layer code built on top of the ESP-IDF peripheral driver code, It is mainly used for bus communication between ESP chips and external devices. From the point of application development, this component has the following features:
+
+1. Simplified peripheral initialization processes
+2. Thread-safe device operations
+3. Simple and flexible RW operations
+
+This component abstracts the following concepts:
+
+1. Bus: the resource and configuration option shared between devices during communication
+2. Device: device specific resource and configuration option during communication
+
+Each physical peripheral bus can mount one or more devices if the electrical condition allows, with the SPI bus addressing devices based on CS pins, thus achieving software independence between different devices on the same bus.
+
+## Add component to your project
+
+Please use the component manager command `add-dependency` to add the `spi_bus` to your project's dependency, during the `CMake` step the component will be downloaded automatically
+
+```
+idf.py add-dependency "espressif/spi_bus=*"
+```
+
+## How to use
+[spi_bus user guide](https://docs.espressif.com/projects/esp-iot-solution/en/latest/basic/bus/spi_bus.html)