Merge branch 'feature/add_os02n10_mipi_driver_support' into 'master'

feat: add os02n10 mipi camera sensor driver

Closes AEG-2666

See merge request espressif/esp-video-components!313

Author: donghengqaz

esp_cam_sensor/CHANGELOG.md

@@ -3,13 +3,15 @@
 ## Unreleased
 
 - Added line exposure time info in camera drivers.
+- Added OS02N10 MIPI camera sensor driver.
 
 ## 1.3.0
 - Changed YUV422 sequence for SC030IOT, SC101IOT, GC0308, and BF3A03 sensors to depend on CONFIG_CAMERA_SENSOR_SWAP_PIXEL_BYTE_ORDER
+- Changed YUV422 sequence for SC030IOT, SC101IOT, GC0308, and BF3A03 sensors to depend on CONFIG_CAMERA_SENSOR_SWAP_PIXEL_BYTE_ORDER.
 - Fixed OV2640 JPEG compression quality calculation issue.
 - Fixed incorrect format selection in OV2640 Kconfig.
 - Removed the GROUP Hold function in the SC2336 driver.
-- Modified GPIO pin type from int8_t to gpio_num_t
+- Modified GPIO pin type from int8_t to gpio_num_t.
 
 ## 1.2.1
 - Deprecated ledc intr type config

esp_cam_sensor/CMakeLists.txt

@@ -62,6 +62,12 @@ if(CONFIG_CAMERA_GC2145)
     list(APPEND priv_include_dirs "sensors/gc2145/private_include")
 endif()
 
+if(CONFIG_CAMERA_OS02N10)
+    list(APPEND srcs "sensors/os02n10/os02n10.c")
+    list(APPEND include_dirs "sensors/os02n10/include")
+    list(APPEND priv_include_dirs "sensors/os02n10/private_include")
+endif()
+
 if(CONFIG_CAMERA_SC101IOT)
     list(APPEND srcs "sensors/sc101iot/sc101iot.c")
     list(APPEND include_dirs "sensors/sc101iot/include")
