From patchwork Tue Nov 1 10:04:46 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hsia-Jun Li X-Patchwork-Id: 620755 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id DADC5FA3745 for ; Tue, 1 Nov 2022 10:05:56 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230504AbiKAKFy (ORCPT ); Tue, 1 Nov 2022 06:05:54 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39028 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229980AbiKAKFx (ORCPT ); Tue, 1 Nov 2022 06:05:53 -0400 Received: from NAM10-DM6-obe.outbound.protection.outlook.com (mail-dm6nam10on2083.outbound.protection.outlook.com [40.107.93.83]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AA368193D2; Tue, 1 Nov 2022 03:05:52 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=mC8GAPdebjQIiJATMq2NyKe6p6Z4qsfCSf5r3El064eLuPbsoTFZnw51xrNdKeEd6SVr86szTPTfFu1t+xYmXkB9yViWuPD9gu0rP1E5t+a3jXIJtbK+kjs95yKbTxgiigPdj8CImeS81YzfGIZ05KeBCKMNR1f3vUg3t5/vUSubvlVHmtxXcWr6pI2q//W9Gf8iADyUiGsceJXhieQooruTPTWf668Z38mi7fwwAnx6n68JgqjrOGorQ37UfCUBqAGJCEPHQlNbFrfauuLr0dnhGHI5zSLc0eJlCCIWzSmdCeZCdNQxyzYOrA+3T4ZlB9k5yEnWhlcvgsiEnNKbPA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=WLbFrOWEYWjaTOVaR/p2ZKNFdbel3IZbWaevVbsdCwo=; b=hArLA82YgyuW81kmIpk+Uvr/tGYkQmOBahAgL9YNEkwbqlELsLfzk4J54kmc/SNYOuqjT9V/7eKGLEhpvI9zW00GiP4lgRsaONOxW0y/uTGhWXMCIVTB/6aEjHQ5tbn7xHUQuI6aocyPyUO59zdkTx5qHK4cFHcxUwRboOLLQnexSFqr7/rjk1JtXdD7/9T5iNV/y9ndqy6FBLkM3nOMzb67Stj1RdAJ1OlireYoxo0UqgB3p97BPC90qJuJt3sOX0J5PM0MJYME+4JYo11uHyhJUeIHfXuXfbxKuNeUMFE6cH+fB03Slr8a9LkBDAENGypG4q/dY7c4g34XiU/C3A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=synaptics.com; dmarc=pass action=none header.from=synaptics.com; dkim=pass header.d=synaptics.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Synaptics.onmicrosoft.com; s=selector2-Synaptics-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=WLbFrOWEYWjaTOVaR/p2ZKNFdbel3IZbWaevVbsdCwo=; b=A9114vFYm6bklPo4oWG1goZjrgwrAQ/3Y2KHdzLdTFp09Nl8grejhqotjr6lnahDesNX10NMMb5LGFnAXIAiT9RVFv/YExoIxjltazLd3Olijn59auzrNYCYTfPdh3L/tdVj7qdXbG+GENpVui+fQybZlSOjMK6ByHO7+n6x19k= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=synaptics.com; Received: from DM6PR03MB5196.namprd03.prod.outlook.com (2603:10b6:5:24a::19) by MW4PR03MB6362.namprd03.prod.outlook.com (2603:10b6:303:11d::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5769.19; Tue, 1 Nov 2022 10:05:51 +0000 Received: from DM6PR03MB5196.namprd03.prod.outlook.com ([fe80::a132:66d9:ed0f:e5c1]) by DM6PR03MB5196.namprd03.prod.outlook.com ([fe80::a132:66d9:ed0f:e5c1%7]) with mapi id 15.20.5769.021; Tue, 1 Nov 2022 10:05:51 +0000 From: Hsia-Jun Li To: dri-devel@lists.freedesktop.org Cc: airlied@linux.ie, daniel@ffwll.ch, ezequiel@vanguardiasur.com.ar, helen.koike@collabora.com, hverkuil-cisco@xs4all.nl, jszhang@kernel.org, laurent.pinchart@ideasonboard.com, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, linux-media@vger.kernel.org, maarten.lankhorst@linux.intel.com, mchehab@kernel.org, mripard@kernel.org, nicolas@ndufresne.ca, ribalda@chromium.org, sakari.ailus@linux.intel.com, sebastian.hesselbarth@gmail.com, tfiga@chromium.org, tzimmermann@suse.de, "Hsia-Jun(Randy) Li" Subject: [PATCH v3 2/4] media: videodev2.h: add pixel format modifiers Date: Tue, 1 Nov 2022 18:04:46 +0800 Message-Id: <20221101100448.66712-3-randy.li@synaptics.com> X-Mailer: git-send-email 2.37.3 In-Reply-To: <20221101100448.66712-1-randy.li@synaptics.com> References: <20221101100448.66712-1-randy.li@synaptics.com> X-ClientProxiedBy: PH0PR07CA0027.namprd07.prod.outlook.com (2603:10b6:510:5::32) To DM6PR03MB5196.namprd03.prod.outlook.com (2603:10b6:5:24a::19) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6PR03MB5196:EE_|MW4PR03MB6362:EE_ X-MS-Office365-Filtering-Correlation-Id: fbe8876a-776a-444b-52c3-08dabbf0a7d5 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: H4SUqSfy3xre2VoMOqhxyjpdd9Yh3pk9dZQPsjBGLnj5Kosk5xq0ceuJCqSXpQzm5z7NTAoL8Npu9OqMYxB99v3ObJkA1Htgzb65ZLbrf1EeoXAqUnpP5qSFynHuRBCBjUh5JtDSLk1+gxkSftiuQXVOqCisKemG3DW+10uC5o9HoJiYNLY2jDxpDRHK24XhnB+6OM7FyRpapS9TYeb2DVGfG7C+erEDurRUsHd3hQ4Jl32syKPeYaSiWLKb3JDMb4OKcvRSmEflEuMYaSJqq7p3ueb5AqRdcyp7oTZ1seCe+v4aFVQyRp2vGcbFy4IniY96D0oBfe1wANogP4hriO2wGvEIjNWVik5sY3/EG6gCVsWSe8pUT+LHnSQQYHLAYy60ydA0FF/Lgdht8svTFLcgR76a7DSkR9bxVHv9C69ULVZ79Pg1ghJfMk9JAZ2CPvAvUZyjw7JudmEw+utOttOJ2VaNnnmNQwnbTPVogmMFZiWZ38f0F/VR53KMnHMdcErVMDtT1nJi+w/nbR+U2ErKWKXw1Km3OM4QF0Z6JSObwwGeRdvaYtcD46tfwaKqvXdj4cshQ3hiBJu/PVr42KIkUyF3FIpL29MgIfv/e8xFPdytyfFfYFpDxEfomn7irshqzDq917TJZ2luM6cpeOlxnxKQ4lHf8xvD1xaNP0hBwYn7Za1k8VXxb+fYRkVl0FW/xCy6gGb9Dk0yb72zFKrillggT2sWk6L9L0PQkLIdU26ZEh0YA/OhD4POu3jE X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DM6PR03MB5196.namprd03.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230022)(376002)(346002)(39860400002)(396003)(136003)(366004)(451199015)(36756003)(478600001)(86362001)(6486002)(6506007)(66946007)(316002)(6916009)(66476007)(66556008)(107886003)(4326008)(8676002)(6666004)(52116002)(6512007)(8936002)(5660300002)(26005)(41300700001)(1076003)(2906002)(186003)(7416002)(2616005)(38350700002)(38100700002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: HbxwtuiiREkKfFQd4tCbaTI3X9JCeNhumQYX1Jov0UhwvM7cSVlaOpKCK79q5qmHWMe1sEPSlTSAKAFoK/1DplrUNDqcIHtT6gwmiWigXJz24AxrRFOuEFDJBXhtjMvLF39Iqy/p1aRiL8vxU3I83ogFRLDH8/2k7mbcGUFWudsBdsMbN9rExANGKq3BDyxzBGnUGckmTM1oaWfcPmGRJfRUoB6Q4A/z3tFaUb5OSuR+cCDHI8aGDv6MjbXtGRqtHF27K/646HBMLztS8OZP8xh2+9hHzRfCLBSzdRvpul5xczRfqVcZbNri01jzqb9pPzPKHikSc2ZknedXCDtZSZL3VkPnxicwMi0Qrcl8GkSdsq2u1I6uPdet0MFDZJlWW5zpG8Pc4O0nYIwQhGqX4IRjuX06uf9O1lraGIm1mF8P5ijs1wrShtLA834EqTEDpORJkSjn+PXsiXIC7DgPPZn2PIjOQoN12wBoVyCjZBh+djBcB2cN3U580/2gkKL3epEvgsDoUkk3WjFnZMcxN/vEi3wFmwRpCVjBccjszkqsc2JpMCbsvH2+JvJWYe1aOh5N3t8RcWlIQ1byRovZ1bzUrZvcbChC2icaoRn+M+XmirttH/cvpnM8GScIdAtkEJiCnBKxbJ/eJ7hNBISKFQ0lXf68tWU3pv19fMTnhJOcDLGxkyvqOMNZD5taobfKoF5vb2q7NpcCkXNpr5BukUID0xmb/mPmjWlQ02wnGgQnNPmkslKbk0wDR2t1CZw0LG4vss92zttfG3XLFKMTZNaUFqSxkeykHCepifmIjZ9E6+IALisJHcVnvyZlqRq7k01pAHRmMxvF0ZJZzKHP8VYN+bgV3ONP3f9If0ajZs/dw9BgtW3fI/5M0dWU5BtdqlJ7S7w9uuEUszpRBlbCtPEaPp28zU12wy7Xh/pCjZJtwcq/mXVPdiULvkcKKMtwyNkUFzCbGn6SKZeJwOqOxAboA2OcNlr6N003sSJbr3JU0MC3XdLOKEYIib2GpjHBaL7ap5tF0opgtZyqFzm5rqd1afuOUbf7JYipwb9Jx2StFqJ42KDIcSW0rxdq9oxGcTS4QOtD5VJ99AUnAoTd41xKYEj3hOzg0YPUIpiFs4ZukZ5M3V6dtilx4D0xjBCFg9jM4IQhqTnhBWJjhsdQa7lXf5oGyjILyCHYHiazI0qWO7FCL35J34UADwUKTUrx76EM9tOCFl0JsZ1kKvXvT4dHEztK960AMK7qIE0/Eo1LzUTYIjVGueGeaqD5LUhfDSDnzM8Vaoug2rEko6sc86j+XqH7oE/33IjQV8bzMrTrA/E1xauHmllSasWk7/V8dV1qU5HmA5WAfGpWInz4L8XTF0cvwPdANMK99ouh5roet+4lSa268GXCueZ8OOv8hF+NVIJ79q9zJeQb2KBX6uMRpCAoNri4avPyVXrggCykl9b8tImhEdNF9WUOvNyHpHniw2GR2t5M6w/sUHEqYiCDyjKFu8EGQmxKe6Uq6980Bae8i3ohS47vVU9tmfKWPUeQ+A/Z0eaItVJBMFSPz+cATzxiuIkEbgrn50InQ6lSYJDamikBDEkGRw/kgwA2 X-OriginatorOrg: synaptics.com X-MS-Exchange-CrossTenant-Network-Message-Id: fbe8876a-776a-444b-52c3-08dabbf0a7d5 X-MS-Exchange-CrossTenant-AuthSource: DM6PR03MB5196.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Nov 2022 10:05:51.1791 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 335d1fbc-2124-4173-9863-17e7051a2a0e X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: nbV16mQ5ipMUr9n6weVeaN3UaUciPfTJSQqVK8nSP6366VvUQv4v3fYPUrwqR3c8DJfkOa0SEYusQU0x7A0YWg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW4PR03MB6362 Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org From: "Hsia-Jun(Randy) Li" Signed-off-by: Hsia-Jun(Randy) Li --- include/uapi/linux/videodev2.h | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/include/uapi/linux/videodev2.h b/include/uapi/linux/videodev2.h index 29da1f4b4578..d00b2e9c0c54 100644 --- a/include/uapi/linux/videodev2.h +++ b/include/uapi/linux/videodev2.h @@ -816,6 +816,26 @@ struct v4l2_pix_format { #define V4L2_PIX_FMT_FLAG_PREMUL_ALPHA 0x00000001 #define V4L2_PIX_FMT_FLAG_SET_CSC 0x00000002 +/* + * F O R M A T M O D I F I E S + */ +/* Vendor Ids: */ +#define V4L2_PIX_FMT_RESERVED ((1ULL << 56) - 1) + +#define fourcc_mod_get_vendor(modifier) \ + (((modifier) >> 56) & 0xff) + +#define fourcc_mod_is_vendor(modifier, vendor) \ + (fourcc_mod_get_vendor(modifier) == V4L2_PIX_FMT_MOD_VENDOR_## vendor) + +#define fourcc_mod_code(vendor, val) \ + ((((__u64)V4L2_PIX_FMT_MOD_VENDOR_## vendor) << 56) | ((val) & 0x00ffffffffffffffULL)) + +/* Format Modifier tokens */ +#define V4L2_PIX_FMT_MOD_INVALID fourcc_mod_code(NONE, V4L2_PIX_FMT_RESERVED) +#define V4L2_PIX_FMT_MOD_LINEAR fourcc_mod_code(NONE, 0) + + /* * F O R M A T E N U M E R A T I O N */ From patchwork Tue Nov 1 10:04:48 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hsia-Jun Li X-Patchwork-Id: 620754 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 37885C433FE for ; Tue, 1 Nov 2022 10:06:19 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231169AbiKAKGS (ORCPT ); Tue, 1 Nov 2022 06:06:18 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39272 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231144AbiKAKGK (ORCPT ); Tue, 1 Nov 2022 06:06:10 -0400 Received: from NAM10-DM6-obe.outbound.protection.outlook.com (mail-dm6nam10on2041.outbound.protection.outlook.com [40.107.93.41]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C4A79193D9; Tue, 1 Nov 2022 03:06:06 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ewhXSV95+nY18uxbHWOpbTxULpuKaEVYumMCkQ3ONp1jg9w6LlCbmlZVFyHcwoW2kaliSwo/QuX+JI/LfJhDfGxGa+mWB5NXFv5Ny2eqAfUTwqX5uNY6nAgjAu4JT2h3i4+fkCIoLZ1ucpNgCco1TEMliZmEYhTS1UK67qoGiIEvpFvf0+SD770Z17EahCezg+Ltxsm06srGMruJ91nuLabw0N3/y6xoalkUfZrY5IOHa7HhnPsP3klsPdHDff4yRG/gJwIPK3Jjhpz9nl4RGKMjyqTw2CWwJ9+PsUxk3cq6fAYFNG/oyYU0vuqxrmfnaP4sB36ajtFWADY6ydz0cA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=Jj8X2JAuoVt7MYn/KTkonbBhmATOBWmno/dmYGJjTjI=; b=Q4sxO2xHzy8Li6MxiiZ/PQjvs/InoEty6N4GNkECAaYC3mMeWXEJQr6LZZg9GdQ2gVlPlLEgK7aaCg8dbRNOtHWL2QURw//KZbm05kYa5qNYXCPPbEBVyf3DjV60wkxz0+bRY0W0QhSZy+oMog5Kz4qei5XdlYI/xTvBfZ5Gw5uOsFVF/YCyjfjMCNm5zVLdK4ZuaaEB7VWsGT2KWM+OCOgtze8hxFuXjLqWj56OhKZVm8zql4Px0EZ5t+Q9Zui03+oIMlVI2hdsQAJxuF0D/ZAbgTqW1I4mmZxBG52rlPDq6XMYNEiot2ZxI1awDcU6rMd35VC9PqHMjNhMdRJOPA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=synaptics.com; dmarc=pass action=none header.from=synaptics.com; dkim=pass header.d=synaptics.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Synaptics.onmicrosoft.com; s=selector2-Synaptics-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Jj8X2JAuoVt7MYn/KTkonbBhmATOBWmno/dmYGJjTjI=; b=C81wPAyEm2dN+i9BcxQPjZIIZrkyP1mtSlogl95mCfo2bS6fidVAh/1qjcr8gr/5ZwbdNEbC0/nrQ4cvHQAAyLtFV9pcUAPMQYxudJZWVgeq57l4QXBkNYJ5H5p9aS8Gquzk7u9JZlAryqpOp7jlmuvz+X4Burv/r0p4y6exfo0= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=synaptics.com; Received: from DM6PR03MB5196.namprd03.prod.outlook.com (2603:10b6:5:24a::19) by MW4PR03MB6362.namprd03.prod.outlook.com (2603:10b6:303:11d::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5769.19; Tue, 1 Nov 2022 10:06:05 +0000 Received: from DM6PR03MB5196.namprd03.prod.outlook.com ([fe80::a132:66d9:ed0f:e5c1]) by DM6PR03MB5196.namprd03.prod.outlook.com ([fe80::a132:66d9:ed0f:e5c1%7]) with mapi id 15.20.5769.021; Tue, 1 Nov 2022 10:06:04 +0000 From: Hsia-Jun Li To: dri-devel@lists.freedesktop.org Cc: airlied@linux.ie, daniel@ffwll.ch, ezequiel@vanguardiasur.com.ar, helen.koike@collabora.com, hverkuil-cisco@xs4all.nl, jszhang@kernel.org, laurent.pinchart@ideasonboard.com, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, linux-media@vger.kernel.org, maarten.lankhorst@linux.intel.com, mchehab@kernel.org, mripard@kernel.org, nicolas@ndufresne.ca, ribalda@chromium.org, sakari.ailus@linux.intel.com, sebastian.hesselbarth@gmail.com, tfiga@chromium.org, tzimmermann@suse.de, Randy Li , Hsia-Jun Li Subject: [PATCH v3 4/4] media: docs: Add Synpatics tile modifiers Date: Tue, 1 Nov 2022 18:04:48 +0800 Message-Id: <20221101100448.66712-5-randy.li@synaptics.com> X-Mailer: git-send-email 2.37.3 In-Reply-To: <20221101100448.66712-1-randy.li@synaptics.com> References: <20221101100448.66712-1-randy.li@synaptics.com> X-ClientProxiedBy: PH0PR07CA0027.namprd07.prod.outlook.com (2603:10b6:510:5::32) To DM6PR03MB5196.namprd03.prod.outlook.com (2603:10b6:5:24a::19) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6PR03MB5196:EE_|MW4PR03MB6362:EE_ X-MS-Office365-Filtering-Correlation-Id: cd0cd50a-1852-4a7c-9024-08dabbf0aff9 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: PkdjGMztzOGVzQli/RLaPuR7/KfEZfWDFL1fWdPjghWEWT6goXtW3nx+DRSi6iLhWIlaE5e3peBtNDXz3H8KW3+TaC531/98F5d0ApkKBtv9d9fxwhQwkAKVpY5jxQCZhuA9t6ru19NgrDrx7tvXOr3frPvXTzBvaCV7pHt5ZnKmOR0/pqJihuSQoYOCunSl8pzvJGUzrzYo/jA1qBInxv3Q2CziYwiKKcRBMROgCUiKoIe3xl/0JRob97WHqXFU9X3f0KggsjkJPVLmNSIyPsW2V/0TTxjHj/QVJA2+h9TOA9D23y2+27A+LVzdztnFPYNwZczW/IF/sijxrgDxMq2jVJTreJPEypWKE7sDAgFxy98ka66MnppY935n6nOTWZwM/TCGTe2t37PkyzwVmholNSbMfHMCMkxHnqRKOe3tdj6dAoNhHgtJyhkd57X96CNhHN5iDmk+se5WaceuhVep78O6ao52X/aJZxIEvrcnYHbsw4Zj1I8iPan4GF/DEZs+ZGny58e0WkdW+4eda0xMR6fSfFeCPTVoiTx1Dno+AtELXDpBpVQQNNq1fuAp1lmUk9oHs9mS/R2SevlDGRLl/GmKai1kXEjmXn6rmJCOG9qF/e7p+GBrCaSxnCZBX6ZHy+T5Cb379O/4UJIRW+2Sq6Jq0hjTSaowvA4hyc1+v2SVOnAVakEr2PzrQz+TCsW8phXlE9zfmUkSRhmrJSEr5enPH5ubhEQ7JAnPT7ic2vz7Gyqjh0wI4VIr16Bn X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DM6PR03MB5196.namprd03.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230022)(376002)(346002)(39860400002)(396003)(136003)(366004)(451199015)(36756003)(478600001)(86362001)(6486002)(6506007)(66946007)(316002)(54906003)(6916009)(66476007)(66556008)(107886003)(4326008)(8676002)(6666004)(52116002)(6512007)(83380400001)(8936002)(5660300002)(26005)(41300700001)(1076003)(2906002)(186003)(7416002)(2616005)(38350700002)(38100700002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: xiEZ0dsLmpDHMJJi3776Mn1OmjCOWRZhpCy3CxEJHm2A3HffBl2b4JZmDlBVDWtxpoK9G7CjWSB8ivn3QrH8Z8FOTXXftzm+uZHiUTVjE2/VzN/8i2IJl40Rmx40O+p61j9q6G41LC2RxZbxeqEwbCERLxEPAWMARp08yHSaOxA2CXAJ8aENJUjE4oi4obhtv//NgLkC9j35/egVwPElYaobvQJBfnOXQNxMjffUybFCHqULW9kUcNd18gSC6+3kcDw2tEdl70sbXceA4wyPj6jyZfJwKSUlXwKwr829Q8GUQFee4p+2xj3/dVIhhHK24jJpn9OE47k4SX1hawZNh+454bYbjOP69CvrGYufLEbz5hxbjhwBqvXbcHfbp6qRPMNv8i9aXJbLliArkwi7+QtzOvhCqlAULwXQxa/gni7GzXWiQ2nMRc03lcL3XkdJ6e5ASv5kn04xbXH2OdWBHoU5svpS5bepfpGQ4lAl/r8D8kixfLRQlLSb89WadBTJ8jGwp6GcOZChmQ5s61JhdFi5g482E3k5agoiGVcdQPV1QMU6oh0JtQqyI4Vbz0tiYyvjOiM+Zy/xp8zXNn5M5+Xv96PoNXv6vMmnpD2vrOzD66p2sITueTH/G3jRKqnG68/si3MR85A0zPotOb/Pb3Rp7AQqMccJvmv4sM7cUYjwsI3/r5Wgd2kNqz9ETPVhAdV+FlNwt18mVtv9e2CXPR4Y5RIdDvpRAQBzaTU4jy1GJ/vSelU7wV7vTh4Ym+NQSqyj2UJtdcfKgYbrAwOvcgRkkhCUIu42A+z3T8BqIxg8Neuz0Ce4qTLsW1yjcAkSbKZMhIoYiNbd4vtMM9AwfFDiRU6SofSAktJFKifs6M0znJxw4BMGluu481DvtetG6zY0yv4RIM5bIy5yUTq2sHYlD3MBOd664VARLHvrMRQyOebsVURO872WEEP5n+pdR6kvbuN4Xxavzg4BeFF+jne+HQEex/TyK73be0/+Df6AtqPFgSxIpuK9/E0yBQK7Gs+lXp1cEQr75n9I+Bj0mNnRBvWgWMsOBf1eGrQBJbnkARypbrkxs89mF2GzpyQAi+4Bnig+rVGYWsryi/ZNbTzEiYNqFsnUddD4p3/UAAoldKSmd5/mlXm/r9PRGY5vrhRSPjUN/AgAUvheQ2ZiCXe0qiBjridUJ6sVB7YVr+pnhrJuDwYcWyWchBJHQcNOyH+LZ1JZfX1q4/tXHxgCj5UOahnijib6ghUQjIUIcWTS4UYfJNuRveuYNrY4DKrxQp44vMxj/Gscu2puNWDIuintq8MHAfTMk0ki9ygSqAk7sxs63ufg4KJSJdjO78bMx6jGFoW3hXbZsQG7RrCtPyjJS7br6qYYJqAieIA34GLV4BNJwatt5rXv4NI7s8RBAiDCxRy1FZCtm9iZtwY+uaJooII6DbqWneaIByyoY4Pvg7nl4ujkNRvMke46NuFYVvgc8qiK/4Zzb1od2bywH0rHc+oBj3vlZ1tPhVpvQDP8ElgviO710lVD82QWJLL3Bho89xdO4dDV5Jb3Zqt6cpacK+S/A3j8FwzMr0bDkONADd2reykPzhC/uZglB9lH X-OriginatorOrg: synaptics.com X-MS-Exchange-CrossTenant-Network-Message-Id: cd0cd50a-1852-4a7c-9024-08dabbf0aff9 X-MS-Exchange-CrossTenant-AuthSource: DM6PR03MB5196.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Nov 2022 10:06:04.9009 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 335d1fbc-2124-4173-9863-17e7051a2a0e X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: GIgqwqd9U/luus+kLaZdlRcZ6JQOlOCPKegv60VGsP47uI9GCRb6fc1rZoi8Ed3D01o1reWHoWsJQrgSlJDRfw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW4PR03MB6362 Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org From: Randy Li The pixel formats used in Synpatics video smart platform are too many. It is impossible to store them in fourcc namespace. Signed-off-by: Randy Li Signed-off-by: Hsia-Jun(Randy) Li --- .../media/v4l/pixfmt-synaptics.rst | 86 +++++++++++++++++++ .../userspace-api/media/v4l/pixfmt.rst | 1 + 2 files changed, 87 insertions(+) create mode 100644 Documentation/userspace-api/media/v4l/pixfmt-synaptics.rst diff --git a/Documentation/userspace-api/media/v4l/pixfmt-synaptics.rst b/Documentation/userspace-api/media/v4l/pixfmt-synaptics.rst new file mode 100644 index 000000000000..edf6525a3ef4 --- /dev/null +++ b/Documentation/userspace-api/media/v4l/pixfmt-synaptics.rst @@ -0,0 +1,86 @@ +.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later + +.. _pixfmt-synaptics: + +*************************** +Synaptics Pixel Format Modifiers +*************************** + +The tiled pixel formats in synpatics video smart platform have +many variants. Here just list the most widely pixel format modifiers +here. The value here should be the same as the one defined in the +``drm_fourcc.h`` file. + +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.5cm}| + +.. raw:: latex + + \small + +.. _reserved-formats: + +.. flat-table:: Synpatics Image Format Modifiers + :header-rows: 1 + :stub-columns: 0 + :widths: 3 1 4 + + * - Identifier + - Code + - Details + * .. _V4L2-PIX-FMT-MOD-SYNA-V4H1: + + - ``V4L2_PIX_FMT_MOD_SYNA_V4H1`` + - '0x0b00000000000101' + - The plain uncompressed 8bits tile format. It sounds similar to + Intel's Y-tile. but it won't take any pixel from the next X direction + in a tile group. The line stride and image height must be aligned to + a multiple of 16. The height of chrominance plane would plus 8. + This modifier current would be in conjunction with ``V4L2_PIX_FMT_NV12`` + or ``V4L2_PIX_FMT_NV12M``. + * .. _V4L2-PIX-FMT-MOD-SYNA-V4H3P8: + + - ``V4L2_PIX_FMT_MOD_SYNA_V4H3P8`` + - '0x0b00000000080301' + - The plain uncompressed 10bits tile format. It stores pixel in 2D + 3x4 tiles with a 8bits padding to each of tiles. Then tile is in a + 128 bytes cache line. This modifier would be in conjunction with + ``V4L2_PIX_FMT_NV15``. + * .. _V4L2-PIX-FMT-MOD-SYNA-V4H1-64L4C: + + - ``V4L2_PIX_FMT_MOD_SYNA_V4H1_64L4C`` + - '0x0b00000026100101' + - Compressed ``V4L2_PIX_FMT_MOD_SYNA_V4H1``. It stores 64x4 pixels + in 1x4 tiles. Each plane would request a meta plane (MTR plane) for + decompression. A MTR plane would have a 32 bytes parameters set. + * .. _V4L2-PIX-FMT-MOD-SYNA-V4H3P8-64L4C: + + - ``V4L2_PIX_FMT_MOD_SYNA_V4H3P8_64L4C`` + - '0x0b00000026180301' + - Compressed ``V4L2_PIX_FMT_MOD_SYNA_V4H3``. It stores 48x4 pixels + in 3x4 tiles, echo tile would have 8 bits padding. Then a group of tiles + would be 16 bytes(128 bits). + + Each plane would request a meta plane (MTR plane) for decompression. + A MTR plane would have a 32 bytes parameters set. + + * .. _V4L2-PIX-FMT-MOD-SYNA-V4H1-128L128C: + + - ``V4L2_PIX_FMT_MOD_SYNA_V4H1_128L128C`` + - '0x0b00000077100101' + - Compressed ``V4L2_PIX_FMT_MOD_SYNA_V4H1``. It stores 128x32 pixels + in 1x4 tiles. Each plane would request a meta plane (MTR plane) for + decompression. A MTR plane would have a 32 bytes parameters set. + * .. _V4L2-PIX-FMT-MOD-SYNA-V4H3P8-128L128C: + + - ``V4L2_PIX_FMT_MOD_SYNA_V4H3P8_128L128C`` + - '0x0b00000077180301' + - Compressed ``V4L2_PIX_FMT_MOD_SYNA_V4H3``. It stores 96x128 pixels + in 3x4 tiles, echo tile would have 8 bits padding. Then a group of tiles + would be 16 KiB. + + Each plane would request a meta plane (MTR plane) for + decompression. A MTR plane would have a 32 bytes parameters set. + +.. raw:: latex + + \normalsize diff --git a/Documentation/userspace-api/media/v4l/pixfmt.rst b/Documentation/userspace-api/media/v4l/pixfmt.rst index 11dab4a90630..738a160a4c41 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt.rst @@ -36,3 +36,4 @@ see also :ref:`VIDIOC_G_FBUF `.) colorspaces colorspaces-defs colorspaces-details + pixfmt-synaptics