From patchwork Mon Dec 9 03:39:07 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Liu Ying X-Patchwork-Id: 13898801 Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05on2083.outbound.protection.outlook.com [40.107.21.83]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 30A57156861 for ; Mon, 9 Dec 2024 03:40:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=40.107.21.83 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1733715604; cv=fail; b=pB19bABFxfUXN09OSlx02gRMMZztLTegDbDbs+xTw8XFEZU2QTcaJeVqF/1nCIAKhjaxzFSR7Z1PplxJs2XWraTv6SBIhf1uvULOHbuMfZ85/J3RWRRqfa3R6IqIxD9y4lJo1ndoOIdXk9Uk7tsuI1PY3X2pSK2mzosKsYRoaE0= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1733715604; c=relaxed/simple; bh=KY4Dy5DB+Ufd9Y81EIjLKPpM2WVQXlwcMuKrwns2bdM=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: Content-Type:MIME-Version; b=P/hhEUEA6E4HJF4LJ4MXF7WhvrBNgNsLr1lr9d/4TN4BetG0CU2oWw0pr7fhb0slLm3tQhfN5m9J4rvGit0QqNhH5EmDT5VG7dEYeyu+aOlQczhntr8GWSDhspCkF0KTmKwyoKB4nlfxERAshTXPdr83tl9E6nk4QxW+MvXjzfQ= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=nxp.com; spf=pass smtp.mailfrom=nxp.com; dkim=pass (2048-bit key) header.d=nxp.com header.i=@nxp.com header.b=kPmdAYYj; arc=fail smtp.client-ip=40.107.21.83 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=nxp.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=nxp.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=nxp.com header.i=@nxp.com header.b="kPmdAYYj" ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=Pt4MXG2VHWQz3IKY3dxhQJ1pA9BBiaM691aczz8lBK+UzEyM4sxsnnmetfbMiNdB4bVS5q8oX3jMcgHXpuPJh7ECrBUfzznHggLq8EPZfczrj3MkNPSKGMUJ/KkRfdsXKI81vmcdnHp+fnQFfBppPE+fSa1eJ5CxYDGjLeFTQyInwZuH8zXpDn4a56vyJ1gSxMJXVjrF4vVBxuBuJd7UjuBmq2KsA2+pwtK62wK2PrNiNkC/K/dUMnLfh1xD0nHOAmW5QytrP8rKXz/wT+KkSNwwdDv5UchCIDniXax9Mh7pK/uwFt1Q3SmvAOyt1/iPMsPL7uZZm6qnUW022UxGkA== 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=d4Fs8JMMLB26AzSNA7B2loGfZmags3f8h+j1Q0c74JM=; b=DZ5bP7tqlCy9bFsyBsykOmFHHz2YS07GYL+cZx81tm7zViuJDDDxuhhzrAZwgdknUXVV1p9PDc1b8VPSV0IZOaiG1m2vTNRkzxlvV+Sn96jcBYhhAJmT58K6efyU8uP7xaGLLGmcO1w8McwXTQzAmi90bGJDHCRhwuvQ8NmGAmawWhD0R5+hDpC3tdRtHnXT+Hcw1BhEKP4vVBNfAwdaY8eXcILs3IWCRxHrqRtalTLZSvtcTv4Tt9peOBGpKNgXGvUPRyNsASEgxzWuxDkEztr49IabgJpvAmz3Kjcw2UacKvCMHLs4D36Mh5uBbVGz7Vx2LGc86JQk70ZBEG2dPA== 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=d4Fs8JMMLB26AzSNA7B2loGfZmags3f8h+j1Q0c74JM=; b=kPmdAYYjan4azSAqw+9tl6nwIYzILNnIhD+/2KiYnX1c16PmwjiPiS/1YVqayuNxz56UkCyK5bHwaeSVtD2jBm5DqLS8AMHB0XJSe9Og+vBdhVuVwPamqwVfNNWkPklDM7skXuSNDa2A1CdItrR5cnGttzxQHIasxAXkT2Up523bxGmc5SdWkCoXm7G+U8Fkeeeq9707A2CHSkDrkGWym1WCalWE4db/F79yAk575TYpNKgjp4GyUG7/DSr28XCnS8ouw8G05vIoqZ8HZNyDSVabIjrhoh+WMvq20veL0xTVv7P6Hh+dbSh9y0ue7kEtU5V6kehfcNkWtsDg02N66Q== 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 VI0PR04MB10212.eurprd04.prod.outlook.com (2603:10a6:800:243::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8230.18; Mon, 9 Dec 2024 03:39:59 +0000 Received: from AM7PR04MB7046.eurprd04.prod.outlook.com ([fe80::d1ce:ea15:6648:6f90]) by AM7PR04MB7046.eurprd04.prod.outlook.com ([fe80::d1ce:ea15:6648:6f90%6]) with mapi id 15.20.8230.016; Mon, 9 Dec 2024 03:39:59 +0000 From: Liu Ying To: dri-devel@lists.freedesktop.org, devicetree@vger.kernel.org, imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, linux-phy@lists.infradead.org Cc: p.zabel@pengutronix.de, 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, shawnguo@kernel.org, s.hauer@pengutronix.de, kernel@pengutronix.de, festevam@gmail.com, tglx@linutronix.de, vkoul@kernel.org, kishon@kernel.org, aisheng.dong@nxp.com, agx@sigxcpu.org, francesco@dolcini.it, frank.li@nxp.com, dmitry.baryshkov@linaro.org, u.kleine-koenig@baylibre.com Subject: [PATCH v6 03/19] dt-bindings: display: imx: Add i.MX8qxp Display Controller display engine Date: Mon, 9 Dec 2024 11:39:07 +0800 Message-Id: <20241209033923.3009629-4-victor.liu@nxp.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20241209033923.3009629-1-victor.liu@nxp.com> References: <20241209033923.3009629-1-victor.liu@nxp.com> X-ClientProxiedBy: SGXP274CA0006.SGPP274.PROD.OUTLOOK.COM (2603:1096:4:b8::18) To AM7PR04MB7046.eurprd04.prod.outlook.com (2603:10a6:20b:113::22) Precedence: bulk X-Mailing-List: imx@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AM7PR04MB7046:EE_|VI0PR04MB10212:EE_ X-MS-Office365-Filtering-Correlation-Id: 7738d13a-ebe8-4208-874e-08dd180327f7 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|366016|1800799024|7416014|376014|52116014|38350700014; X-Microsoft-Antispam-Message-Info: IxhUPpBdIucBfKzptEaF9n9+G7y1DX4+onXXt9EI4Od9UUUOJjQoS5YXzzl2WOV/Qy/LP9J2TVnVaUwXGvAp9Qb/rwo3divAXnNKylevc3HWUt8/DSHjKm/rI8VfRKiVsW4B4i0pXk8pCI/Lwj9T0JtyzTbDX4Mgo4nTWy0xPLey75DzDVAzmmKe6oksYBW7tjDJuwYq0ecSS2FW2w7IfOPzaEQ/mFuiPTLiWkR90k4H46CbHFwmM8AoyySh/l4fLGMpRWZht1oqgezgSdpqwI8Vz7/VtvCTyCgkY76AqF93GKVfa3wIpMybKSGNjZCqWHv/MdA9FY1QcvAYvVXJHpAB27pyTOeSPArKw1KVjhdh0RHFCHOovb8BbNe+Mcfpp7poGhg+dZgm/KF3VcAFKvDWnfQ3yuCrnZcsNJ/umt5bL8KCKPPLOzuPDpm9TFyasJjL9V/H0TTJKoMKK80Vo3w65FPLo7gNKgYTRM8qk4+8Sp3eyS1QIcUbIyl8Gyx0rWx5/mflJOuyXswSPHNa6POtG61/7A2jiW9XlON2mCktzFPhcPZDkDaYZSOm3tPOiTVRXfB8qd6f1VMlc8BWP4FtSGrqiAYO8uJLLSrlONm7mgLwkDR+YhjE4Dgaxjst5YuNIv4KsoM6taF6DinTD6PFl5SWx+pxG2sysuRIPWXY5c6jPhfXjL5KlumBIe1nxYNeyZzVgaaOm12bVlM7yvosvi9HC/q3+6GxMQSE4e/XgCpl6TaFgOGREURFTLBIcOTIhTeHKRHi4EYcl+AYZddAs2N+3uqHxHxOFpBg6o3acbsaWTwQNnSYVOs3pItb3+mPmhL3p4br3b1b6kPODlBEmsOYGOxpY1p5hTPESR1g8Thw05qzRlR5V3CMvYHuEibklwwmIfeF33MiZMPsMnEIRSBWTqPMlqP+PFK3uR783znWHf5vfoxNP27PNMvEy3wsvENbMW95KvRI6Y7Mi8fvOUlBtqK7oawwtiKCQkbhsP25eqAaUJPrpbUx/YmbbQy+5ffG3dJ/Hqp81Hup7nXAS+up/O7qYgDlId+S4Mucn4+4FkfBHY8UsuxcrEeilZTPdKj8AuTrRedFs66zr6NCvq9kS4vC4ahCqWR7kPPJ6maojMwN7DBORN9Rro3QM9Iyv3aczyJz9GQcXKMpF+gFvk9Omw8ri2fG/pfoAQ3he3JTCe4EGSoHmhGz2c1+3Gw6ynn2wwEjK1IagrgVduNM+LyYIVwtJIiHEzZEnkQgDn7i5yvzbXKPO7tYuQsN9XmBWN3yKNJsaJT9g4mJkPz89j5THkSFsCqVzAhpcj1x/hX9oQcvweKn443grmAiaDyhOiZqAa3YW9OWHdfwDBVzH9jUnwXedPTJ2OIVizA= 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)(366016)(1800799024)(7416014)(376014)(52116014)(38350700014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 9zWkMsyAyPn1iCkpkC/xYkJGe2z6CrtoJo5ZsWin3b/xBcG7UDYEumb2BaxjfwOUw+3/AxBs6qRfzr3XwPjSQhSyXIDSgXCBRLeV9LGnoXamvlYw2awAvUYp5mNv9D2BrNqaI4iRL9RC3x13G9p0CMOjr3JqGnjM8XtbNGzXGkABE+u03+elQ49yuRCymVFe0VtixqBJ2xnyi8Zt3+ri6e7iAsI0L7yQWuRVzuhXevDJi5AiKhDVQOwRaMytv/gx5JojUTkv+vZqu8x66BEVZDK8eWMrSt9ZQ8ZphD17/cPFYIxKGKV576ABGz+ImnbpKNUplMG2eNJ2Bqe2mCBrd2HSL8TOFIWt9+DIEWKOr+JjUwgy2X2ZE2x1DiniU+0lKe6SaWTVj2uh4a5tMA4wOXRaFheUGSo+RqbPCcyNPQQ6N2WhQMGBxC+ytt7oeZwWpCB/guWjsPmcktjFFJS64vQXGnjhh7TG9t0a8y4JUh9h/LwCTn10llhBxefLxpm7V9gveNmh/M5dwLLSUJ99qpCLHguvomiCv9eeV6PXZN/VU0fevgtPZI+lr7xLKuXTmjcv1PyvLFygSzXS81ASsF3nnNRQ7mSFN60/CLhqhOIJGv4xfEd4vAJrSv0CbFU1S4WOPn0veL20iDqxcrbL0sGeKt8Ma2G17Y0y6JBy5SzINwsTV8pTFThHSUHnC06WvayexyydNjH8TRNeS+pwJfqrkEk22I0ILutXg4V9hocHjIvGsP17BlrPpdMer6oAEuFM8bO/Vg+yWVi7k+elpNsxK9aojZeHo2bblDY/xLQXBQjzfmNQ/rUUday4tJ5FeBi4o9eqJ0K0n1sK1sPvIK4sS9roy7zYhvOtgWNOlezFn9BPKjju6UWWjHeudm5SLc35hi6Rojbkxw8h4TWKaYWLZl5VWR1iOQOZbnJ+Lq5RwDEgQM0WEdG4mqDRuxb0orV2MtMrGvdXW3vgZg4thAykPV84UbSUzRkzp6mJ6W9An18uRZv6cAFIxbrAXNn4Ld7AdH/Nf9/vFMxRZRv13OZdBugjRc/0gDYz+QYReZOYng6auhGBWhG7n5jX4a4ZnHpAmvDYFuLOqe7D+GxXLYla6qFWfM2U2M/7w42DfpO0eJcIKF2zEu50SewmTPBSFr4BcajQruV4bbENYymEZiTPGfsKPAQRaAkTgNqqHy3SRmqwm9xlT5pHgrdNsRlMxCNoCfeNHhOXH2vD5ihQFnJdyTpANJsM7qt6A57EmP9drdKdenp8KIBK01d/ljO7ZwRZd85EISH0PtvsTNW0hFbC1NTUGJEa8nlmrHwgTm9ptxAqMPsgoCPYRjtViWc0z9q4+XZJwxTM05620JLC9MHhePg/thdPX1OzOWoZvM8cUeWXW+Fq6CFNKRRwnXERyDO84yzb9EOhVe+WlJFWtr90cHsVph89hOC/eaJJRglTYfZnuy1Ci15N3knXHcjdmsIWBViIsdczXY5YuBuXNqPGWm+5kfzLYhVT5sFK4A8x1IEmQn+AxGUvvDmZo2pR2N6Hg2Y0LddgeQKk1vYL6Jhjd8zERA7EYONRUxFGx38cJdlEyq9EqL/ojvmE2HQU X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 7738d13a-ebe8-4208-874e-08dd180327f7 X-MS-Exchange-CrossTenant-AuthSource: AM7PR04MB7046.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Dec 2024 03:39:59.3049 (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: oO6ORGj6rUIcWhC0l5oMZa+Bj7ttBBqbp3ZgzQeQ4RUyalRo5tSUJLRmw83XJoI8HZ4xpyIUhT0yZljz/MOL7Q== X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI0PR04MB10212 i.MX8qxp Display Controller display engine consists of all processing units that operate in a display clock domain. Signed-off-by: Liu Ying --- v6: * No change. v5: * Document aliases. Drop Rob's previous R-b tag. (Maxime) v4: * Collect Rob's R-b tag. v3: * No change. v2: * Drop fsl,dc-*-id DT properties. (Krzysztof) * Drop port property. (Krzysztof) * Fix register range sizes in example. .../imx/fsl,imx8qxp-dc-display-engine.yaml | 157 ++++++++++++++++++ 1 file changed, 157 insertions(+) create mode 100644 Documentation/devicetree/bindings/display/imx/fsl,imx8qxp-dc-display-engine.yaml diff --git a/Documentation/devicetree/bindings/display/imx/fsl,imx8qxp-dc-display-engine.yaml b/Documentation/devicetree/bindings/display/imx/fsl,imx8qxp-dc-display-engine.yaml new file mode 100644 index 000000000000..b5da0bf3a1f4 --- /dev/null +++ b/Documentation/devicetree/bindings/display/imx/fsl,imx8qxp-dc-display-engine.yaml @@ -0,0 +1,157 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/display/imx/fsl,imx8qxp-dc-display-engine.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale i.MX8qxp Display Controller Display Engine + +description: | + All Processing Units that operate in a display clock domain. Pixel pipeline + is driven by a video timing and cannot be stalled. Implements all display + specific processing. + + Each Display Engine device should have an alias in the aliases node, in the + form of dc-display-engine, where is an integer specifying the + Display Controller instance and is an integer specifying the Display + Engine device instance. + +maintainers: + - Liu Ying + +properties: + compatible: + const: fsl,imx8qxp-dc-display-engine + + reg: + maxItems: 2 + + reg-names: + items: + - const: top + - const: cfg + + resets: + maxItems: 1 + + interrupts: + maxItems: 3 + + interrupt-names: + items: + - const: shdload + - const: framecomplete + - const: seqcomplete + + power-domains: + maxItems: 1 + + "#address-cells": + const: 1 + + "#size-cells": + const: 1 + + ranges: true + +patternProperties: + "^dither@[0-9a-f]+$": + type: object + additionalProperties: true + + properties: + compatible: + const: fsl,imx8qxp-dc-dither + + "^framegen@[0-9a-f]+$": + type: object + additionalProperties: true + + properties: + compatible: + const: fsl,imx8qxp-dc-framegen + + "^gammacor@[0-9a-f]+$": + type: object + additionalProperties: true + + properties: + compatible: + const: fsl,imx8qxp-dc-gammacor + + "^matrix@[0-9a-f]+$": + type: object + additionalProperties: true + + properties: + compatible: + const: fsl,imx8qxp-dc-matrix + + "^signature@[0-9a-f]+$": + type: object + additionalProperties: true + + properties: + compatible: + const: fsl,imx8qxp-dc-signature + + "^tcon@[0-9a-f]+$": + type: object + additionalProperties: true + + properties: + compatible: + const: fsl,imx8qxp-dc-tcon + +required: + - compatible + - reg + - reg-names + - interrupts + - interrupt-names + - power-domains + - "#address-cells" + - "#size-cells" + - ranges + +additionalProperties: false + +examples: + - | + #include + #include + + display-engine@5618b400 { + compatible = "fsl,imx8qxp-dc-display-engine"; + reg = <0x5618b400 0x14>, <0x5618b800 0x1c00>; + reg-names = "top", "cfg"; + interrupt-parent = <&dc0_intc>; + interrupts = <15>, <16>, <17>; + interrupt-names = "shdload", "framecomplete", "seqcomplete"; + power-domains = <&pd IMX_SC_R_DC_0_PLL_0>; + #address-cells = <1>; + #size-cells = <1>; + ranges; + + framegen@5618b800 { + compatible = "fsl,imx8qxp-dc-framegen"; + reg = <0x5618b800 0x98>; + clocks = <&dc0_disp_lpcg IMX_LPCG_CLK_0>; + interrupt-parent = <&dc0_intc>; + interrupts = <18>, <19>, <20>, <21>, <41>, <42>, <43>, <44>; + interrupt-names = "int0", "int1", "int2", "int3", + "primsync_on", "primsync_off", + "secsync_on", "secsync_off"; + }; + + tcon@5618c800 { + compatible = "fsl,imx8qxp-dc-tcon"; + reg = <0x5618c800 0x588>; + + port { + dc0_disp0_dc0_pixel_combiner_ch0: endpoint { + remote-endpoint = <&dc0_pixel_combiner_ch0_dc0_disp0>; + }; + }; + }; + };