From patchwork Tue Apr 19 01:08:50 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Liu Ying X-Patchwork-Id: 12817188 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 6BC2BC433F5 for ; Tue, 19 Apr 2022 01:07:56 +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=TZxU4r+O9m/AQ1 6ieo1ab2d+1K/O9h1c5l6/L/+92JkCUB7NuaQndkBjwB/XjEqGqUIEorDZr7HVC0ooQVcc9H7Eoc4 iG6K8AK2Pxv8SR0cenkFiAmlPooEUHdHz7ppgX9JbOgiDkniqqAddTVIc9/MWeTKRz24dwWgrDpiJ vFH3HR+KdInNcGpkMm8by2Lv617uKJGvJqOJyrlS1ejQdcE+Hx/57gu36gb4ZSG/ZUoZ36QFcl+Hq lIgUc42+T4SrTZ4xzZoKGbKXOAOSvyzzFGzRwjaE0PAnUZYJ1rRKfKJttNyGZYBjMKC8WQoyEhXsY 4kPA5nO9+XVNAseUU5nw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1ngcLT-0010g0-Ok; Tue, 19 Apr 2022 01:07:55 +0000 Received: from mail-am6eur05on20627.outbound.protection.outlook.com ([2a01:111:f400:7e1b::627] helo=EUR05-AM6-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1ngcL8-0010Va-Ee; Tue, 19 Apr 2022 01:07:37 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=bBfCidynRtAwbJMstiuDkmscrWPNZ+X72vxuFD3M32pMu9ga7Vn570hM0oWCgkAk2J3ogVhh2MBcyQo8ZDIXno3mb46DuRUgTf1qebblfSnFmPQgNW5WpYLlNa8PtMOHpGEL5OOcdOFwvFp42jNjFUvzfUFczGmmwSBTXSjivzDL266McyS/ThwNja2BG6gnq5sRLGntF6CUPm1cjwj6Lq0xQh/zCPzkD0y1CwTBsqh9KCArdMfYgJihAdu3IIEX9n38TIFtcjRQdmk4wK3QFXyerhjyht5hRjqSlsdnMviPDSejgFWnE1Crpae8zvCgTCbpGTbjTHqaRbl3eqZ9Kw== 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=Fezq8evn7PGTALQGOq8cdhU2PZhZkMXUO3XkqkiP+5fqgAUaau/n4Dl5rpbnWpAxwwcIRBvyq5fsRsm50kmIzxvu0pgy4S8JsBtF9j1V2LOpPYj83sEsLmiy5Ma3ebL2If0icEh7ySwOkxC5GwisXfBS+sXr7QNOcmiGQYAO3F2blSXIxvlnqCJC+W5FxmAjbxke+UwK0lpEDakdBeeyIDHR1n5M55sNl5M90wq81d9fJGME+BtwG9Ljg4XZabD3c4AJho2lznVB3CUHMOpNF17K7An8Q/QOSRFDzS+w8pJo0WBrczu6r41Few8fFODRiZxtVvMK/XbWuZT1IbevDQ== 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=OdjNptzfmi6MnV//wOORAI6uycLJIMob+2GhwnEv6GUu5tmiCysita+I8Wte1KFZST3PMlX2OKvAYDvlkO6q7G/Y+2C5TrsIa0J3xzjtMn+U3tD9Hw3hKNCA8Y/XnqsbLyJr55FFrcxK75ZdOsaXoOcplR24D9IGoGOQ9WHrDnI= 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 HE1PR04MB3291.eurprd04.prod.outlook.com (2603:10a6:7:18::31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5164.20; Tue, 19 Apr 2022 01:07:30 +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.026; Tue, 19 Apr 2022 01:07:30 +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 resend v8 3/5] dt-bindings: phy: Convert mixel, mipi-dsi-phy to json-schema Date: Tue, 19 Apr 2022 09:08:50 +0800 Message-Id: <20220419010852.452169-4-victor.liu@nxp.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220419010852.452169-1-victor.liu@nxp.com> References: <20220419010852.452169-1-victor.liu@nxp.com> X-ClientProxiedBy: SI2P153CA0023.APCP153.PROD.OUTLOOK.COM (2603:1096:4:190::6) 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: 1b3c89ac-798f-4b75-79e4-08da21a0fa4e X-MS-TrafficTypeDiagnostic: HE1PR04MB3291: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: RMWmopOr4beyiq2RJzOTb6KUZprCfaoEnzh4bs7RhhsJ2x7cMN9otIfbfJdzRjfcKkaTAx43L4UYC+fTr8/iGprIsQPFtnczlbZjOAgfCV/ztZSzfpo+494owJbmDZyM8dTuSxB8wn4ZvmevjjTrWGjPOkM8PqkJfVoOOdpoRMBSdRmDG2A7jZi62Z5w7tb53pTInrCd/yfXm8ESZoK7FewtaiNktsFvvc2/CHQ7kbfue4k7Z3TsH/yxFoToj0a55f+7rYq20rYU1fMv+Yy27jRn2P4q+TfXZAGKCk4tHw/WmH+M4g/4CWeUU2wdN9sjvHWD0gHja+PamXQp1JcVWCr6OpCi0xlD2UWeyrYdqWmW19TR0JmhjrPvJfPLeXSA60eYF9y+hQHnH/3wxQC9cG0lDDzba0C/7GogQ5tPZrxO07/XJ44xVbLzMN3hNpKDAgZpaVOvs04REm77BggacJBqVng2TthTVxWEfTPJGTlnjuz7B+dpEzbwljtwmggGmXqESmFEqhkXN5MjqaNa2Ggih8cuA01VxGjiBGxr414AJn6QQsnQcRyB/qtF1CUGuMSntPPdY+St+UMPZyR0J29AJy8jIVpD2w/EaDzT2tIkOQxPzRW7h6ALc7Nac5BilZ7eL6QT0fotokZdE1xp7ctw4C/mFIdegqpL5sBvFmbLjEITrNKuctsIsrkLrCSdvA2231v6nXgWlM00ibRCH3CReiTgsDSS9CQkHnIFpZt0j9EeQWQv0XXaO56DghqQ3r4s6TQcSb/swaJygWMEOgPUNKJwGBVUIBBOgxJiTFlgOpyuJa8GN6JPS8dYr0QHA+uGaa3iv1ZKUvt3Czy6yA== 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)(66946007)(508600001)(8676002)(4326008)(66574015)(86362001)(966005)(6486002)(36756003)(52116002)(6512007)(6506007)(6666004)(316002)(66556008)(66476007)(2906002)(26005)(186003)(83380400001)(2616005)(1076003)(5660300002)(7416002)(8936002)(38100700002)(38350700002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?Lka9RQ0+lmEvsD1d67t+XkBzfL+J?= =?utf-8?q?h6jq+PlgC1YWS4lbKhtFFCyoJk+YjDrs9+p3Nc/aw0/iL+jonKTxYPfKYc0uJu7QJ?= =?utf-8?q?Kb//pZyDAriqg0fwEbR5EdEkGm7YvAOCkxpa8o6x56L7SoknMW5uKuMFipTCp4ipX?= =?utf-8?q?LRzcIhaYMB7e6upz58Ep0ea7E0oLd7rjZwK4GAATSN1ETn1oaMBvKjfZ0RKFcGjyH?= =?utf-8?q?/GyHSxY/qUP4KrcyuZ7O4VkGcVDQBO3lw2pigP7h4PRnldlM28+z1DuE4MaEwue9u?= =?utf-8?q?EoI6cZ8941ZjsXX0Y1XwGORPHhmWYRF8ONqteC9QW3D4NUoZ/6ROm6HLhD2QCyXX8?= =?utf-8?q?eyBfaTDF2obXPq0UAP5AoE+s1qPXCOU4w6RwqHVD6uCbARBr+n5dyjFgtLSTigkKX?= =?utf-8?q?ibxjCSHnfSvSqNycO1G2ToufBA99fE7CmRiApJtyb+tZxFGBy7jzrIZl6lXyPCDuz?= =?utf-8?q?rbpNTlyVVDa4xw+8XmpVYQS8/N/wcXE3zsLWpon3MqI3seRqtJNrUE/DPR28XMjCJ?= =?utf-8?q?oGzYNCgMvTw8wBy+gsIqVAE8ZvTjeaGxDG0nd1mOHTji06OX9z4P8TmOuBrmZbhtR?= =?utf-8?q?sZO418HpHZ+rY4f9Dz2QZrgW+WT5hTSsTtq1XVTt+GvQWGxxbnqFOtUDm6WdecLU5?= =?utf-8?q?F8vFf+aQ6PHY6/fca4dGzf5/SDrGGYKR/dThdZ+agUqj03lClv3Bu4mDBCuvWEwz/?= =?utf-8?q?GzoMG/3BfVCzNtYpcsUAT2kUBxomJLv9p0YEiueEiOXrXgOr2+beo8PmFa2FT+o2V?= =?utf-8?q?2USuVcqbNReXriwiePbl4s5n8S+aVvv7iQe2BxQL33w6+8rTcgPFKNzUJUfwYQVUa?= =?utf-8?q?siqYzqJRP+Fb3eFJxvrdiRjEJ/DGwZ66ybdUg0ZvjwjqOxWFYkLPZpfdK3/pPYQhD?= =?utf-8?q?Xz9H+y7Q+Z9g7nD2Tyn28XSgb6Rnw2rX0WBF+WoEB4Hy/APZbGXKAp+B0S6RHZG37?= =?utf-8?q?GlYBzkrE4lPr/xONcb1PxET3zbvZS5arljViKAHG+Skd+N+jQ0aBAXNMhZdljNMcg?= =?utf-8?q?LZZnNDB3HXoecEKWGdnJJGm3QfmIESIQriGMRBvAcMmcJn7hBbPW++s4jQ33u7krq?= =?utf-8?q?WR43xGACwdvb68BUYhLix4F4nddLn8kKWmotqcgdCt2aqRJ15jT3kL7EGtwBQXdB5?= =?utf-8?q?YmBTCsuP7HZXi/GiETWBN7Yg+ac5yRWUjJujykj7bkHcImwuPGVphFi5J8k3y9N7J?= =?utf-8?q?JTQtqL1XYlHbna/Z3wMMpNTkX4b9vO/aaiiPhETWWtg544lLdjIX33Qg22nguZB/H?= =?utf-8?q?nr265+7RxqzxUKU2P0xbhv2eSW7WAK3XvvV8Lr6qtBxKeSyrg7SbKqBzqfZ55+9Fh?= =?utf-8?q?ZGDMK7DTc/iyzhSq8kM53FDD0/cUmZhv3NYCCbOjLCasdAn6ijxJvrBhN83wFh2Y2?= =?utf-8?q?nVqH85XVD0g7/PAsDMlbL6fakvudxHIfQksurPZqpL2o42xEBg5sRbvQOlCPiiae9?= =?utf-8?q?kh02+YSeU+6P/I0ypE/kgTBgnFhPU+tds3b8WvE5iW/f8ZFschW8cJimHxta1vMw5?= =?utf-8?q?AgbkkwXGeBzDzIpKP5Lq35yc+BOLz2NhE09BGaf/MGbOq/hZ7NFmAzfLpO8Rw/srx?= =?utf-8?q?U64y0TXVhrNmF8+X9RzgVKf1YhiprDeaiCUDCQfnqFRpX7rn+iJvkzJjcUZIC1Mfd?= =?utf-8?q?yRKcclR2Ekf/wZQI4RHhvwzK9Bcxi/Yg=3D=3D?= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 1b3c89ac-798f-4b75-79e4-08da21a0fa4e X-MS-Exchange-CrossTenant-AuthSource: AM7PR04MB7046.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Apr 2022 01:07:30.6789 (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: 2DJXPlal7BcBcVY32rlFx1lzH2vGFVWK6/RQDOJST+m4xMZGbAseZ70jJVAbIWBUuvwMN2jBXyu9LnXbeblQ/g== X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR04MB3291 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20220418_180734_566253_35F36774 X-CRM114-Status: GOOD ( 17.38 ) 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>; + };