From mboxrd@z Thu Jan 1 00:00:00 1970 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 87286C43211 for ; Fri, 26 Jun 2026 16:48:14 +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:In-Reply-To: Content-Type:References:Message-ID:Subject:Cc:To:From:Date:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=q9Kv0HID05uD+/9pA+QYi69vKrN+E0P3YTeVMde3kEs=; b=WejxmWOQ0n8On9y2BZs/WIE7+1 YUDbzjAicfBDFrSH+w3PH+38c9oeFDliFqC7K3Et4uNdMWmmEly25qXNwSv8XA+4wer3RK+CNNbOa QbjY8+mGQKWx0xQ3ow2rTZVvCjPyXE1/qfFD7QKX6bqxsF37/YKr1+7mT7FvyEPtJXkbOAWsVucUn 538YcDJqK9BSO5dVjC3P0UREwYlDUz26a+MyPvNAiAs1aETzHsxixH4iBKxsqkDfGXAFzf+OBOUi6 nlCafTeR6I5E5toZDIbi3rGqpiqfIzLmWva4K77kJO1cOmoPZ8qmSE0xJLQM6JBqrgjiD1qE7ttOl pRYWidbA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.99.1 #2 (Red Hat Linux)) id 1wd9ip-0000000BeZz-3bMh; Fri, 26 Jun 2026 16:48:07 +0000 Received: from mail-northeuropeazon11011016.outbound.protection.outlook.com ([52.101.65.16] helo=DU2PR03CU002.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.99.1 #2 (Red Hat Linux)) id 1wd9in-0000000BeZA-3qDB; Fri, 26 Jun 2026 16:48:07 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=ep0mRc0XuzwjrBkwBzlwbEZugeXUP53bUtuw6644DRlKFq8OSSa/0HU9r+ABbepiS05ejtPp4OlzMGIwKI5xLb1K+o1qIJuBsr03RRg1IQVZ7VyAnOmGguByLHjkN5tzucsXctoFXHkHRoUCfQQvQJXvf57rgSIUqzpoKtGPLYqux2hFzTqJafNir7f70IFjYEUjfRaNeSDsGV5gZkTMyPixmOqYM/0O0ZUUnUhl8v+8m2WJsEjEPKuCfJigiE6UBJvkITMDEzjykHyn8AFB9/OtrAkxQ/CXEVqjAAUPnil3uuyL1HujN04zOOb9XyFr4pz7EzqC2jd/R8bnZ1AWTQ== 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=q9Kv0HID05uD+/9pA+QYi69vKrN+E0P3YTeVMde3kEs=; b=kKSU95+Fp4m6IegCOvjNj/ZMPTboBanP2d/+k41M5gAaSYZYFRc3AgB0d3JsDLUtgWpxo/imq2vWOLvQt0XZOYWsQ7iGc1P1z81F1UXLn+g1Eqp2dM8HID4l60uNT3LSWVn+QJ6GMolO1ZGUR7cQbveCjlk9eNR7LLvWDmcPukCD6ojE6wpccRSHGyZQHkS4bteOWWYbjI8rTyAA/VcG7CGvrOjn8fKt/vHttk3TCvjEKsqw+600fO57fLTiOvAkcA85QjQEQUyOeDpXSHwcIaPcNT3iK4IqAXDdd1Mgyz+0m1MwGqVjLBgJg6TnvfIeSH+MZkphrKiUHMxiuYym5A== 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=q9Kv0HID05uD+/9pA+QYi69vKrN+E0P3YTeVMde3kEs=; b=FXCb4lu40xhdjwfYRzzsCW1vJyCowpVpQ6bXoBdbOS0MBJXC2WtDyaNMh/OlEL38ADvCa5aWriCWBnGtIEWHUdw+YetIiBQ2/kcha/P0PhZI0rR/D3Tmu6osQnbxsH4wPYrAu1/BsEWxfS1HZ9FTis4h1a4sLu/meNChFlHyvfuwfr64A6RRnyKjfOnLHQcjEhog3HT0Sht1tmrsN4uevWQu2XWPlmMkEn9Jo2iFWgGjRzLW38PKjRo2mqgqsWWqw19TWN3XnmqYFMGLxFgdcFjinDilaP6UW/Z5LpiwYODEzzI7VHvdSCiTbn7lfggpybbevlfu2A2tZuWVQbN4eg== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=oss.nxp.com; Received: from GV2PR04MB11799.eurprd04.prod.outlook.com (2603:10a6:150:2cf::9) by AM0PR04MB12099.eurprd04.prod.outlook.com (2603:10a6:20b:747::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.21.159.14; Fri, 26 Jun 2026 16:48:01 +0000 Received: from GV2PR04MB11799.eurprd04.prod.outlook.com ([fe80::2146:83a2:5329:b7c]) by GV2PR04MB11799.eurprd04.prod.outlook.com ([fe80::2146:83a2:5329:b7c%6]) with mapi id 15.21.0159.007; Fri, 26 Jun 2026 16:48:01 +0000 Date: Fri, 26 Jun 2026 11:47:46 -0500 From: Frank Li To: Kieran Bingham Cc: Mauro Carvalho Chehab , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Jacopo Mondi , Sakari Ailus , Jimmy Su , Matthias Fend , Mikhail Rudenko , Daniel Scally , Jacopo Mondi , Michael Riesch , Benjamin Mugnier , Sylvain Petinot , Laurent Pinchart , Paul Elder , Martin Kepplinger , Quentin Schulz , Tommaso Merciai , Svyatoslav Ryhel , Richard Acayan , Thierry Reding , Jonathan Hunter , Frank Li , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , Bjorn Andersson , Konrad Dybcio , Geert Uytterhoeven , Magnus Damm , Heiko Stuebner , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org, devicetree@vger.kernel.org, linux-tegra@vger.kernel.org, linux@ew.tq-group.com, imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org, linux-arm-msm@vger.kernel.org, linux-renesas-soc@vger.kernel.org, linux-rockchip@lists.infradead.org Subject: Re: [PATCH v2 2/8] media: dt-bindings: video-interface-devices: add video-interface-devices.h references Message-ID: References: <20260626-kbingham-orientation-v2-0-47178be927b4@ideasonboard.com> <20260626-kbingham-orientation-v2-2-47178be927b4@ideasonboard.com> Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20260626-kbingham-orientation-v2-2-47178be927b4@ideasonboard.com> X-ClientProxiedBy: PH8P220CA0002.NAMP220.PROD.OUTLOOK.COM (2603:10b6:510:345::6) To GV2PR04MB11799.eurprd04.prod.outlook.com (2603:10a6:150:2cf::9) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: GV2PR04MB11799:EE_|AM0PR04MB12099:EE_ X-MS-Office365-Filtering-Correlation-Id: c54bbe96-7484-4990-cf95-08ded3a2af48 X-LD-Processed: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635,ExtAddr X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|376014|366016|1800799024|7416014|19092799006|23010399003|22082099003|18002099003|20046099003|56012099006|11063799006|3023799007|4143699003; X-Microsoft-Antispam-Message-Info: ALSPGvUStmf+oc4/z7nIzNXbtfElUHxCpfCVOdgnST+VqNP4ElXSu+GoAInU0pbKtXlbNIOGb2+Lz2R5GZPvWGsWrENSL88+ZP5GWGuIjvSPhMgBe1Sp6w2y68VpJirTYqyyc4tA4qBoFH/K0WGPtAWAm0ODwnHq1QBw6tNSIu51NeinFO+HSbuoDInI7wDb2Ca+/Qtq+0BvsACsk0MuowTGPMHfr7fBZ6m3fC6DV+ZC4UxgRfM+uNo6KzJaNUuwxiLFBs2dQMyRDYD+x7gG+hs+S4W/rE6zfirdCGp5ZVKrs4Uzlv3Fu38JXdEEP261cvfZMJfJjCZcQFpvj7NgRSQrvuN7iV/tWftlRZNgvU6PyJubXJCJhwlHPAQWcE9ICqFEgDwjzRlh4thB/ZfZj6dJRpGoacSnmt6ISNk+6G6epZOuEn64ZOQncnaRCTiQizewwsdsl2dHGXyE9e4zSkkPCPtH93+/6kU/R1mVNWxlMUbQGRxrtPdzFVe2RCzfcPv2khkHiPAr8XrshjQhgul9oRvbSlU0ksyeXpZDx7T1Vqio2G3vyfy76pJQ41g5wX3lKzoFZJWr6qgo1RFnpM7RXYXYtPxqqkkMASv2Ez0lp8ZxmKydFeLbadvbMLYGDKCmHeteqZQjtEXLEE1TFy/XjlEKzGu+sGx5KKLJdYA= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:GV2PR04MB11799.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(376014)(366016)(1800799024)(7416014)(19092799006)(23010399003)(22082099003)(18002099003)(20046099003)(56012099006)(11063799006)(3023799007)(4143699003);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?0Wn+G5ni6AY6rUCI9a4oUIzPU9yC91debal6rSQmwjJLA1kvSWIVihuAsn7u?= =?us-ascii?Q?m1qWFiOB5EV+guArKySCOJ+nR8JJeuFY1MMLrLkMnsQjtxC0IZcr8TVQ67q4?= =?us-ascii?Q?ReQyDRpYuWCnWhi/uHgC4UUEBD39Z17sdpEQnnmS+/HWdtvlXrMlHm4G4qVm?= =?us-ascii?Q?eSzokzJYp9f8UnfxdlcyLo8sZuh1FqPW72EvwTOaPOB/0CmkVnxmSrL0bi6T?= =?us-ascii?Q?oYwJo8aUy7Dj6fqvikZDygEYxrEudPa8YpVkL48+1PnNnW6EQOXba+fhjbbh?= =?us-ascii?Q?9EI9SA94tFORdCjyRUQZF845dPf8R+ZWd31ORitmmTK7b271UQW8uVJstKA0?= =?us-ascii?Q?+62c/qu8wpE3EsZK/qNkEYb6C4L8iVT5+uuG8ZB8F+edE/CEw+3b0VefrhHA?= =?us-ascii?Q?S0bBiFowPqVkwMzhBWQ8DkKQzzNQktyS2M+Rrh9YTVfl1ap/XlaaQpejObVn?= =?us-ascii?Q?qqMJy0cRzrvAobt6CDPiynVXaC5WRV9fuJNtmRn00MwUFJvivuSKN2fpC5gm?= =?us-ascii?Q?xNPB8MBWtcuCdjPe2LvBZqLRfXdMSU8bLaUNQ37I/BNWP6F2EUNEzELRYgPD?= =?us-ascii?Q?qzPyCo6DzmMGonR1RkOkut1iiICyIEBi+sGssADq1CFMfrnPktamcLAUQS5l?= =?us-ascii?Q?FgcvUwCRz9BHtW1jlgmhcfN0U5AGrK83H3RhSwx3XDsS0aE/htQvZVXQt1At?= =?us-ascii?Q?tdY66Rsrt6dAvVOV2MgPcBVtVj4ue3ESCHUOHtQ4j2mrUX7og2qSHuTKD6LA?= =?us-ascii?Q?5XVLrk0pMLlPPFccKG5hN8q/XsErWMoUn6PMd28FBHkRb0D+KPXkrAoLYp+9?= =?us-ascii?Q?07Xi49n8HJKi5dHyJp54b+tM99KykUMP2Na+WVWoJILWjUx9St9ZXrBLhW7R?= =?us-ascii?Q?E+s++LytbCn2ZnXQywvWN4IheRvPVvB3Qz0z1ixhHJ5JGs+l864qMCQ+w3rL?= =?us-ascii?Q?PeJ3HytKaDsyu0F1l1WjX2LJiPxwEiRW+mw5Lu2jO0iAsiUusAMso8VnM0U5?= =?us-ascii?Q?hJlpWEb4EE+zXIwN3ej+ge0AJOIw/9C8twIMtCvFNBezMj6Km0SLli0vq20x?= =?us-ascii?Q?DVTr4S92LtpzA1lkDJXh+7rj+rD+YCaZ34SmtLtG9So5IERiTmDa1qVW84oK?= =?us-ascii?Q?fS8p2FMFYPFWP1RM3S0/R3yCtAwlXNnKsAEjGIZbAiU5F43qnOzSbUf1QwmP?= =?us-ascii?Q?r62f8oV5CKHs9uU+vEP4AzuomXaYH5AIKqc7sk6Am+9PNFNZRAMZzuCL/eUn?= =?us-ascii?Q?cYh1BltrSR2lx3xaQpiohTeiEUkLLe6gXKynFwzSgI5rwMQYmcC03OzEMYHJ?= =?us-ascii?Q?5gioj1QJqLQ//3NwkFKaCQZ2/DXHGJuMS/QG2R8TptJVZXzZh0BAPgJSsXuD?= =?us-ascii?Q?clgYxOfWt+x8/I8FEc+qSlHtH71sJ3cm+33xKpYDB5zmskZuznWnH0TG+YL+?= =?us-ascii?Q?2QUCgQCiz1GxFEN/RNz93h/4cW4lY93gVIolcZ9gwxr6YmdgsJNSDHDMnOS0?= =?us-ascii?Q?dDewnwQYC57ZixdUYxC93JoyC8oKxmwbQB7F+r53Ah9uLsshdMzh6PUrKwK7?= =?us-ascii?Q?gAcvFNW7q1McR7Qvg2LLZ5pB04hWQnTH3zV8FMzv1p27A4aHoi0XaOrV6TUO?= =?us-ascii?Q?jnbAjDl2zYXHs7m23oa+n6o0D6w1w5pJ0JilvJUBOv2zaXVk5Y1jY/yNRa9t?= =?us-ascii?Q?ZBw6fIaaGoK3ZOtS+07+XnJD7HisjSQ+3Fy6cbsHnuoSlZ+We7m27sBRxyBj?= =?us-ascii?Q?OfFS6DboWRQow27lcwBJgYSM3bvEM27p856go4Ui1xVymJh+uPLN?= X-OriginatorOrg: oss.nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: c54bbe96-7484-4990-cf95-08ded3a2af48 X-MS-Exchange-CrossTenant-AuthSource: GV2PR04MB11799.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 26 Jun 2026 16:48:01.5641 (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: QCJsl/YghF+Rh/6kwiyE9F8pd1m2SPO8iN7TRboVfr9GpX8bN4NSMMfTTWl9fTywp35NhO61WiZFGMXDGt48iTwLcgwchH4ukbxi1U2EEluBnrBS0tw22z2VIPWQdf9F X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR04MB12099 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.9.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20260626_094805_959071_3C019978 X-CRM114-Status: GOOD ( 21.55 ) 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 On Fri, Jun 26, 2026 at 01:07:54PM +0100, Kieran Bingham wrote: > Expand the documentation of the video-interface-devices orientation to > reference the include/dt-bindings/media/video-interface-devices.h header > which provides human readable defines for the orientation enum, to help > avoid hardcoding values in dts. > > Signed-off-by: Kieran Bingham > --- Reviewed-by: Frank Li > .../bindings/media/video-interface-devices.yaml | 17 +++++++++++------ > 1 file changed, 11 insertions(+), 6 deletions(-) > > diff --git a/Documentation/devicetree/bindings/media/video-interface-devices.yaml b/Documentation/devicetree/bindings/media/video-interface-devices.yaml > index a81d2a155fe6..c9c3f4f16719 100644 > --- a/Documentation/devicetree/bindings/media/video-interface-devices.yaml > +++ b/Documentation/devicetree/bindings/media/video-interface-devices.yaml > @@ -392,17 +392,22 @@ properties: > The orientation of a device (typically an image sensor or a flash LED) > describing its mounting position relative to the usage orientation of the > system where the device is installed on. > + See include/dt-bindings/media/video-interface-devices.h. > + > $ref: /schemas/types.yaml#/definitions/uint32 > enum: > - # Front. The device is mounted on the front facing side of the system. For > - # mobile devices such as smartphones, tablets and laptops the front side > - # is the user facing side. > + # MEDIA_ORIENTATION_FRONT > + # The device is mounted on the front facing side of the system. For > + # mobile devices such as smartphones, tablets and laptops the front > + # side is the user facing side. > - 0 > - # Back. The device is mounted on the back side of the system, which is > + # MEDIA_ORIENTATION_BACK > + # The device is mounted on the back side of the system, which is > # defined as the opposite side of the front facing one. > - 1 > - # External. The device is not attached directly to the system but is > - # attached in a way that allows it to move freely. > + # MEDIA_ORIENTATION_EXTERNAL > + # The device is not attached directly to the system but is attached in > + # a way that allows it to move freely. > - 2 > > additionalProperties: true > > -- > 2.52.0 > >