From patchwork Thu Apr 14 07:10:37 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Liu Ying X-Patchwork-Id: 12813023 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 AD99EC433EF for ; Thu, 14 Apr 2022 07:09:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version: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=zeM/fHSR481ahSS38NYtGtxGURYUlZ1IqaXxMgzZOrg=; b=oPoWzbjJC9T9ND E7vD39kYnVhChEqb6Ay4sWLRnjKrqjfL5UYYKaKEIdH6DhlrnmlVSNXb4u7wy0BIHmuYIu2QXA0So nfs932GPGKAo9uVVqIKQHZ1Vxddq3vJOMyjokm9H0as/D4BD3H+S0GkWWPjBuaU/61Kd1PzQZ03nd gbm7WOUnPMkEwP+ZwKUwGPKo+pn+Yeb/FR57D0TcXo7QJK6VsDqxWeZl+5xveaOAT11A7/gsoHUEd FIQhiIVhgKO0AKm/JVJDFKj9N3u8kwlOp7kIFP6ZKDGnw6tZ1HHL1K2Wdkwc+62SZvAl8KqgiRkLL khraQcYrOsigd9/6IXpw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1netby-004GMR-UF; Thu, 14 Apr 2022 07:09:50 +0000 Received: from mail-am6eur05on2062b.outbound.protection.outlook.com ([2a01:111:f400:7e1b::62b] helo=EUR05-AM6-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1netbV-004G61-FC; Thu, 14 Apr 2022 07:09:24 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=NTDZ1cCotbZd0IydRa/S2wTNipNbYDF5z9GsgvvnRzjjTxuggEhPFL2cOGsEp5O77c8nktdzOwd/+BAzd1d1LB+zES+hV8gnfyM6Fiqg/p868b6wRkW3NDau5OHihqpstxJ4o7gh/WNfl43L+xf3m6ettrYwLelWyY1tlehiL7R+0NpZcB1nUzc+EmWYD52za0msAlap7QHsctb8aiWVMURX6Kly3wYEdut5eQt1jzoGb9upuYBPvEmvxWhp6Yt/4LoAKFqRASVE/Ki584/FVnkU/WBWIvlnKbuAoeCmBdb6pSZ4Z/FMr2obsRZqIC2V6DQzBQfZIhCJJVJRnxMjCA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=J2oGElILzCk+igiUTrOVzfcg+9IEz0ALDeKTJRlftv0=; b=oVBKG9lfzKYiLoAaOzGU3bsw1OqtpE5QGOwzo9CkjxXD2jU5TMtInuPoFtH6uUAInhMV/Gkrbh2eNVeXCEqgcYTkdVI3Gbock5pmukwDnJy88LuVkacEFOtD/qCdPra1q8Hun9aPEgD7I17MxL7fLeYI05TdHgqJRoatDnxYPc6DpRa4ac3JGD5uQIq5dRpuM4mP10M5gh0ejF4Kkgk9M8f2w1u0eDe8LVAZMnxuf36U/gb+AD4KDscSv5VGCXNvHnJdejHqrdXDrr1dX4jpF4yOY1g6k7kQE60aWUNeJLxhrsHbbIFMtSt8PEj1ExjLeCZgzsLOF9jQ5tVl2Njd1w== 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=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=J2oGElILzCk+igiUTrOVzfcg+9IEz0ALDeKTJRlftv0=; b=E0rMaOWdOiZuXIiy8vZFLGScTMmEtjd4nD5h9yM/XiJMl7jtSDY77HZnQBW/dEvukqQ1X0GCHTtYXn7wl6wGT1gwhll9m3ie23fxJX0tWy9wi7BQ6mGVR8cSeObhDF96ddIrqdBPFIOp/w+FimUDqafb+c8UwsAZaZ8yizEdtrs= 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 DB8PR04MB6714.eurprd04.prod.outlook.com (2603:10a6:10:10e::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5164.20; Thu, 14 Apr 2022 07:09:17 +0000 Received: from AM7PR04MB7046.eurprd04.prod.outlook.com ([fe80::b09c:8ffe:8e02:7387]) by AM7PR04MB7046.eurprd04.prod.outlook.com ([fe80::b09c:8ffe:8e02:7387%9]) with mapi id 15.20.5164.018; Thu, 14 Apr 2022 07:09:17 +0000 From: Liu Ying To: linux-phy@lists.infradead.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, linux-arm-kernel@lists.infradead.org Cc: kishon@ti.com, vkoul@kernel.org, robh+dt@kernel.org, krzk+dt@kernel.org, andrzej.hajda@intel.com, narmstrong@baylibre.com, robert.foss@linaro.org, Laurent.pinchart@ideasonboard.com, jonas@kwiboo.se, jernej.skrabec@gmail.com, airlied@linux.ie, daniel@ffwll.ch, shawnguo@kernel.org, s.hauer@pengutronix.de, kernel@pengutronix.de, festevam@gmail.com, linux-imx@nxp.com, agx@sigxcpu.org, robert.chiras@nxp.com, martin.kepplinger@puri.sm, Rob Herring Subject: [PATCH v8 3/5] dt-bindings: phy: Convert mixel, mipi-dsi-phy to json-schema Date: Thu, 14 Apr 2022 15:10:37 +0800 Message-Id: <20220414071039.423271-4-victor.liu@nxp.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220414071039.423271-1-victor.liu@nxp.com> References: <20220414071039.423271-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) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 2a2d7bcc-db4c-4fad-865c-08da1de5b07c X-MS-TrafficTypeDiagnostic: DB8PR04MB6714:EE_ X-Microsoft-Antispam-PRVS: X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: qE9My7+/runUOCq5/SMZOCu4wIFby4/MlKm0Fe9okNN6IYCnL+1txMcWwQdwn8FA/u/2yAtW5z5T5qxYmNSXxN0HatmpbU+qTtyQMzUp4vXW8sFJVWJM7JGv5CHgtDCKE+u8nMZPF/1cLtY3FyflMnZKvbWuOLAnGhrHGIhLFta5pgrhvnIehUCR8aWw76T747U2XDEXSzaKHxsbnztumpKo8oPwBupqv+PFdzQY/LUgDlGMoXyvOtcemEoeCA1Dd6/LHBbJ1A6ErYUdgeWZKZY4yZxbXoiE8A6LH9/gC4MK7QHMkXucnRGAeevezv4wf78vmuHNyjr+6xnAUftOfaYNldLMhLHE3g5M917yUCGrQiS2Y2iXvslI8JBAL83n+/wr1JNGTCDE5JVSQ6JCViGr9Jsiomlc2Rbj5quBfx1jmsR2r/oiC9kOFL4rJAIeQIPje/GqEUFEPVQ/D81VNwLtxstxFuaN952synGCwWC/kZda+Rdym2Ykx43wlYMNs2JVM5nEDqzPKTYfKp2Lc8Oqn2xxjZhvg+FFCcaP83G9qQS3Xq4LYK0ctSwTWjlk1cYw1Uklew0ZSJizZg2MrNdEHIbC/5mcIphlJu35An76J3c0MNeBAJ1SbVHmGLPRUJRSHSn2+JCkILoEPzLzHeBplJ7OKZ2ouqFyBBhIYw0fDeY0n6hHST83NpBNi2OkUjwpRFtdzMXR3FDmxYXyoM1A0l1achCWwJ6Efnd28aNQJyPv+UvwOz4IEVvG05k82zWYHqIkX7x1ARg5gqTlRjwumuFbVaptHfFGoD1EYqQWu5xNiylyZq93ST6Eb3KCpkCXcUvzAv6XDrCDzBlQLw== 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:(13230001)(4636009)(366004)(966005)(6486002)(1076003)(38100700002)(38350700002)(66556008)(316002)(66946007)(4326008)(66476007)(508600001)(8676002)(86362001)(2616005)(26005)(6666004)(6512007)(52116002)(6506007)(186003)(7416002)(2906002)(5660300002)(36756003)(8936002)(83380400001)(66574015); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?SsO4GANtyM5/Vvd8YUv8gQ65ZKJT?= =?utf-8?q?zw1PU0JVFwPqOxmLIV/Adus3IO1WtDV6L1B6Co4wDEGNJqPTxuD1WC8nIE6JAq7PL?= =?utf-8?q?yDWU+jpE+qFvRl4OQT+B+aNdUnVxWI/jz6qJya4wZKC+c5hotMFeNHa1clo6u/fP4?= =?utf-8?q?n8BEFEH+nohPIW3EkK+8i0/shf0p8azli1FvokszbtEUT9BjpMJ6vdH1ijNaiAewH?= =?utf-8?q?kRBjk189N3CvvZh0YqMJku0XExQIcZ5DWGGdluFMU7T+AK9gI32xM5E6rlgrUTzs5?= =?utf-8?q?AqD+KTS3zaxBzjLeQdxGTCBXm/rUAKWFHquWIgeUheh5ztXkw2i0vczD8v565v6IO?= =?utf-8?q?dv4DP1aFEUGvyETcy8soJMTT7BbwJABCFyydOHet1BKCpXdJH/yLHC9mFzOoxxPLX?= =?utf-8?q?sRvblOzKnNJ9PQlA/xAWdh63ELhAXn6qQ4tuCnJHJLHP9exUhi0j8HjQJgzQmi07A?= =?utf-8?q?EUn0bZ/3fz9FxNaZ5b7uwtq1aDMgkFWAngc6sWO7vi5aDfns+3XzII0Tt62+ag07J?= =?utf-8?q?eleeY7GVgrs6mY6obND0smHT5UNJABaeGiZk0V2TknobQBXyYwv3MaAEEfZNhSu9i?= =?utf-8?q?a9ZgBHkWJXpcmuLRk8iU1fuM3DVdMFfMhmPl/5zNYVpIpuRp+DOzfmlNKtSweZQ+i?= =?utf-8?q?HtyzQilgpYz5k1hU0QQBsUvCHxNekb60XDjWhKXKNbHVZWQU/UWqQnSrEiZOG0OLB?= =?utf-8?q?ADbDWguppJ2seb1NCS8CnhIXSr4VW51OOOd9zsFXdCdRvFid+lsM6FL+9UFg4Q2ux?= =?utf-8?q?aDASK9Yzg8HM0vEkdE3BBa6xTBy8VsG12ypJi6qi6laLSC1QCLTW39WenoVAvhhaQ?= =?utf-8?q?irwLvI8PPGiCIUnVj1jQhnFCnv8/t7UsqqdcViEUTELvBixu2pG8HFaLMFbN7Yb2z?= =?utf-8?q?Ua4IIKcTRniTuE6HLGgpSmZyVqcfz8pkE1h7UBeA5yUyel8+MaPx0NmdDqkW7lxTm?= =?utf-8?q?KDtgZL+D4j1HMdI4U5HKbKhYTxL87kW8AvaoWtRK7nc6WmpvnnMaPpi40OU5l4TJS?= =?utf-8?q?Mdf1OflEJ283nhK5NpZGLkBTqA3liF8rkmuyu5qKM88UoB+8mgVc/INMYb1tUpeAy?= =?utf-8?q?QcNJTVIC4841E0tO5X5kaksztRyXn7fKt60Sgz7Rn3DRtFxPe9dm1BBQMk88DlSQJ?= =?utf-8?q?W6IpiuM6ith0n9QJxAO6x4XwZVqqk3BUvtZI/YpLCccp1o2gzleUBT4Z8aTHnILMi?= =?utf-8?q?leBlwZkhoK9uO1jrjaXkEKRp6jZwt9rpndExh7yZTSeDtD7C8WyAyg3f+7cx2lrpr?= =?utf-8?q?Q/rVQBga/YrpdwQ9Dc01vr4wKhXEJ/kE83oXmIUK0ifo/gDUrb8nEl8U1xPYuiwAO?= =?utf-8?q?Mh626M4OAjKvtS7V1QckZZSsz2U5rnBNpFsyB7Kfxrj/4T5dHhB1kYYilEDYyrnSJ?= =?utf-8?q?fH5ncpi8Bo/ud5rs2jQqY0Pzhb2reLlhqyv6uWrpzPHTl2XAvDxVmfERuuLkcKGGe?= =?utf-8?q?twZ2aN3iFt3SXrTAA+bS4t/Auk/CLAyTEsHf+xPwoq98CyO9m4gwbfvljzRLvQ2Wv?= =?utf-8?q?qcsUC660adE6w1DW+N7XuGleopdExvPt4qOvBtcOrLNMM4dwkAoArYcx4hJSZlPiv?= =?utf-8?q?nBE2CAuGzd3uf2JsApLBtwGz78hN/dlyoOQNEHjVbxpp7c6n8e8VJGRLQciqDyG1F?= =?utf-8?q?43t8C+KaXRu9O8eqt2pBNQhs3OvGCC7A=3D=3D?= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 2a2d7bcc-db4c-4fad-865c-08da1de5b07c X-MS-Exchange-CrossTenant-AuthSource: AM7PR04MB7046.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Apr 2022 07:09:17.3888 (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: sbCC5JmQ1gSmWSGMYgUYd4lph0heVRfW4Qc0uWmGlNFoOZxspTuhg9pr4bfZmziKpM34NrH9tMHUHllfxYTc7Q== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB8PR04MB6714 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20220414_000921_594812_F2CA45A6 X-CRM114-Status: GOOD ( 16.69 ) X-BeenThere: linux-phy@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Linux Phy Mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-phy" Errors-To: linux-phy-bounces+linux-phy=archiver.kernel.org@lists.infradead.org This patch converts the mixel,mipi-dsi-phy binding to DT schema format using json-schema. Comparing to the plain text version, the new binding adds the 'assigned-clocks', 'assigned-clock-parents' and 'assigned-clock-rates' properites, otherwise 'make dtbs_check' would complain that there are mis-matches. Also, the new binding requires the 'power-domains' property since all potential SoCs that embed this PHY would provide a power domain for it. The example of the new binding takes reference to the latest dphy node in imx8mq.dtsi. Cc: Guido Günther Cc: Kishon Vijay Abraham I Cc: Vinod Koul Cc: Rob Herring Cc: NXP Linux Team Reviewed-by: Rob Herring Reviewed-by: Guido Günther Signed-off-by: Liu Ying --- v7->v8: * No change. v6->v7: * No change. v5->v6: * No change. v4->v5: * No change. v3->v4: * Add Rob's and Guido's R-b tags. v2->v3: * Improve the 'clock-names' property by dropping 'items:'. v1->v2: * Newly introduced in v2. (Guido) .../bindings/phy/mixel,mipi-dsi-phy.txt | 29 -------- .../bindings/phy/mixel,mipi-dsi-phy.yaml | 72 +++++++++++++++++++ 2 files changed, 72 insertions(+), 29 deletions(-) delete mode 100644 Documentation/devicetree/bindings/phy/mixel,mipi-dsi-phy.txt create mode 100644 Documentation/devicetree/bindings/phy/mixel,mipi-dsi-phy.yaml diff --git a/Documentation/devicetree/bindings/phy/mixel,mipi-dsi-phy.txt b/Documentation/devicetree/bindings/phy/mixel,mipi-dsi-phy.txt deleted file mode 100644 index 9b23407233c0..000000000000 --- a/Documentation/devicetree/bindings/phy/mixel,mipi-dsi-phy.txt +++ /dev/null @@ -1,29 +0,0 @@ -Mixel DSI PHY for i.MX8 - -The Mixel MIPI-DSI PHY IP block is e.g. found on i.MX8 platforms (along the -MIPI-DSI IP from Northwest Logic). It represents the physical layer for the -electrical signals for DSI. - -Required properties: -- compatible: Must be: - - "fsl,imx8mq-mipi-dphy" -- clocks: Must contain an entry for each entry in clock-names. -- clock-names: Must contain the following entries: - - "phy_ref": phandle and specifier referring to the DPHY ref clock -- reg: the register range of the PHY controller -- #phy-cells: number of cells in PHY, as defined in - Documentation/devicetree/bindings/phy/phy-bindings.txt - this must be <0> - -Optional properties: -- power-domains: phandle to power domain - -Example: - dphy: dphy@30a0030 { - compatible = "fsl,imx8mq-mipi-dphy"; - clocks = <&clk IMX8MQ_CLK_DSI_PHY_REF>; - clock-names = "phy_ref"; - reg = <0x30a00300 0x100>; - power-domains = <&pd_mipi0>; - #phy-cells = <0>; - }; diff --git a/Documentation/devicetree/bindings/phy/mixel,mipi-dsi-phy.yaml b/Documentation/devicetree/bindings/phy/mixel,mipi-dsi-phy.yaml new file mode 100644 index 000000000000..c34f2e6d6bd5 --- /dev/null +++ b/Documentation/devicetree/bindings/phy/mixel,mipi-dsi-phy.yaml @@ -0,0 +1,72 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/phy/mixel,mipi-dsi-phy.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Mixel DSI PHY for i.MX8 + +maintainers: + - Guido Günther + +description: | + The Mixel MIPI-DSI PHY IP block is e.g. found on i.MX8 platforms (along the + MIPI-DSI IP from Northwest Logic). It represents the physical layer for the + electrical signals for DSI. + +properties: + compatible: + enum: + - fsl,imx8mq-mipi-dphy + + reg: + maxItems: 1 + + clocks: + maxItems: 1 + + clock-names: + const: phy_ref + + assigned-clocks: + maxItems: 1 + + assigned-clock-parents: + maxItems: 1 + + assigned-clock-rates: + maxItems: 1 + + "#phy-cells": + const: 0 + + power-domains: + maxItems: 1 + +required: + - compatible + - reg + - clocks + - clock-names + - assigned-clocks + - assigned-clock-parents + - assigned-clock-rates + - "#phy-cells" + - power-domains + +additionalProperties: false + +examples: + - | + #include + dphy: dphy@30a0030 { + compatible = "fsl,imx8mq-mipi-dphy"; + reg = <0x30a00300 0x100>; + clocks = <&clk IMX8MQ_CLK_DSI_PHY_REF>; + clock-names = "phy_ref"; + assigned-clocks = <&clk IMX8MQ_CLK_DSI_PHY_REF>; + assigned-clock-parents = <&clk IMX8MQ_VIDEO_PLL1_OUT>; + assigned-clock-rates = <24000000>; + #phy-cells = <0>; + power-domains = <&pgc_mipi>; + };