This is an automated email from the ASF dual-hosted git repository.

xiaoxiang781216 pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git

commit 09659ab9903a209eaadcceb1b6d39e55aead4995
Author: raiden00pl <[email protected]>
AuthorDate: Wed Nov 4 10:46:12 2026 +0100

    video: Add the Z16 depth pixel format.
    
    V4L2_PIX_FMT_Z16 carries a 16-bit little endian distance per pixel, as
    used by time-of-flight depth sensors.  Add the imgdata and imgsensor
    values and pass it through the V4L2 capture format handling.
    
    Assisted-by: Claude:claude-fable-5-1
    Signed-off-by: raiden00pl <[email protected]>
---
 Documentation/os/drivers/special/video.rst | 10 ++++++++++
 drivers/video/v4l2_cap.c                   | 10 ++++++++++
 include/nuttx/video/imgdata.h              |  1 +
 include/nuttx/video/imgsensor.h            |  1 +
 include/sys/videoio.h                      |  4 ++++
 5 files changed, 26 insertions(+)

diff --git a/Documentation/os/drivers/special/video.rst 
b/Documentation/os/drivers/special/video.rst
index 9f948dfe87e..4f8f8f4ea65 100644
--- a/Documentation/os/drivers/special/video.rst
+++ b/Documentation/os/drivers/special/video.rst
@@ -71,3 +71,13 @@ probably more useful for me than you, but there they are in 
case I'm wrong
 about that.
 
 b.g.
+
+Depth (time-of-flight) cameras
+------------------------------
+
+Multizone and depth time-of-flight sensors produce an image and are V4L2
+capture devices; single-zone sensors report one distance through the
+sensor framework (``SENSOR_TYPE_PROXIMITY``).  The frame is
+``V4L2_PIX_FMT_Z16``: one little-endian 16-bit distance in millimetres
+per pixel, 0 when the pixel has no valid target.  The resolutions and
+the frame rates are V4L2 frame sizes and frame intervals.
diff --git a/drivers/video/v4l2_cap.c b/drivers/video/v4l2_cap.c
index 534a8106835..abf07725928 100644
--- a/drivers/video/v4l2_cap.c
+++ b/drivers/video/v4l2_cap.c
@@ -841,6 +841,10 @@ static void convert_to_imgdatafmt(FAR video_format_t 
*video,
         data->pixelformat = IMGDATA_PIX_FMT_RGB565X;
         break;
 
+      case V4L2_PIX_FMT_Z16:
+        data->pixelformat = IMGDATA_PIX_FMT_Z16;
+        break;
+
       case V4L2_PIX_FMT_JPEG:
         data->pixelformat = IMGDATA_PIX_FMT_JPEG;
         break;
@@ -888,6 +892,10 @@ static void convert_to_imgsensorfmt(FAR video_format_t 
*video,
         sensor->pixelformat = IMGSENSOR_PIX_FMT_RGB565X;
         break;
 
+      case V4L2_PIX_FMT_Z16:
+        sensor->pixelformat = IMGSENSOR_PIX_FMT_Z16;
+        break;
+
       case V4L2_PIX_FMT_JPEG:
         sensor->pixelformat = IMGSENSOR_PIX_FMT_JPEG;
         break;
@@ -1583,6 +1591,7 @@ static size_t get_bufsize(FAR video_format_t *vf)
       case V4L2_PIX_FMT_UYVY:
       case V4L2_PIX_FMT_RGB565:
       case V4L2_PIX_FMT_RGB565X:
+      case V4L2_PIX_FMT_Z16:
       default:
         return ret * 2;
       case V4L2_PIX_FMT_JPEG:
@@ -3028,6 +3037,7 @@ static int capture_try_fmt(FAR struct file *filep,
       case V4L2_PIX_FMT_UYVY:
       case V4L2_PIX_FMT_RGB565:
       case V4L2_PIX_FMT_RGB565X:
+      case V4L2_PIX_FMT_Z16:
       case V4L2_PIX_FMT_JPEG:
       case V4L2_PIX_FMT_ENTROPY:
       case V4L2_PIX_FMT_JPEG_WITH_SUBIMG:
diff --git a/include/nuttx/video/imgdata.h b/include/nuttx/video/imgdata.h
index 0b8d80dd6ec..559f282d269 100644
--- a/include/nuttx/video/imgdata.h
+++ b/include/nuttx/video/imgdata.h
@@ -50,6 +50,7 @@
 #define IMGDATA_PIX_FMT_NV12             (8)
 #define IMGDATA_PIX_FMT_RGB565X          (9)
 #define IMGDATA_PIX_FMT_ENTROPY          (10)
+#define IMGDATA_PIX_FMT_Z16              (11)
 
 /* Flags for imgdata_s.caps */
 
diff --git a/include/nuttx/video/imgsensor.h b/include/nuttx/video/imgsensor.h
index 266db07f4a8..c09f454ca8d 100644
--- a/include/nuttx/video/imgsensor.h
+++ b/include/nuttx/video/imgsensor.h
@@ -126,6 +126,7 @@
 #define IMGSENSOR_PIX_FMT_NV12             (8)
 #define IMGSENSOR_PIX_FMT_RGB565X          (9)
 #define IMGSENSOR_PIX_FMT_ENTROPY          (10)
+#define IMGSENSOR_PIX_FMT_Z16              (11)
 
 /* Method access helper macros */
 
diff --git a/include/sys/videoio.h b/include/sys/videoio.h
index 96dcde4a255..eb2d4eb3a65 100644
--- a/include/sys/videoio.h
+++ b/include/sys/videoio.h
@@ -93,6 +93,10 @@ extern "C"
 #define V4L2_PIX_FMT_Y16      v4l2_fourcc('Y', '1', '6', ' ')
 #define V4L2_PIX_FMT_Y16_BE   v4l2_fourcc_be('Y', '1', '6', ' ')
 
+/* Depth formats: 16-bit little endian distance per pixel */
+
+#define V4L2_PIX_FMT_Z16      v4l2_fourcc('Z', '1', '6', ' ')
+
 /* Grey bit-packed formats */
 
 #define V4L2_PIX_FMT_Y10BPACK v4l2_fourcc('Y', '1', '0', 'B')

Reply via email to