@@ -149,6 +155,10 @@ if(CONFIG_CAMERA_GC2145_AUTO_DETECT_MIPI_INTERFACE_SENSOR OR CONFIG_CAMERA_GC214
     target_link_libraries(${COMPONENT_LIB} INTERFACE "-u gc2145_detect")
 endif()
 
+if(CONFIG_CAMERA_OS02N10_AUTO_DETECT_MIPI_INTERFACE_SENSOR)
+    target_link_libraries(${COMPONENT_LIB} INTERFACE "-u os02n10_detect")
+endif()
+
 if(CONFIG_CAMERA_SC101IOT_AUTO_DETECT_DVP_INTERFACE_SENSOR)
     target_link_libraries(${COMPONENT_LIB} INTERFACE "-u sc101iot_detect")
 endif()

esp_cam_sensor/Kconfig

@@ -6,6 +6,7 @@ menu "Espressif Camera Sensors Configurations"
             rsource "sensors/bf3a03/Kconfig.bf3a03"
             rsource "sensors/gc0308/Kconfig.gc0308"
             rsource "sensors/gc2145/Kconfig.gc2145"
+            rsource "sensors/os02n10/Kconfig.os02n10"
             rsource "sensors/ov2640/Kconfig.ov2640"
             rsource "sensors/ov2710/Kconfig.ov2710"
             rsource "sensors/ov5640/Kconfig.ov5640"

esp_cam_sensor/README.md

@@ -26,6 +26,7 @@ It is highly recommended that users use it in the [esp-video](https://github.com
 | BF3A03  | 640 x 480    | DVP | YCbCr422<br/>RGB565<br/>8bit Raw RGB data | 1/6.5"     |
 | GC0308  | 640 x 480    | DVP | Grayscale<br/>YCbCr422<br/>RGB565 | 1/6.5"     |
 | GC2145  | 1600 x 1200    | MIPI & DVP | RGB565<br/>YCbCr422<br/>8bit Raw RGB data | 1/5"     |
+| OS02N10 | 1920 x 1080    | MIPI | 8/10-bit Raw RGB data | 1/3.27"     |
 | OV2640  | 1600 x 1200    | DVP | 8/10-bit Raw RGB data<br/>JPEG compression<br/>YUV/YCbCr422<br/>RGB565 | 1/4"     |
 | OV2710  | 1920 x 1080    | MIPI | Raw RGB data | 1/2.7"     |
 | OV5640  | 2592 x 1944    | MIPI & DVP     | RGB565<br/>YUV/YCbCr422 | 1/4"     |

esp_cam_sensor/project_include.cmake

@@ -14,6 +14,14 @@ if(CONFIG_CAMERA_SC2336)
     endif()
 endif()
 
+if(CONFIG_CAMERA_OS02N10)
+    if(CONFIG_CAMERA_OS02N10_DEFAULT_IPA_JSON_CONFIGURATION_FILE)
+        idf_build_set_property(ESP_IPA_JSON_CONFIG_FILE_PATH "${COMPONENT_PATH}/sensors/os02n10/cfg/os02n10_default.json" APPEND)
+    elseif(CONFIG_CAMERA_OS02N10_CUSTOMIZED_IPA_JSON_CONFIGURATION_FILE)
+        idf_build_set_property(ESP_IPA_JSON_CONFIG_FILE_PATH ${CONFIG_CAMERA_OS02N10_CUSTOMIZED_IPA_JSON_CONFIGURATION_FILE_PATH} APPEND)
+    endif()
+endif()
+
 if(CONFIG_CAMERA_OV2710)
     if(CONFIG_CAMERA_OV2710_DEFAULT_IPA_JSON_CONFIGURATION_FILE)
         idf_build_set_property(ESP_IPA_JSON_CONFIG_FILE_PATH "${COMPONENT_PATH}/sensors/ov2710/cfg/ov2710_default.json" APPEND)

esp_cam_sensor/sensors/os02n10/Kconfig.os02n10

@@ -0,0 +1,131 @@
+menuconfig CAMERA_OS02N10
+    bool "OS02N10"
+    default n
+    depends on SOC_MIPI_CSI_SUPPORTED
+    help
+        Enable support for the OS02N10 CMOS image sensor.
+
+if CAMERA_OS02N10
+    menu "Auto detect OS02N10"
+        config CAMERA_OS02N10_AUTO_DETECT_MIPI_INTERFACE_SENSOR
+            bool "Detect for MIPI CSI interface sensor"
+            default y
+            depends on SOC_MIPI_CSI_SUPPORTED
+            help
+                When enabled, the OS02N10 sensor will be automatically detected
+                and initialized on the MIPI CSI interface at startup without requiring
+                manual detection call(os02n10_detect) in your application.
+    endmenu
+
+    config CAMERA_OS02N10_SID_HIGH
+        bool "Set SID pin to high"
+        default n
+        help
+            This option allows you to configure the sensor ID. When the SID pin uses a high level, 
+            the sensor ID will be configured as 0x3d, otherwise, the sensor ID will be configured as 0x3c.
+
+    choice CAMERA_OS02N10_MIPI_DEFAULT_FMT
+        prompt "Select default output format for MIPI CSI interface"
+        default CAMERA_OS02N10_MIPI_RAW8_1920X1080_25FPS
+        depends on SOC_MIPI_CSI_SUPPORTED
+        help
+            This option allows you to select the default video format for the OS02N10 sensor
+            when it is initialized on the MIPI CSI interface. The selected format will be used
+            when the sensor is detected and initialized, and can be changed later when the
+            sensor is in stream off state.
+
+        config CAMERA_OS02N10_MIPI_RAW10_1920X1080_25FPS
+            bool "RAW10 1920x1080 25fps, MIPI 2-lane, 24M input"
+            help
+                RAW10 color format at 1920x1080 resolution (HD) with 25fps framerate.
+                Requires MIPI CSI-2 2-lane interface with 24MHz input clock.
+        config CAMERA_OS02N10_MIPI_RAW10_1280X720_50FPS
+            bool "RAW10 1280x720 50fps, MIPI 2-lane, 24M input"
+            help
+                RAW10 color format at 1280x720 resolution (HD) with 50fps framerate.
+                Requires MIPI CSI-2 2-lane interface with 24MHz input clock.
+        config CAMERA_OS02N10_MIPI_RAW8_1920X1080_25FPS
+            bool "RAW8 1920x1080 25fps, MIPI 2-lane, 24M input"
+            help
+                RAW8 color format at 1920x1080 resolution (HD) with 25fps framerate.
+                Requires MIPI CSI-2 2-lane interface with 24MHz input clock.
+        config CAMERA_OS02N10_MIPI_RAW8_1280X720_50FPS
+            bool "RAW8 1280x720 50fps, MIPI 2-lane, 24M input"
+            help
+                RAW8 color format at 1280x720 resolution (HD) with 50fps framerate.
+                Requires MIPI CSI-2 2-lane interface with 24MHz input clock.
+        config CAMERA_OS02N10_MIPI_RAW8_960x540_25FPS
+            bool "RAW8 960x540 25fps, MIPI 2-lane, 24M input"
+            help
+                RAW8 color format at 960x540 resolution with 25fps framerate.
+                Requires MIPI CSI-2 2-lane interface with 24MHz input clock.
+    endchoice # CAMERA_OS02N10_MIPI_DEFAULT_FMT
+
+    config CAMERA_OS02N10_MIPI_IF_FORMAT_INDEX_DEFAULT
+        int
+        depends on SOC_MIPI_CSI_SUPPORTED
+        default 0 if CAMERA_OS02N10_MIPI_RAW10_1920X1080_25FPS
+        default 1 if CAMERA_OS02N10_MIPI_RAW10_1280X720_50FPS
+        default 2 if CAMERA_OS02N10_MIPI_RAW8_1920X1080_25FPS
+        default 3 if CAMERA_OS02N10_MIPI_RAW8_1280X720_50FPS
+        default 4 if CAMERA_OS02N10_MIPI_RAW8_960x540_25FPS
+        help
+            Sets the default configuration for the MIPI CSI interface.
+            Use query_support_formats() API to get more format options.
+
+    config CAMERA_OS02N10_ABSOLUTE_GAIN_LIMIT
+            int "Maximum absolute gain limit (x1000)"
+            default 10000
+            range 4000 16468
+            help
+                Set the maximum gain limit that can be applied by upper-level applications.
+
+                Value is gain multiplied by 1000 to avoid floating-point arithmetic:
+                - 4000 = 4x gain (minimum)
+                - 16000 = 16x gain (default)
+                - 16468 = 16.468x gain (maximum)
+
+                Lower values reduce noise but may limit low-light performance.
+                Higher values improve low-light sensitivity but increase noise and
+                may cause sensor overheating.
+
+    choice CAMERA_OS02N10_IPA_JSON_CONFIGURATION_FILE
+        prompt "IPA Configuration File"
+        default CAMERA_OS02N10_DEFAULT_IPA_JSON_CONFIGURATION_FILE
+        help
+            Select the Image Processing Algorithm (IPA) JSON configuration file
+            for the OS02N10 sensor.
+
+        config CAMERA_OS02N10_DEFAULT_IPA_JSON_CONFIGURATION_FILE
+            bool "Use default configuration"
+            help
+                Use the built-in default IPA configuration file:
+                "esp_cam_sensor/sensors/os02n10/cfg/os02n10_default.json"
+
+                This configuration provides optimized settings for general use cases
+                and is recommended for most applications.
+
+        config CAMERA_OS02N10_CUSTOMIZED_IPA_JSON_CONFIGURATION_FILE
+            bool "Use custom configuration"
+            help
+                Use a custom IPA configuration file with your own optimized settings.
+
+                This option allows you to fine-tune sensor parameters for specific
+                lighting conditions, color requirements, or application needs.
+
+                You must specify the custom file path in the configuration below.
+    endchoice
+
+    config CAMERA_OS02N10_CUSTOMIZED_IPA_JSON_CONFIGURATION_FILE_PATH
+        string "Custom IPA configuration file path"
+        depends on CAMERA_OS02N10_CUSTOMIZED_IPA_JSON_CONFIGURATION_FILE
+        help
+            Specify the path to your custom OS02N10 IPA JSON configuration file.
+
+            The path is relative to your project root directory.
+
+            Example: "components/my_camera_config/os02n10_custom.json"
+
+            Ensure the file exists and contains valid JSON configuration
+            parameters compatible with the OS02N10 sensor.
+endif