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')
