From patchwork Tue Jan 7 05:36:22 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ming Qian X-Patchwork-Id: 13928254 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 bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id CA9DAE77197 for ; Tue, 7 Jan 2025 05:39:43 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:MIME-Version:Content-Type: Content-Transfer-Encoding:Message-ID:Date:Subject:Cc:To:From:Reply-To: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References:List-Owner; bh=H3MP6JHmlaNHP/7AavyUg43Yw7XKOwSWm6Sy658nX6w=; b=QDiR6dFqIk5ZETL0374zVLKc60 wsdKMIJLfP+x5o1oZygRuiEr4qnuGRF5vUaVLR0sn2Sd5vVjUc4xmoyO0k82idnSqaUV94jpdJqkf NsI/JWzouHVlz63AOlPiGypz62GkuH2DdRECwBVK2+4NCC7em288A4I2TsXiGqv/5My5VwXl2du8+ 9raucPHG+N2xklj9ZQec3KjrgpBEwiqdzSp6Gik/3e5mBvW9aD/svECHpKzRZNLUJgLPgAZalPe4/ +ky/e7VeWMP1iDPxYyLDvs22jlF7ciNfutEb+DsuW+scKkjr7A0tbAyoGc8NRbZusyPHDC6p4huzh FHJv9dmQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98 #2 (Red Hat Linux)) id 1tV2JO-00000003Z8X-0auC; Tue, 07 Jan 2025 05:39:30 +0000 Received: from mail-vi1eur05on20602.outbound.protection.outlook.com ([2a01:111:f403:2613::602] helo=EUR05-VI1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.98 #2 (Red Hat Linux)) id 1tV2Gy-00000003Yrm-2eYa for linux-arm-kernel@lists.infradead.org; Tue, 07 Jan 2025 05:37:01 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=WHeIqblt78PQ/VR4rCZDoXdY+pNntDdSPW0HQKRmXXDb/H4Kv7hbqa//ihPJArL9Kv6ck1MyhYMeJ9uxzjEh34blIM0Po6gBz5BmAB8b9z5380GXM5ec3i8s6DdE25QVM/M/xgl9Gs6d8/DKFzWcbSLEV0PkYtfMMB3vSGE3lAFLGod0fYFOFOwnsHXAFojHm7nfM/2467ddjqZItwHEzbNUK/KTOz9tywFAlv0UuKKGcgSTnobWm/sVHzTgK64XzYhNjzZ2wAgcq9Y8ut8xNZaBMLA8mG7o4claVX7J7pPPcArZ4ZZdkyqF7BLEm3haQv9fCsJ/Jid1H0kz0r6ofg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; 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=H3MP6JHmlaNHP/7AavyUg43Yw7XKOwSWm6Sy658nX6w=; b=x+0z4n55GETMnwnGtJEQD1oX0Ugvw1bdZpvxzMsdOWMADtr/nlz6gNCEJgIbLs+6U621QeISpPK6I/PvrQ3XM2jNXg/iraohdKP6VBzwYtLMyqFUso3+rGGJrnw2vturnJvcrajFaRSp2Q0h3kaA1Ur3AGy9Du29PBLYpV0Cguv9xr0TU484OV4pr+rj5sROX6QwiiWudS6R3Rgrihkp7n0/hwUbTS25VmWlbk00o4jCSOxohUM1KMhO3za3b4NAxnlmUkbaZUf/J0bzGVuquHbunGEYMJVM4dt2Fv6m4tgI9igacCcAyHMTvAj6STCvoTLx+ePvGf+NyteHJS+QJw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oss.nxp.com; dmarc=pass action=none header.from=oss.nxp.com; dkim=pass header.d=oss.nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=NXP1.onmicrosoft.com; s=selector1-NXP1-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=H3MP6JHmlaNHP/7AavyUg43Yw7XKOwSWm6Sy658nX6w=; b=WhreyhTwrhFkadO089xvRYbrhSWTu8YRx4HVWDAh12w3Pu73qsvPqlP/tk49ekSf3uH/0D9VUvjBr2JPMDfiBfppUrl/ujaOQ2rIE2qM35SaH4mftc2+SPUG8u/gwuXMZeEAJuQG8TEQVazS89rZ0sMRtIMSVJKJIrJ57dhk7hwL+0jZjDYQk5LZMmse0Sk1t0B3Dvd+QMD3yN6ZHmUlLBHoSfryCQ21xFPNCcQVsnxnclaTln74LQgBw+mYsk0rvCvD9KuZ9yvjsXBBjXiVbbo+zKU9z6ejJBzQjexUO+Jxc0d/dUCPyrSTterr5QV7CIO2di9YUma9SFWE02GCpA== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=oss.nxp.com; Received: from PAXPR04MB8254.eurprd04.prod.outlook.com (2603:10a6:102:1cd::24) by VE1PR04MB7342.eurprd04.prod.outlook.com (2603:10a6:800:1a0::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8314.17; Tue, 7 Jan 2025 05:36:52 +0000 Received: from PAXPR04MB8254.eurprd04.prod.outlook.com ([fe80::2755:55ac:5d6f:4f87]) by PAXPR04MB8254.eurprd04.prod.outlook.com ([fe80::2755:55ac:5d6f:4f87%6]) with mapi id 15.20.8314.018; Tue, 7 Jan 2025 05:36:51 +0000 From: Ming Qian To: mchehab@kernel.org, hverkuil-cisco@xs4all.nl Cc: nicolas@ndufresne.ca, shawnguo@kernel.org, robh+dt@kernel.org, s.hauer@pengutronix.de, kernel@pengutronix.de, festevam@gmail.com, linux-imx@nxp.com, xiahong.bao@nxp.com, eagle.zhou@nxp.com, tao.jiang_2@nxp.com, ming.qian@oss.nxp.com, imx@lists.linux.dev, linux-media@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org Subject: [PATCH] media: docs: dev-decoder: Trigger dynamic source change for colorspace Date: Tue, 7 Jan 2025 14:36:22 +0900 Message-ID: <20250107053622.1287461-1-ming.qian@oss.nxp.com> X-Mailer: git-send-email 2.43.0-rc1 X-ClientProxiedBy: SI2PR04CA0013.apcprd04.prod.outlook.com (2603:1096:4:197::6) To PAXPR04MB8254.eurprd04.prod.outlook.com (2603:10a6:102:1cd::24) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: PAXPR04MB8254:EE_|VE1PR04MB7342:EE_ X-MS-Office365-Filtering-Correlation-Id: 6f48b2fd-02b6-457f-368b-08dd2edd4951 X-MS-Exchange-SharedMailbox-RoutingAgent-Processed: True X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|366016|1800799024|52116014|7416014|376014|38350700014; X-Microsoft-Antispam-Message-Info: wdl/uYWUxJuEnHf1CL9Rhqyemi1I16wcpYbqEQ2oAlU/JOIJN735RrayIrd8ppPiYVmktDAtalBl3kmucudXYhCoc1kcyyegJ0HBKQ8e4DtJlEv45ywCqgqxOrERG8cJTkRt2Gyu/iSuFgsDp34yjb4tUFuuzsjHVhMiKoll27pIfVnZOb7uIWX9c0qCSJDE2eP/YwkJB5YSU3sSDNJCflNvkSgRVJeEbwZRqdkTL4UtzVMZ6wXeynwHfMV3bDqYtJv0i54Z5NUrQHlwWiA+E6AfHutgTq2qw7e+Ht8e+FuLgVbgZDEIZPxocceh50lgr1jq43wXzBwpVbpfBTWuPkzvunSetH0sSI1Y7rqy+O1sSJlIke7fMSEPFMpWvZKbgLUsSGtvKdXml0TzZfsAmnXY1BV0ey9BsBxGCG1Pu8AfPZg4lrm3ww2ZXZMzd5tpJa+0SVpJIz0HO0X0OBy6Sv3iDO8ZY1eamIIVx266WJ0kcD8kULlZeRUoMK30sSXJbBiAEdCj6OAhSoBQIdWNmDZ3P+gLE1lfZ5T1KSQK4V1R/3+S8jrWnZSSEOrodz4b0CHuXjNvHTq5rleI69YZuygDHj6WHDBOfXzjad1QdMpSdeftOvD9efmFH5WOH6HMbMyuTlMOb/AmFfvJkUNOY4gfm55q6WtRG+RMKQ9/ENi5Ynkv5XXn1IaEMZQEQswcnT1oVXtyyYGvAIklKUiU49eva13OE6ERKPuid0dNxmt2sl73OCvYU1MRdQXE17feNDHBT9FnDSHMeUuwIZemttcb9gCGm9CcDpNv8hy59LCv+teTSB7qrpDw3BZauGuoKWbVKMrpltYWAaIJ1Fa4pWumcZO2Gr6xcxIriA6k7cvHWAxK1tYEQQz0P6gReUNRX4iRiUvccATxWLFl4GkA/IWxneM+PMSlUWkYzjGiQqGcBgIgcodmjkCra3OpEKOvvV/4mhwZrmkbAU9DCox3Tmfs5KpnRxp5ZnnYz3Jlx98tryw3EgRl7miB5F3a2o99OXtDyA1f1caiOa7cf3f0SMQQX/U6TM93ra9BUgeBQLcm27GsFPyHft2PnHk3B7XtM8e98kec7zy6upamCYLxlNqcphC0r1YUf7GtHDslpZv392b17f8F10c5cc7qPbz4T+HmAesxFzNL43j6H+HWNU+DnxMmqFs+oMWqaT5gzAQS8cl4LbrMd+ZTG6sAtOauUU4xUVcZkYBQKIkGFDJNyS+B8zF8CPH2KC1kcoV9Fq/sJSqpjpeT73duLaU2DiZddmSIJOhObtevRN3a5f4Ff0dWHbVwOpKz4tQj5Sev9oHK8F3oVi81tlTNlkS6PIGiCdlSzeFy66FL6jMxIyQi2N2h7pGUk9KpedSeUWHR+N5l68yRBskUpbdL/8p1EXp//G6EB7m7WghzxjXVOjjhJshxSIvZImOdvYhpCvIzJHB32Sf1dcuCu2mEhq1U8Ie9 X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:PAXPR04MB8254.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(366016)(1800799024)(52116014)(7416014)(376014)(38350700014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: xo7rfFGF9nKSzP3ewVAvjuFo26N0xrBhh5LSNDOiWmGqbQYoL7cuW/oDIDyeIs69WpyEkrICCcK9+TDKoSPjSHabJTfjr34AYuHGofYKkQbm3HsxlLE3WNCyXz7lmDs8cEFF8FbdRAGklbtlrAHxgSySzR2eF0fHdRDWsd3qCo5TVTTroaM1YV4CpUbg19lRJppPL+lCdHt4VrBqKJOmst0A/eUQVuPF+omq/NUl97ombotiRSBpw/ChoHTGL1+6zlR0ShbeJcIDPkyckjY64+YAqNA9pQbt/TCQYAPZyrROP3IqLbmGujgm60cnXloh0twzp5Ha9wyOCHyJLNNUFaIZnP1YrI80uPqkeABjg1zGMxoh1rUTzZs8A2dbT9H2FyuI0yHubN3O06x3KZcQKjtdM6iIw3BoGqoZ1LMYylOaLW7ezuaIhuWngUQ66OaKmNuLJG45E4pUWcVz3h0Rigq8jtp+FIbBcB+twLzJXC+tyUXuZJFeDZspGQbuIB/Eqp6I+d5W5k53pajVtUyHp2OHuFN28caWxrNL+qLnDtgj6dgQfOZlNJncrE7rl6DB9a2kS0hgrs9514PxElsj48qxppN+KFpsdwNDSuZuXunWfq4nFosol+EQHCjrvg/O6Xae0pmXEVCbCbCpA8OQbncgrC+saI3S9V7qnRQQachqK4i3rgPzm+O3ux0ObbAxkHza5j0UYrBOW4gCELftaHCooy9GlSHotzeibq0vpRstuDr1vVv676Xj42T01RKsX7Qr6u05TwZseUkpm/Tjq/8TQB2RGdmhSFurRIveW88cD8fdWNjbjRIj7OEFPNDIpK6pcrcVkVyVyiZSIdjhR3A5MDGMEW3DWXAcPqQWiJx6LMUkU3/mUXPpR+3Txfi/YzFQHKOIEwEEU27H9taOa7pItzE961z2OrU8o6ltyuGqIzo9QQP6ivPOUNvdWdOsZHQD+4ouy4RLNgXcKvsk0/G9sn4bzMg2/vEHynCpJqX8OpFR4nsf2XNrytKhiQOQw/Fi9Nm9Y7u/QyG9gMXX2CHjH0ar3wYAb10gE0vuIB2FSb5egld+weVrPRpVcY5Vb2fbkJF++qBFpvawuLeo+2BCIOnvNmeVp6BKpIiqNKRKKYn6FHyqF7ay3A+yPwVARTYJcftn0ybgu4rRkUzSBMUrOVs+KaPjO8IO1eEz3fu3cdi+HUsbVVOZ5+5y0pzzfYZZkih+pVYHGni1Vaqr1QmWIUsNfQV0oPA5OHR8oHDqJIQcVBokRfjpLqXTFd/Bw22j/aSqHd1gAz6mpJSqyjHrECa/L9qmreqnKvYbn6UsYlUQRCOVDQr+RRqcMlMfhdsfh4iNziuI24WzlZgTBR6whBhuizZnCsQgcefmT8S+WVZPvMBd6EkXr8Hd4QpdrrZNmVptTNRc81Fo3SjE3FeMjvJ3gjL34eJFZLI5nNlAtT0J3l6O+qG1HJtr8kVsLH8XOaXDXYD6PConZLkVLQ5xG9n7uCYzuDTvTFV82srzaUlHenDosr3clKVbfeAelCiPu/GztLZJT9eyMKBNJlEtN8fC1sDNqnfJZFMAMMdC6PTRzb4E0okUkUdf6PVJ X-OriginatorOrg: oss.nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 6f48b2fd-02b6-457f-368b-08dd2edd4951 X-MS-Exchange-CrossTenant-AuthSource: PAXPR04MB8254.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Jan 2025 05:36:51.2076 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: MMw71jwrBr3wVKHycR1ox53QsLlvG/6Clvbp2MbqJ2NsHoSyWDwKmkFyxJnfbaTqJA8SsL0h9A2PpZOKxuZydw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: VE1PR04MB7342 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20250106_213700_670526_7658030B X-CRM114-Status: UNSURE ( 9.70 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org If colorspace changes, the client needs to renegotiate the pipeline, otherwise the decoded frame may not be displayed correctly. If it can trigger an source change event, then client can switch to the correct stream setting. And each frame can be displayed properly. So add colorspace as a trigger parameter for dynamic resolution change. Signed-off-by: Ming Qian --- Documentation/userspace-api/media/v4l/dev-decoder.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Documentation/userspace-api/media/v4l/dev-decoder.rst b/Documentation/userspace-api/media/v4l/dev-decoder.rst index ef8e8cf31f90..49566569ad26 100644 --- a/Documentation/userspace-api/media/v4l/dev-decoder.rst +++ b/Documentation/userspace-api/media/v4l/dev-decoder.rst @@ -932,7 +932,9 @@ reflected by corresponding queries): * the minimum number of buffers needed for decoding, -* bit-depth of the bitstream has been changed. +* bit-depth of the bitstream has been changed, + +* colorspace of the bitstream has been changed. Whenever that happens, the decoder must proceed as follows: