From patchwork Mon Dec 5 10:06:55 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Raikhel, Evgeni" X-Patchwork-Id: 86532 Delivered-To: patch@linaro.org Received: by 10.140.20.101 with SMTP id 92csp1395992qgi; Mon, 5 Dec 2016 02:09:16 -0800 (PST) X-Received: by 10.84.217.216 with SMTP id d24mr123556248plj.10.1480932556573; Mon, 05 Dec 2016 02:09:16 -0800 (PST) Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id q13si14105791pli.265.2016.12.05.02.09.16; Mon, 05 Dec 2016 02:09:16 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-media-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-media-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-media-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751774AbcLEKIn (ORCPT + 4 others); Mon, 5 Dec 2016 05:08:43 -0500 Received: from mga05.intel.com ([192.55.52.43]:44178 "EHLO mga05.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751327AbcLEKIH (ORCPT ); Mon, 5 Dec 2016 05:08:07 -0500 Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by fmsmga105.fm.intel.com with ESMTP; 05 Dec 2016 02:08:06 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.33,747,1477983600"; d="scan'208,223";a="794323863" Received: from fmsmsx103.amr.corp.intel.com ([10.18.124.201]) by FMSMGA003.fm.intel.com with ESMTP; 05 Dec 2016 02:08:05 -0800 Received: from lcsmsx153.ger.corp.intel.com (10.186.165.228) by FMSMSX103.amr.corp.intel.com (10.18.124.201) with Microsoft SMTP Server (TLS) id 14.3.248.2; Mon, 5 Dec 2016 02:08:05 -0800 Received: from hasmsx108.ger.corp.intel.com ([169.254.9.44]) by LCSMSX153.ger.corp.intel.com ([169.254.8.87]) with mapi id 14.03.0248.002; Mon, 5 Dec 2016 12:06:55 +0200 From: "Raikhel, Evgeni" To: "linux-media@vger.kernel.org" CC: "laurent.pinchart@ideasonboard.com" Subject: [PATCH] UVC Module - Support Intel RealSense SR300 Depth Camera formats Thread-Topic: [PATCH] UVC Module - Support Intel RealSense SR300 Depth Camera formats Thread-Index: AdJO3PDIR4afYKwpTS+GIiJrXRsfjw== Date: Mon, 5 Dec 2016 10:06:55 +0000 Message-ID: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: yes X-MS-TNEF-Correlator: x-originating-ip: [10.184.70.10] MIME-Version: 1.0 Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org Specify GUID and FourCC codes mapping for Depth-related pixel formats advertised by Intel RealSense(tm) SR300 depth camera. Provide documentation for the new INZI pixel format introduced. --------------------------------------------------------------------- Intel Israel (74) Limited This e-mail and any attachments may contain confidential material for the sole use of the intended recipient(s). Any review or distribution by others is strictly prohibited. If you are not the intended recipient, please contact the sender and delete all copies. Reviewed-by: Laurent Pinchart Reviewed-by: Laurent Pinchart Acked-by: Hans Verkuil >From 581f4c3e60d8e7895bc34f9e0e90476eed31fa8d Mon Sep 17 00:00:00 2001 From: Evgeni Raikhel Date: Wed, 16 Nov 2016 11:53:49 +0200 Subject: [PATCH 2/2] Document Intel SR300 Depth camera INZI format Provide the frame structure and data layout of V4L2-PIX-FMT-INZI format utilized by Intel SR300 Depth camera. This is a complimentary patch for: [PATCH] UVC: Add support for Intel SR300 depth camera Signed-off-by: Evgeni Raikhel --- Documentation/media/uapi/v4l/pixfmt-inzi.rst | 40 ++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 Documentation/media/uapi/v4l/pixfmt-inzi.rst diff --git a/Documentation/media/uapi/v4l/pixfmt-inzi.rst b/Documentation/media/uapi/v4l/pixfmt-inzi.rst new file mode 100644 index 000000000000..cdfdeae4a664 --- /dev/null +++ b/Documentation/media/uapi/v4l/pixfmt-inzi.rst @@ -0,0 +1,40 @@ +.. -*- coding: utf-8; mode: rst -*- + +.. _V4L2-PIX-FMT-INZI: + +************************** +V4L2_PIX_FMT_INZI ('INZI') +************************** + +Infrared 10-bit linked with Depth 16-bit images + + +Description +=========== + +Custom multi-planar format used by Intel SR300 Depth cameras, comprise of Infrared image followed by Depth data. +The pixel definition is 32-bpp, with the Depth and Infrared Data split into separate continuous planes of identical dimensions. + +The first plane - Infrared data - is stored in V4L2_PIX_FMT_Y10 (see :ref:`pixfmt-y10`) greyscale format. Each pixel is 16-bit cell, with actual data present in the 10 LSBs with values in range 0 to 1023. The six remaining MSBs are padded with zeros. + +The second plane provides 16-bit per-pixel Depth data in V4L2_PIX_FMT_Z16 (:ref:`pixfmt-z16`) format. + + +**Frame Structure.** +Each cell is a 16-bit word with the significant data byte is stored at lower memory address (little-endian). + ++-----------------+-----------------+-----------------+-----------------+-----------------+-----------------+ +| Ir\ :sub:`0` | Ir\ :sub:`1` | Ir\ :sub:`2` | ... | ... | ... | ++-----------------+-----------------+-----------------+-----------------+-----------------+-----------------+ +| ... ... ... | +| Infrared Data | +| ... ... ... | ++-----------------+-----------------+-----------------+-----------------+-----------------+-----------------+ +| Ir\ :sub:`n-3` | Ir\ :sub:`n-2` | Ir\ :sub:`n-1` | Depth\ :sub:`0` | Depth\ :sub:`1` | Depth\ :sub:`2` | ++-----------------+-----------------+-----------------+-----------------+-----------------+-----------------+ +| ... ... ... | +| Depth Data | +| ... ... ... | ++-----------------+-----------------+-----------------+-----------------+-----------------+-----------------+ +| ... | ... | ... |Depth\ :sub:`n-3`|Depth\ :sub:`n-2`|Depth\ :sub:`n-1`| ++-----------------+-----------------+-----------------+-----------------+-----------------+-----------------+ -- 2.7.4