From patchwork Mon Dec 2 02:56:19 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Liu Ying X-Patchwork-Id: 13889864 Received: from EUR02-VI1-obe.outbound.protection.outlook.com (mail-vi1eur02on2063.outbound.protection.outlook.com [40.107.241.63]) (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 DB1DA55E53 for ; Mon, 2 Dec 2024 02:56:52 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=40.107.241.63 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1733108214; cv=fail; b=AQxBHlCD63hJqbpRYrb4Oji7/ABbyDyzqnkvEUQdnHf4IREEh3XRDyUkl2I0d280Qz3jG6B3mpHCModZJudLdxUwjWPOzcNaQUgrRMFpcR2FVdVslI6TCpD4glG5pxqDoBJwkw86A5il4Z4rJbrvVCezM7JbQzl1pJ56/JQeDFI= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1733108214; c=relaxed/simple; bh=XzeYdZ6LGKhygzCparlUZt1hPPQLGgAFWv2aW/UIZd8=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: Content-Type:MIME-Version; b=mj69H7CrakcrfN/3+LurDp9ea0GIk4yJYsuSJoYVmbyjMJYN4LBeEPaT/c8Wyoiw2Kh3e8I9r5XeSiCF26XU1oux4NQiZs75C1KlQnL9MgsIDA0McnUTmTH6BO2BUaC40SN00m378+yi5n092Y5fMR8n2SohCJ3TqRrAC/t0vQs= 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=IKlAFV5m; arc=fail smtp.client-ip=40.107.241.63 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="IKlAFV5m" ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=wZ5up46Fp6qykg9nmB9b2NKe5xR+a+Mg/LjDpbKCG9oXY3L9mSDNZ+St5xr7yxegwU0YIyetWi9b6ymmH/xbmbLzkKiqeDlmnEd6cQS2nDOYu0SYLPo4ufy0Fa9W3wf9gPm+/7SyH0/47rJDx1pjnlZDhOeVPdEPyFG5I9Y3kSf5YEN8u+BMs37vOgZK/7sTAsnelMEw57Znuo6Rh+/XP64QgqAHuBGPtAe/x4XMXJ1d+rdlP/549F9jefusn/Het2Ka1jpSKv2MpUbwg56SeuUm5zGj/UQhPEJk1HdfYc9ivFOETN508bCCSdLqXpK92xpDJul9jsT5s8KQ+ka4SA== 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=G6ur9MuDHAI2yqJbWamXsTVjJFMl2CJnelbodQN5X6Q=; b=JFd21ceZICaUtKAjhh+ZI7NqgR1xoKcBWr04BD3An0lZCSSoI+Jg//592oCton+J21pGqAhSPBrU67NNeYCD9deraqasuzReY4/Ms3Ne0oQeMchVVHZl1JzzUlW9Fra+eUAaXprTjx1K21NC40dJjVmeweXrWps/Ry2BLlIRw76ZKIVPNl7mxOed5U6zkPxbB6B0G48I+lbTuJwutzRIPT/CqG8avUWYMxgFrsB+b02j3Cs2+LicVtRAzQKYHQaDsx7ZKkQDQyyJeBUKnTmf2VsFghH1vuqxEvSSnRWK4kqu0XhDE5HS5QZ1SLlbkJmGlI69m6ooxNsRDzCSZnHNng== 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=G6ur9MuDHAI2yqJbWamXsTVjJFMl2CJnelbodQN5X6Q=; b=IKlAFV5mudi6mmPv4DNHT0/4tjjNhu7Moq5DvT2YxdB5zZus/x/eXg7NzWoMBSph80vvvSWEJKBpOS50WMEuarouZAfvz8gKLZPL26GfGP3Yy8HbQ4AxoZi56bdv6EvIHuQtigekfKTv3/0cHPhyujLR2hQl1zKmYzzzl1uO7i3nGNPjKkw3apHBk2wP1/G7ExEXfxmjcGjAkpjPy0L6G4AfQa07y1CaQ5pIagUPZmyzQaL1LWUqNanR3wdKlmRG2Ss5rWjSxyj2CqRl2VxBFx3ApZhLs8UFCMetRym1geNdXixU509OVHBOcip8y/KRF3dbfKGZEwN1lm7sfrpQ5Q== 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 PA4PR04MB9318.eurprd04.prod.outlook.com (2603:10a6:102:2a5::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8207.17; Mon, 2 Dec 2024 02:56: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%6]) with mapi id 15.20.8207.017; Mon, 2 Dec 2024 02:56:49 +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, glx@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 v5 03/19] dt-bindings: display: imx: Add i.MX8qxp Display Controller display engine Date: Mon, 2 Dec 2024 10:56:19 +0800 Message-Id: <20241202025635.1274467-4-victor.liu@nxp.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20241202025635.1274467-1-victor.liu@nxp.com> References: <20241202025635.1274467-1-victor.liu@nxp.com> X-ClientProxiedBy: SI2PR06CA0005.apcprd06.prod.outlook.com (2603:1096:4:186::12) 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_|PA4PR04MB9318:EE_ X-MS-Office365-Filtering-Correlation-Id: a6398cd9-1f6f-4868-9aef-08dd127cf728 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|366016|52116014|7416014|376014|38350700014; X-Microsoft-Antispam-Message-Info: qWlRqgQV1lRJEGvq5a18qn+yS+ZKRxkZNNg9KZfLQ+uxdZSQ8GD43e6W5dGw9rqRz4eNjM4nW0RF1LIBWOsm311fPQ8Wn1anFWhFjfUKUq4uztpfF/FmkG8vF7iXj8NdZ5hD8ZgoY8Wa40c7lKRygubkhla/YKmGQR1KoHx9/kaYw99WLAn28g2fzQ+zCjQmx6nUtPx8TAWYFKmJ0KufBOqej9I7nKaVZbSEi+2B8A00ORGo3WUlP9RB5Zej9VwJCozF++BW+LT3baTEBmdjc0vORyt5ISiP4dCTbsQtyCmUR8iYFOpfg5WZodt1Aoz6P5+mYXtxcet1ZZnsCIxvLYV727LJNB2E/2ZDqz63mnBJh0eYAkvzIKX8WSilmFHaX3B3N+nlm80phLacQm7ZWQd9r6+ICUJFRIvY8i1P/FvbwILxraNdqyPUy57JKXicMHK8Rd/zK9u7RvTpBox5bGm60iHfpHL+L4ibTVQmei7rUL90ICI0Q2MMAMef/4MnBGTzl0zt6ktfmISu3jsA87D/QOb4o9D19LoIpz+SLcHUMtJG1PpH1oXMHU3xyXb166G4ca7gtYeeWpoRKfmPu1qeidCJvvgBzOGtVHtfsAuHaAplKgHdVZvXRfFP+z9qyALVowqWrFLONPhM200aFHPb/PzJvTQS9ANY2xyYm+zrfAic+76tq8gtSv5M1P8nwF3wzHWW7Tik6bKtPKNqwy8evUqVvS2NPZ3aMJJ3UDqg398LpFXePIq+eRxS+VbVG6POkM4V8d95pRXeoJQxr013W9tLUbn9+pAQ9tfjXlpLtk8GLiUa2INSJTN26ykMLyIgvSnsCgbB+DLoyEPG0wNnGVIgOOmPrfoelmgXBHVaNGDDbfFYitB2u4auMG77AOM8eZ2tZjYqLVuOh6KIxWL+o3dPOg7heOgJ6BJfcL2DYU/0njvEVoBXc70BBMbcB4a1FMhzkqtGr/eSY8AvUXY34TdaTxwVFPme3/DNxgyjh0aK5aXvJhcJ1DXZWBmeLYvESflBEILxHgB2VrLk0soOhNaCqbldfWDFx4WGKns7+Ur110OJElLGJrFa2sdXdtGHbxXwgSziz5Z5oPqaB+qAqXF2p44LQcuCLeI3PsSKWE1EQVQmkgu2OGymhRGgDfG7h3W9cWbjgpsJ/NZ2Ks93W0Thw98Js+O7+iL3iocmx/Do0Nv6MK9vp6swH7CsM76mBUzGSO2x8bkD4NiWQSOmety3Qnd4F2bPhxayawkX3bRfv2ySK/AMyuKyqRYg+Ql7wi6p780EvNAlqw5PYJ1/0Ezjgai/j3VIHjS7w/ShHdohKuZVCUm1Elxert6UBUv1QaXTHe/lSc+DKb4sz5WNO2SZnX1t85bQHXf9leM= 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)(1800799024)(366016)(52116014)(7416014)(376014)(38350700014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 7N70rgEg4HgDm0FTtF7oWjf/6uVlHC6pNpBBQYnKpXe+YhqkCTzph6znrY3NQ5Wa/pOSLHbrabNcCkKvshmjx9V/b72Q6ZwuinCsaz6i7zv5LBm88Zyv62a/DtaRpI212ne+Cg30TEP/LzFHKUkcpVrWCnpdKZxUV34fEYA/yB9NhTze8ufznowUtHFLLtKo8Jdj9Cev/4H3hwcYzUZ21L9o7NP2ECbJjhTl98jLaDoxGkfgTGgLJ6Fl7g8usCA+PnpCeYFLNBXbSelztn8e8Z5plc4bMnb72wD773K2kG4AFX3uTGnfgVgysHehDC/sJS1y0OjPyU9RtH5cpXJ8Q6C8Ph/HKpvpTSsQYUSo4pPKb8nl3rKXK5pYMMBCF028H56G0OZt1KkYjqyGBX6FHE/9PAaPreYVhrkFC7dYzqCDcjBo6lCZ49PrBkc5CGrZ9LiQ3zKIaxcGsUJgaahemCWs9C7bQaBD2Qb+fgO1+rNSiQTUH5kjlciub8oz0bwXKZOPzTugnB8xH3t6zBKnkyLguWMGxgUSadDbWwS/pNHhJOYKbSKzPrQ/HxGQ7ZU8g24aFXeyFciLbCBUxoUQ9rGY+RzxUXMvVXIL06FH69aALlg0nDQhVhZaCTN7odacyVepX+wPMZXDaHbFaQGtKy8lUU8hi/wVV1G1IF/vpdPYMgPQE5sgjR0trPSPEZBN9lYGOEzV4mkiHpELVihsarVAO+aZ1QcruD1v+BEsw94ZO8J2iYC7Eydfwp3CMudl2O8g8O7spIer8SKp0ZPBFaLo1JuWQDaDK9pIGuLvlK0aKYcHVJ4tG+W44GX0xo66vXD3O5uj3dPKg9YkXSbV3PY9FM8pxYBM4+DCeiIeRe/82GWas3KBPiCep+iM+OrQRdUC+7ogi5ySmSta+eqpX43eP0gc4l1w2t+QKxe/shOqzt4mw76z8FJJbiU/ygtNUjuc2qIxPb/m0eZ3FUweB/aKIfs/Vuj5wEp/irozOKF0MTZTGHw6qQWBSYIs3Fttl3ibB+Ka4sJi9d/eX7VOBNOsJof0OzdgVtZa1fCQiHJ13ORoWvIKX2KbmtXHpDDYnCk2fzluIu0dXm/2wvzaNUHOGGfcOQT7/NVzCMJmrYvL+pI69qtgmqtockJoUwW1zR4eKYdBQH9elmmM1RN280SCvmWuAmTuD8LwRWY+GSGhaIk+yy0MLijNRv++Np/crdtSny2zTpdGMJ2tZGxgVJcb5XOnFUqBMuKa3XTt/UpaTWyrqahoqyR7bhFbwtbPNjaro1Lp/024lFSceeLIOj68Tqy6veNnEBhWLQJOunY8w3uqj0yQV8B3Lz4Hsgpd0yyD+/WjsjnPwxoGuQ9CeqO8KmQnYPla6YGlRP0rJmsywxeREe3sC8KFcMXl3UUzw6lKrqghOCn3IVIOgWNDk8wbCyr2p3SHtOl3XLI57Rw2+FoyW0eTIu9gt57x77i+8bS0J4WySwRSzMWSVfHnSk5ZzGrhi4fDc/zFCE9HmwzHH+HOJgxdKAzZQ+TIhhxu9adqOKMFzmRkiSylMivEkXnHaBAuJcbWqDYc75jWEnE2Cv7Cu6ohtPEH/meplc4p X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: a6398cd9-1f6f-4868-9aef-08dd127cf728 X-MS-Exchange-CrossTenant-AuthSource: AM7PR04MB7046.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 02 Dec 2024 02:56:49.0255 (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: eKejvK3gfi11iBpgbj/WaJK9nx6w8hV7YT+sGhdaFLgh9YL6vERbTvp83yqjrVciaNSxVxY21aPYKJYqAyuGCQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PA4PR04MB9318 i.MX8qxp Display Controller display engine consists of all processing units that operate in a display clock domain. Signed-off-by: Liu Ying --- 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>; + }; + }; + }; + };