From patchwork Mon Nov 4 03:28:01 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Liu Ying X-Patchwork-Id: 13860886 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 2DCA6D111A3 for ; Mon, 4 Nov 2024 03:44:15 +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:References:In-Reply-To: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:List-Owner; bh=+gOBNbnJSnnxg836bf5WghF5VYpyYcxTCh3be4zUFvM=; b=eFl23tJGjWZE0n+sRRcgAOFhQi hhvQvY1KE77kJ5e2o69OkTs8d6Q49Vpz21JCbkClcVmRVCbImn3faHMp5vTqoOYoHk9jnyFxB/OzD mTmz7ODyT7fGk3K2e/R9AOPmUvVT5upFTtwL9UNltRAPQ9bQmSlLHcpat8tjDIzNp8yVMnTTnTo+j WdPU7RabbNEPZ0ou3imL/wZZLd0YDq67QxoDGsTel+y1ZFz9sB7o8m2vhyH87GQ/FblH/B3kPoMor Cq8YBF3gQ5OIu+/uwpf8jsagrGFoybULXZGx0S2KzfiMQQ9mv8hmHWAXKXlxTiHVyg9KpCDlMkxZO YlUpLYnw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98 #2 (Red Hat Linux)) id 1t7o0Y-0000000CZqq-3sus; Mon, 04 Nov 2024 03:44:02 +0000 Received: from mail-am7eur03on20631.outbound.protection.outlook.com ([2a01:111:f403:260e::631] helo=EUR03-AM7-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.98 #2 (Red Hat Linux)) id 1t7nmq-0000000CXz8-3w6S for linux-arm-kernel@lists.infradead.org; Mon, 04 Nov 2024 03:29:54 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=Jg6tlSkG3kgeer/Xms0a5c7/zgUPRcJ+Xbic23S3oOeo+oHnSLBLuXPJUFx5gPpF1V4Ch+pZELFpm3aybHGrOdz919qE/lQdDuR5IJaUge/ImxKGIokaVO89Vz0NJmyrFP8UqI7EMIsAq6UiP1HL9JcABN6Fi/YJjw4Vr+Aktw7u5ooHLsml3B0y+mue07dCSZuXH1ThhTNRJEgQBlctUtEm8VAdlaJqXamokR9pFpvl/CnboXYvHTHY5uMksbGnFcNI8MAhci/rziCNkrRgScaPQKijRSLNvW3OIQCZe2geSt+nvBqVTw3gAbhVv68/AdSm84fkBxEzW6N+FU/I8w== 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=+gOBNbnJSnnxg836bf5WghF5VYpyYcxTCh3be4zUFvM=; b=yDF4+6giB7WUdTrH7jil3ak7gEqHW8Cd+8FqdDFgsMsbDZtUCpmW4dBGyyJ4pmY2MubJHmD4zJbK+O7mPqCtBLaEIzrhjRbCdpDnZzl4CARvfGlYN1VpauNliUNLgevK+b0IjhMchzYHAPRXDZBeaiJjZ9R3n2OP4Fn0kR3cczFxJBxdHauaujkQH/naOD/HcypuIj2LnydBw1dGykTK6gEQ9M+McT2NI0TDPHmAINwUJBwyV+LOScLqRERIXGbexGzXMbSm7yUfJjzsCujGHrjUlwMkGGtb6b/ddnUDRfsZCz6W6xucagyts5QKv5wV/ChgL26rsdtpa01wwcRYFg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=+gOBNbnJSnnxg836bf5WghF5VYpyYcxTCh3be4zUFvM=; b=WMdLn6pqxNwvZwlh1/fC3mvimvXm8Fe/VN/DNB3gmF4UuD/DlEgDqE2LU9Ww4buXcYOOJEkm6AAhx0qIuspeq6XuqGU4HOBuZudu9ttvzcgxJMaplkI+A/p1C8i6qhy7NZNNtQqd6Z7lm8u+2XUMHRfrvObRAO3BVwOj00+FdZ4IGBvJX4G4ePE4hJ8XvyMiq1kpidq00hIXgQpNoZ0PrsNIsNz24YiFlVCvsA0zfnMWkCSIMjhEiYJBGBXE6ySuUqL8keESjgp+BfPNvIfozVBVQm0TnKc5hdsq2YFd9ttAelcKb4kLIV1oDXd3u3NXrDfXDWV8eu5IYYlOZFg9aw== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from AM7PR04MB7046.eurprd04.prod.outlook.com (2603:10a6:20b:113::22) by PA1PR04MB10602.eurprd04.prod.outlook.com (2603:10a6:102:490::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8114.30; Mon, 4 Nov 2024 03:29:49 +0000 Received: from AM7PR04MB7046.eurprd04.prod.outlook.com ([fe80::d1ce:ea15:6648:6f90]) by AM7PR04MB7046.eurprd04.prod.outlook.com ([fe80::d1ce:ea15:6648:6f90%4]) with mapi id 15.20.8114.028; Mon, 4 Nov 2024 03:29:49 +0000 From: Liu Ying To: dri-devel@lists.freedesktop.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-media@vger.kernel.org, imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org Cc: andrzej.hajda@intel.com, neil.armstrong@linaro.org, rfoss@kernel.org, Laurent.pinchart@ideasonboard.com, jonas@kwiboo.se, jernej.skrabec@gmail.com, maarten.lankhorst@linux.intel.com, mripard@kernel.org, tzimmermann@suse.de, airlied@gmail.com, simona@ffwll.ch, robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org, quic_jesszhan@quicinc.com, mchehab@kernel.org, shawnguo@kernel.org, s.hauer@pengutronix.de, kernel@pengutronix.de, festevam@gmail.com, catalin.marinas@arm.com, will@kernel.org, sakari.ailus@linux.intel.com, hverkuil@xs4all.nl, tomi.valkeinen@ideasonboard.com, quic_bjorande@quicinc.com, geert+renesas@glider.be, dmitry.baryshkov@linaro.org, arnd@arndb.de, nfraprado@collabora.com, thierry.reding@gmail.com, prabhakar.mahadev-lad.rj@bp.renesas.com, sam@ravnborg.org, marex@denx.de, biju.das.jz@bp.renesas.com Subject: [PATCH v5 08/13] dt-bindings: display: Document dual-link LVDS display common properties Date: Mon, 4 Nov 2024 11:28:01 +0800 Message-Id: <20241104032806.611890-9-victor.liu@nxp.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20241104032806.611890-1-victor.liu@nxp.com> References: <20241104032806.611890-1-victor.liu@nxp.com> X-ClientProxiedBy: SGXP274CA0016.SGPP274.PROD.OUTLOOK.COM (2603:1096:4:b8::28) To AM7PR04MB7046.eurprd04.prod.outlook.com (2603:10a6:20b:113::22) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AM7PR04MB7046:EE_|PA1PR04MB10602:EE_ X-MS-Office365-Filtering-Correlation-Id: 1fa3452f-1654-4e08-5ece-08dcfc80effd 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|7416014|376014|52116014|1800799024|366016|38350700014; X-Microsoft-Antispam-Message-Info: 1S159AnWlgBAkVqHktkpjD9wIq7zdskMaU4VYZzJnUF7Y9pk7E45Ezo6fmjYlzhDIjJ6PuMB96GppVwcBFzCRI2Qn5Jbw8YkudECPho9omra4I5gknmc6ThideSj8uR4qWYiCieypYaOOOE9kB448UMaRsVrtJ+ntPicvh4gf/ywGIf1ASDqio+Kqqvx3YdiWKsk0C5JG8k/jf/5y3f6Rx9WWt1tvoY2TXC/N6hA/HEMJ3LpZ0X5F9fBg8aMfoObmDh+kPWeW+6WLcKj1Y6I/4cV6m4+lbE/CeGnCvpjNJ4xpCSm07W/8ZIDr5ZpYBJSKEw28x2fI4KCRaEBZVbooBXuFf+rOUXoDfYZlkiB5dSlIfCDrTCqz6e0StiMFwmTr0Ar6N3AIFDA0WiQxhkSYLirmg0GjRGhZTubkmSexgPQ5UyA4lRXSjDph93ZZwSxExD8YJiBIiWXW5QYKiYbzNECROo7YiV6mQt3ChMirafUKx35Ac6zpwrBaMTi2PPxwwJ5I4BHyCJu0Nm4WCwPIqlPXAltH0QotH9eA5MXWRrUSmyLemgCVeifCmcCbB7xGMAgqFJhPto0fabplGOG05on6weqk/Qw2TYT9IXqzq7Q6vUdjtQvdshboL+h8f44PvXIjLcO9TMhZGcZgN4Hd8pTKVYkvfY5R1m42HKNYahkLtgf063cDqFBlN4o08rCkFIt6R/WYHW3wEq3O7/8SQLMW13E8gwNk8pgchQxFulPrTNBPf6mcYDrpblO52OoaKcraEPrigVuajjHm0Yy6KnH5L73IpGOwg4ebtA4p61TcCSXOPWWEs5FR41kz0do++7Sigq87ORhcXXJyndsTgRUe8/856VPnn0bx/y7618S+oq5yLK+JdLcee9JruaM/g4vaW1hPGpILuAKn32CLMDLDeCR8RghmjjcQcvbbpUurx5glN/W6FRTt27DQ8BvdnJwDHchnn4yblg4Er/wAJbSnYeQuJfuzgGCTlAgzvLcy5IY4XMk0wCUJNZ0aQ+rbAJAZHcHE1TiqIPyuc/zAPGzoCzT0ikppA+zPA7GNcre4+ikIK4w65gRRHVDA+ewl0caoJjkuapxTfE8L0fKcMb5YSCW12WMlTnygWs9mzovdf6j5SR1H2mCb7sYnB997iSSoEohn1Y8VY/VvxJUjLc86jCiU1I9np+VI8QNXmexruD5CcxfJlmvOWOc32jDxPXHsyJN87ybMPKwwvAQj047hyOcoEga2PGBHb717Z133eeFQV12/9l8IezImblDQJJmL/inZBDgemPd1S2i/B2wf4+/RHVCgGgEcnWN7FPUgxywARBgBe4oNaPm10Kc X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AM7PR04MB7046.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(7416014)(376014)(52116014)(1800799024)(366016)(38350700014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: K+trcXKeeybs+qoykGGNb+cpnslx3JAzrowS2AykSe2Mfg27SIp2kh1ufXq0sENYkVkXVI2HtThmYTvn1gDTsXjsIDhafDiYQx7GJXJg1AS57oCxBHrnrmrfbBPZ+L8Q70uScw49K2Udg3ST8qO3pt8QmXXJS/JwnK7naAb36qG7ItdFkjSmXWOjwRtr2/wsj9YFou75hnrKxZBT/AVvKwG9GL7hRgh0OBcElz67Ruk7p3qEO1MxLHYVS3omJyqdiv1ZNCx/IRK88XvKx4FlXoM3kQcuIsq/AESk2b6j3g+1s4uyxYjCyhfqYk+KpYABe/VWc4mmqEVMmJ0h/y7wOb6SjGIwi40Jlp4qNsegmuo4knqEDHBJYxB4DbzxOcTBA8XebTapbqJN394uOuvYd43Pzo/Rv/XK67jAEEXwYOWmAPC5kXevoK/AFnGxuplVkOlC48YA5dnF6MOiiLjB3O58Z36cQ9NLgSFoocPWCbHxdBeSPwtQC9Rdp2fW1ZLt6M96QYaAyNQqmEbV9UGfmcTOoBHjvAun3gMpex82j+LvklX2tqEPgjacbyI2o+aKzBXY+EfPYB2/xN8X2PTgSUwz2Gg+V3LvTzWBxtJ9BQNcO3Fy9j/RSFCIPIc28AJEuCoGH3PBuqB1Moaqjl6JAJ+JfLI47xxwSxRYstgDmeTkz2N2QttcJJNVZgGv9jFPpPTKWwyvjE0ZigqH2Gn8j8ANJPXCarmtV8Urzhgg70mtuaS6GvN69nfbTz4oAekDWrPwKZeNViijh4v7Kp52OjrQlIJJahv6UVMs2NlG/PpPGpwxRivjy8G2wUSuZm9UcRZoxDvhIHXYEMuvCxcVxXJG3XbEMV/JdKGwkzAeKZy6LPkgIwR5CJmaqVW5zFI1AseizL7gNLBrUcxiCgJkAPVZF5H4rfAwPxyUjneVe6ZCmjikMshfcK3W5xWn2rudkfpLKexRtFph2J7sHFXwIm9M+r/KYmnw5VMCeQmRQ1KL8Kjs19+Qb/686f1VS+RGsiPe+YfuX+iPZZf4BTZDfRQ6C/JQy4GqHLrsjWY9X9RdMZGDEYWSJqn0V07xH4QdCGlhVP38/BR3qGefIzQsAETk1evjlbhFcnNxw0JgHD9RaaggdZ/Fu737D5YKuPDdrFtlwpMOgDUKeG4PbVywuRLsU/hsQDdope12kLvJhJS723tMCh6GVj7Twlp02k4X34ZAr4djl187FKLs6hdNAmIngxVXBcyPVvTA/7unzgpi/M6oF3mSm+y7qmR7ZNLFdeKUCRbvUQ83oIwNoGV1VqUEO+UVQSeMgjA1jYY24XlMvUJrG7YFDZI+2qYb1QZ/UO42DrhIhFTjFdJzhqF1VQi6zM9BHKLULvBj1hkThqfBK7q4hneI4xboNOLAslXbYsPc7zE/8rpDCUaoVA/TcEONA4c6X3hLla8Ri6psNnorzkDS64TRKbIPlB75bHY2e9UtlWxV2ggThYevuX37uju4QN1jYZ1Fc2FyYEqIG7nByAE2DowQOG///A4vbz37nfLB6S+6xIDeq5iThANNsa4nZSKkDKoaRaIMZae9KIlDxUCE3oUVgLQ/Mli1GuRK X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 1fa3452f-1654-4e08-5ece-08dcfc80effd X-MS-Exchange-CrossTenant-AuthSource: AM7PR04MB7046.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 04 Nov 2024 03:29:49.4108 (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: 3yD7tML5yLLNqcStZsGtjGXBAfosJ2T9Mk8VSl8OiMjwlZIc/HYgZiMuopAdg/sJ6D3rTBnAuHZ7G/juIv5s8Q== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PA1PR04MB10602 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20241103_192953_159114_648BC601 X-CRM114-Status: GOOD ( 15.47 ) 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 Dual-link LVDS displays receive odd pixels and even pixels separately from dual LVDS links. One link receives odd pixels and the other receives even pixels. Some of those displays may also use only one LVDS link to receive all pixels, being odd and even agnostic. Document common properties for those displays by extending LVDS display common properties defined in lvds.yaml. Suggested-by: Dmitry Baryshkov Signed-off-by: Liu Ying Reviewed-by: Rob Herring (Arm) --- v5: * Use patternProperties to define port@0 and port@1. (Biju) * Require port@0 or port@1. v4: * Squash change for advantech,idk-2121wr.yaml and panel-simple-lvds-dual-ports.yaml with lvds-dual-ports.yaml. (Rob) * Improve description in lvds-dual-ports.yaml. (Krzysztof) v3: * New patch. (Dmitry) .../bindings/display/lvds-dual-ports.yaml | 63 +++++++++++++++++++ .../display/panel/advantech,idk-2121wr.yaml | 14 +---- .../panel/panel-simple-lvds-dual-ports.yaml | 20 +----- 3 files changed, 65 insertions(+), 32 deletions(-) create mode 100644 Documentation/devicetree/bindings/display/lvds-dual-ports.yaml diff --git a/Documentation/devicetree/bindings/display/lvds-dual-ports.yaml b/Documentation/devicetree/bindings/display/lvds-dual-ports.yaml new file mode 100644 index 000000000000..785701fe1590 --- /dev/null +++ b/Documentation/devicetree/bindings/display/lvds-dual-ports.yaml @@ -0,0 +1,63 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/display/lvds-dual-ports.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Dual-link LVDS Display Common Properties + +maintainers: + - Liu Ying + +description: | + Common properties for LVDS displays with dual LVDS links. Extend LVDS display + common properties defined in lvds.yaml. + + Dual-link LVDS displays receive odd pixels and even pixels separately from + the dual LVDS links. One link receives odd pixels and the other receives + even pixels. Some of those displays may also use only one LVDS link to + receive all pixels, being odd and even agnostic. + +allOf: + - $ref: lvds.yaml# + +properties: + ports: + $ref: /schemas/graph.yaml#/properties/ports + + patternProperties: + '^port@[01]$': + $ref: /schemas/graph.yaml#/$defs/port-base + unevaluatedProperties: false + description: | + port@0 represents the first LVDS input link. + port@1 represents the second LVDS input link. + + properties: + dual-lvds-odd-pixels: + type: boolean + description: LVDS input link for odd pixels + + dual-lvds-even-pixels: + type: boolean + description: LVDS input link for even pixels + + oneOf: + - required: [dual-lvds-odd-pixels] + - required: [dual-lvds-even-pixels] + - properties: + dual-lvds-odd-pixels: false + dual-lvds-even-pixels: false + + anyOf: + - required: + - port@0 + - required: + - port@1 + +required: + - ports + +additionalProperties: true + +... diff --git a/Documentation/devicetree/bindings/display/panel/advantech,idk-2121wr.yaml b/Documentation/devicetree/bindings/display/panel/advantech,idk-2121wr.yaml index 2e8dbdb5a3d5..05ca3b2385f8 100644 --- a/Documentation/devicetree/bindings/display/panel/advantech,idk-2121wr.yaml +++ b/Documentation/devicetree/bindings/display/panel/advantech,idk-2121wr.yaml @@ -20,6 +20,7 @@ description: | dual-lvds-odd-pixels or dual-lvds-even-pixels). allOf: + - $ref: /schemas/display/lvds-dual-ports.yaml# - $ref: panel-common.yaml# properties: @@ -44,22 +45,10 @@ properties: properties: port@0: - $ref: /schemas/graph.yaml#/$defs/port-base - unevaluatedProperties: false - description: The sink for odd pixels. - properties: - dual-lvds-odd-pixels: true - required: - dual-lvds-odd-pixels port@1: - $ref: /schemas/graph.yaml#/$defs/port-base - unevaluatedProperties: false - description: The sink for even pixels. - properties: - dual-lvds-even-pixels: true - required: - dual-lvds-even-pixels @@ -75,7 +64,6 @@ required: - height-mm - data-mapping - panel-timing - - ports examples: - |+ diff --git a/Documentation/devicetree/bindings/display/panel/panel-simple-lvds-dual-ports.yaml b/Documentation/devicetree/bindings/display/panel/panel-simple-lvds-dual-ports.yaml index 10ed4b57232b..e80fc7006984 100644 --- a/Documentation/devicetree/bindings/display/panel/panel-simple-lvds-dual-ports.yaml +++ b/Documentation/devicetree/bindings/display/panel/panel-simple-lvds-dual-ports.yaml @@ -22,6 +22,7 @@ description: | If the panel is more advanced a dedicated binding file is required. allOf: + - $ref: /schemas/display/lvds-dual-ports.yaml# - $ref: panel-common.yaml# properties: @@ -55,28 +56,10 @@ properties: properties: port@0: - $ref: /schemas/graph.yaml#/$defs/port-base - unevaluatedProperties: false - description: The first sink port. - - properties: - dual-lvds-odd-pixels: - type: boolean - description: The first sink port for odd pixels. - required: - dual-lvds-odd-pixels port@1: - $ref: /schemas/graph.yaml#/$defs/port-base - unevaluatedProperties: false - description: The second sink port. - - properties: - dual-lvds-even-pixels: - type: boolean - description: The second sink port for even pixels. - required: - dual-lvds-even-pixels @@ -88,7 +71,6 @@ unevaluatedProperties: false required: - compatible - - ports - power-supply examples: