From patchwork Sat Apr 2 05:24:49 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Liu Ying X-Patchwork-Id: 12798981 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 gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (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 8DD4BC433FE for ; Sat, 2 Apr 2022 05:23:42 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id B1D5810EBBF; Sat, 2 Apr 2022 05:23:41 +0000 (UTC) Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05on2085.outbound.protection.outlook.com [40.107.21.85]) by gabe.freedesktop.org (Postfix) with ESMTPS id C947A10EBBF for ; Sat, 2 Apr 2022 05:23:40 +0000 (UTC) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=acDtFvfTJEisL2Dhx7JarTttw1v7RLPKjr/iema8VW6AOrMIiGGfTQqq6+zv+BU1eUdUk3BdBctYEkYfp4gDSGFzo2RKBiZtvbMIsm+kKe41ysq2kDiupwzDWJnSSBA3Gy2fA8Y4zGvfZkTE+hrYRjbvLyM8ZiZxHtQwlbMwidh5zK3UcAy6rhE83hKL0exKesCQeC5k/fbBsef1Ws8IA/hTTcIlPwKKqmz5S41BrppjWd7+Dk17LeOgV1UyRTqsglRpoFje5w90ZTpNoqEGiERqL722VCW148yndtx8XTiBimCP5/DpIMH34ZZ01QtI8pDy7YqEU/zOPKi4jBEBVw== 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=4QMNrjHkSzPkfgPuClD3OGPsGuNeGuSlP1cKorrZli8=; b=N4euGZm7yf0USDRpM90POuLyhowuD/hPRtOmPum1kiOSeLoEKfMHZNQf2le1A0t3gwyIf4VEXJMxvvcGfez8hkHx13Jsm0rDdqdeTaZFktui8ubsXTG0wMSIXj3vS/N+p0S58LisN+5ZY4c49hmtCTdYtMGJ9ev6mbc/CrH+Q9mRjfqFwVbomUhKJmNXoOwPDSM3IZvKEel0bGkBk/WNF3WW8LFow/0oNcGrj6vCwo4YDh2tmY60OHU1f+VsrZADN+zuCoS8EABYVAdTtOs7VlwmttEbQmgaU8xayj1p7IeRgzvkRsZdUYtRA5batprLWc+75zFXfLGx0370FvrwrA== 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=4QMNrjHkSzPkfgPuClD3OGPsGuNeGuSlP1cKorrZli8=; b=Mo/faPxyHhYDtgG+0O7mPJ6lo/rFv+QX5Ir8SOTEMrZfhhGJ2nGFKH5+Esj1rEQET53+T9KBGqRVQNphGouSgsMqL5SyKzMlDcxMwBxGIXPlS5z6RMMQL0BfkLN78T8Il0Z3OjIJM+TdkNLoLobmv1SIm/lcbxYi62h318Sk8VM= 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 PAXPR04MB8750.eurprd04.prod.outlook.com (2603:10a6:102:20c::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5123.30; Sat, 2 Apr 2022 05:23:37 +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.5123.030; Sat, 2 Apr 2022 05:23:37 +0000 From: Liu Ying To: linux-phy@lists.infradead.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, dri-devel@lists.freedesktop.org, linux-arm-kernel@lists.infradead.org Subject: [PATCH v6 resend 3/5] dt-bindings: phy: Convert mixel, mipi-dsi-phy to json-schema Date: Sat, 2 Apr 2022 13:24:49 +0800 Message-Id: <20220402052451.2517469-4-victor.liu@nxp.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220402052451.2517469-1-victor.liu@nxp.com> References: <20220402052451.2517469-1-victor.liu@nxp.com> X-ClientProxiedBy: SI2P153CA0008.APCP153.PROD.OUTLOOK.COM (2603:1096:4:140::19) 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: 29da1dc8-4580-4e84-1640-08da1468f048 X-MS-TrafficTypeDiagnostic: PAXPR04MB8750: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: 3j87+0+hCjeDDnjcn2T+8KxOaXQ/DdMF9sS39TKv7T5Tjg/Q6U/r1eTB5ITWORyUbG8D1fim+W625scfcGazyzRC3ABbLDy2FqTEX3hT0hjTB4z9RcqGFdElRf/Vma1HdeMrRFimzV2UQEuR+4wxwBLjq0CTqWDFHv8j9AbnHtiADPsBYv9/bF7GDmqyreHIVgHJv0uvF2Gt+bZ3WsES1XFQl6UcRxasib8CeBbqn/RtKu0kSVHH03Do0q1Zu9oJo1lo3vq6I0DLGW0nnzc4z0ijgukPQQ7yu9BBEy1HQXWfNZpBS6lkb7btSGhNXiFRbvjdnD2M87MF9+K/XoFaopQOkHBAkEwd1JbvVnI82NXYp8KwxvLDW0+TOTGIpfOukJQVbA5ZQYR5IOBo/ZoHpzEbMQTmLGDRjmDpi5NytYaRGJ4Y9y3Ws5CJU3AH4jVsaLCbabpLk5sujMJGg13iHvllH+43SRXi33pgqqugyAB9dJEHJw+zeY86BtGwQRoLHJFUVjJxmuKhPyxWQDvCtb+EwXDVeUC9r7pY1nhL41Zx3zFSIZMEECcse7pJxtyl2pCF+qwGlK58F8KNGVT6H+jG0/YPBZpzSd2M17YmuGVNgKGNDOEVmPlCFBQ3XAEbJ6fs08bifG9kydCl0kjYWvWCEmxkOA/Nf3YTVjMhNjvnxYPMHX2EtlbEglT0FTgNoEK1TpcxzIkC2H+iu6wsU1Aeu8Oq3GEsuUZ/WlBKNLBv0FFpmfMKOGjG+LZDQVDa7R1QQdi38MemQYcuY8e78VGWCvD2YlIl4j/eGif0BRUdgZYGsuuXo9iAWgdSRFM1WxWicdHhSSL5J0VgHkQYCQ== 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)(36756003)(966005)(6486002)(83380400001)(316002)(6512007)(52116002)(186003)(26005)(6666004)(6506007)(66574015)(1076003)(2616005)(508600001)(7416002)(8936002)(86362001)(38100700002)(5660300002)(38350700002)(2906002)(66476007)(66946007)(4326008)(8676002)(66556008); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?13AC9dCo9Fh/7AzuAA2nSEObormR?= =?utf-8?q?OqfuF4VXnKLJNtp+w68D+cZw6LwMkKyOW8G4OQNstiGQuT49cZJx4DQBL2lLiJFup?= =?utf-8?q?szhjUlyrOUkjyRsjEavrnWGbcOvOK9fJzA0pXJcv1yRDbDsldqiOqVCaJrzENle4y?= =?utf-8?q?Fr6OFZhkXJXnY8NtwOQalFU79Me8NrtUadK1xCi77fdWGbzsdvO6uK6Y6/cP+E0cl?= =?utf-8?q?b2C87IdDEvmA3lAgFOCoG6qh+5BLD1oEgamLi4RuFGAxWkFIezt2Z6PSZL56C5zXx?= =?utf-8?q?pnVAagsQN+21XSopexmY36mf8MkPl8xJVXe+rKcRK0/NxhfVyADK6/05vmxO3LL8O?= =?utf-8?q?Xqyr7mF1Tw7PKBFEOP4wzG6TmhZIAYyKYqjupEZjmHW3j4UL8APhrGuoDjdTKJgKK?= =?utf-8?q?rT5eKKYBRE+73sEUi7hrcYMMAzsKUAwx5GzT1acJHvQ04g2ejjcdlD0MBzWPGkHpf?= =?utf-8?q?H8h2mw9l8LF7GnXnQimXoEG7IJGn6kr2HOTEkpRFLBhTbyeO6UdiB/9aAQJTwCLuX?= =?utf-8?q?aCgfZytz6EgkXAGmA7KZTVvPohWrzmPQlI8aFmEsnH4NUgBYXCQqqDHnG62+VL3ra?= =?utf-8?q?7rb+NSnzwNmdVvE020t+k624jaNSYo5753AnryAJQicHGbBiAjiYwkFPLTtsQMDSC?= =?utf-8?q?wjw22V/hQT40sYWuXf28CLVQzwLzFmJULyn6zL1NKOYyAN8a4Ygc1hW5W98kArt9m?= =?utf-8?q?tsLzAlBrNsXLtT1kzuZKZroI0DxjrVBYYUuIsGb4LPlScU7qWQFjRQigVR/U9tCGM?= =?utf-8?q?t49AjlvHOUcQFRDpE8D3aZzkucokUvAXMqqBFnfnpQBELofmv6Mf+U2X6R/krNKQF?= =?utf-8?q?6LBloRXPb6jB17muuMLG1s07/1LQRlQrHgo3Fe74mMCFl3YM2wvA6BXx2CRJiu+sO?= =?utf-8?q?ZqTqzwW20eXjSKKNwWQFxvmOJGF3uVj7K6incOQbFnKP9aeOOrebHG9ovjCZmihYu?= =?utf-8?q?Uk+vpIMsoH5puFgcifeomNzRkbt0cAmfRnDsftrimjnXIa/Mfu309F3tEHA8MJpdc?= =?utf-8?q?l8D7WyHN4TztztgMXl7jxiF2LW1RRikGvR690knED2838FQtwcbTvGG7Idqxr2Jix?= =?utf-8?q?VWiWz+o/lzN+E64UpSxQn5E6UQHHRaeuabY6/vCxtYeEns8o+U7sgn670sFc02QBF?= =?utf-8?q?2Tq59qIy+YOvUM4k0M1L98C2WkIzCIEHHhGWgRbQWGpp7Wf/4vYgQwkl3mvqyCHq9?= =?utf-8?q?Lc9eQIfjUyWV1esUzfADT2pbYKuEKqj0dbBWTXlBhzNwNJeoF/DnjDcWx+0LeTVDp?= =?utf-8?q?4N4V//6I/PnYNT1fRPFvpwgRRcHS0wJNlXbsFywkRqv+y+OsOOvLgLRpjhjQVeARY?= =?utf-8?q?lWNaIqmNSRXeFpQi0Bs0dJC++bmUl6pnCZE6xKf6+hlu7MEhpKKSDxsKItbSwfsNm?= =?utf-8?q?k9oGbXTzV9NlE8NldIpUKYCZuUHfa/KzSanhx2ANz/l4UAuUS89gRN6DnmRq3EWoU?= =?utf-8?q?f7rt0gsz8zNBfchNA0c6pCuiQPP0wYSgpxQn+xmsQRbsC8hd/6/mQWDWf0jzBODV4?= =?utf-8?q?fyeiOxusIC0FMERl3dLyHbYp5EL7g8Brot5rY1sou9Fb7gsfCuFtp0yVCsJpy9q/O?= =?utf-8?q?7oL959PB12b0lvP/IOJCuXZOQNAtjpYp0QwSmA/nskRC4TEBzB9Hbqf+yZG4vP12f?= =?utf-8?q?9iZqnCrKfaLyM6ZjHAQ3+enja1YC7nDA=3D=3D?= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 29da1dc8-4580-4e84-1640-08da1468f048 X-MS-Exchange-CrossTenant-AuthSource: AM7PR04MB7046.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 02 Apr 2022 05:23:36.9957 (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: UO7g9EGPaD1FJHRvJC6qhJU8EzQotgyoBJFIR/pCD8FB+A3zDwH0Vuy48xR92eBIdAobkECP6RkvlxTLbBkpgw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PAXPR04MB8750 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: martin.kepplinger@puri.sm, agx@sigxcpu.org, narmstrong@baylibre.com, airlied@linux.ie, s.hauer@pengutronix.de, jonas@kwiboo.se, jernej.skrabec@gmail.com, kishon@ti.com, vkoul@kernel.org, robh+dt@kernel.org, Laurent.pinchart@ideasonboard.com, andrzej.hajda@intel.com, robert.chiras@nxp.com, shawnguo@kernel.org, kernel@pengutronix.de, robert.foss@linaro.org, linux-imx@nxp.com Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" 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 --- 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>; + };