drivers: video: sw_stats: software-based statistics

drivers/video/CMakeLists.txt

@@ -9,6 +9,8 @@ zephyr_library_sources(video_device.c)
 zephyr_library_sources_ifdef(CONFIG_VIDEO_MCUX_CSI	video_mcux_csi.c)
 zephyr_library_sources_ifdef(CONFIG_VIDEO_MCUX_MIPI_CSI2RX video_mcux_mipi_csi2rx.c)
 zephyr_library_sources_ifdef(CONFIG_VIDEO_SW_GENERATOR	video_sw_generator.c)
+zephyr_library_sources_ifdef(CONFIG_VIDEO_SW_ISP video_sw_isp.c)
+zephyr_library_sources_ifdef(CONFIG_VIDEO_SW_STATS	video_sw_stats.c)
 zephyr_library_sources_ifdef(CONFIG_VIDEO_MT9M114	mt9m114.c)
 zephyr_library_sources_ifdef(CONFIG_VIDEO_OV7725	ov7725.c)
 zephyr_library_sources_ifdef(CONFIG_VIDEO_OV2640	ov2640.c)

drivers/video/Kconfig

@@ -58,6 +58,10 @@ source "drivers/video/Kconfig.mcux_mipi_csi2rx"
 
 source "drivers/video/Kconfig.sw_generator"
 
+source "drivers/video/Kconfig.sw_isp"
+
+source "drivers/video/Kconfig.sw_stats"
+
 source "drivers/video/Kconfig.mt9m114"
 
 source "drivers/video/Kconfig.ov7725"

drivers/video/Kconfig.sw_stats

@@ -0,0 +1,20 @@
+# Copyright (c) 2025 tinyVision.ai Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+config VIDEO_SW_STATS
+	bool "Video Software Statistics"
+	select PIXEL
+	help
+	  Enable a software-based frame statistics video device, providing information that can be
+	  by an Image Processing Algorithm (IPA) via the video stats API. This allows applications
+	  to tune the image colors through the video control API.
+
+config VIDEO_SW_STATS_NUM_SAMPLES
+	int "Number of pixels to sample on every frame"
+	default 400
+	range 0 65535
+	help
+	  The more pixels are sample, the most accurate the statistics may be, but the slowest they
+	  would be collected. The default value is estimated good enough not to slow-down most
+	  systems. Note that the performance of statistics collection does not depend on the frame
+	  size and only the number of samples, but accuracy does.

drivers/video/video_emul_rx.c

@@ -117,6 +117,25 @@ static int emul_rx_get_caps(const struct device *dev, enum video_endpoint_id ep,
 	return video_get_caps(cfg->source_dev, VIDEO_EP_OUT, caps);
 }
 
+static int emul_rx_get_stats(const struct device *dev, enum video_endpoint_id ep,
+			     struct video_stats *stats)
+{
+	struct video_stats_channels *chan = (void *)stats;
+
+	if ((stats->flags & VIDEO_STATS_CHANNELS_Y) == 0) {
+		return -ENOTSUP;
+	}
+
+	/* Fake data for the sake of demonstrating and testing the APIs */
+	chan->y = 0x7f;
+	stats->frame_counter = k_cycle_get_32() / 1024;
+
+	/* Let the caller know what type of statistics is collected */
+	stats->flags = VIDEO_STATS_CHANNELS_Y;
+
+	return 0;
+}
+
 static int emul_rx_set_stream(const struct device *dev, bool enable)
 {
 	const struct emul_rx_config *cfg = dev->config;
@@ -238,6 +257,7 @@ static DEVICE_API(video, emul_rx_driver_api) = {
 	.set_format = emul_rx_set_fmt,
 	.get_format = emul_rx_get_fmt,
 	.get_caps = emul_rx_get_caps,
+	.get_stats = emul_rx_get_stats,
 	.set_stream = emul_rx_set_stream,
 	.enqueue = emul_rx_enqueue,
 	.dequeue = emul_rx_dequeue,