From patchwork Wed Dec 9 06:24:26 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Liu Ying X-Patchwork-Id: 11960593 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-16.7 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER, INCLUDES_PATCH,MAILING_LIST_MULTI,MSGID_FROM_MTA_HEADER,SPF_HELO_NONE, SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 0A708C4361B for ; Wed, 9 Dec 2020 06:34:46 +0000 (UTC) Received: from merlin.infradead.org (merlin.infradead.org [205.233.59.134]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id B332C233A1 for ; Wed, 9 Dec 2020 06:34:45 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org B332C233A1 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=nxp.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=merlin.20170209; h=Sender:Content-Transfer-Encoding: Content-Type:Cc:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:Message-Id:Date: Subject:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=tL17OmX/0OFb6SLbCneilQ2Hz6iFzn8LPZE+VjCfDBg=; b=bYTKmspVIkFZarNzRvGW3z7Xp pLOhiBnBMEp3JYnqgC2grUGH1hAUNqwRiJw9drmfGN+uWnxfxb8hSFmY1sQ6obI3yp3rehO0B5HID /V7Si4B25L2MhZjcTcQoC668ID2riGS/CUV7bj14MLvrOVlWmsUjF40piIyTzspfvpsJMcd2jGUKP +YsAOYpf38cU0zDT5aMmcs9e92HhEmu5BoH4zwb/0xXeUSWXbRub/uY0aQHghme3Ui9mxHzLlBVI+ aLA+lnZ2sD1uSO+LeyyUttoZt06/awCKusosCRO36YeFsfyo0T3+Klf96pCopa0dMiSpbYgPTKVsJ XPpNZq5+Q==; Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1kmt2Q-0005LR-Gt; Wed, 09 Dec 2020 06:33:22 +0000 Received: from mail-db8eur05on2065.outbound.protection.outlook.com ([40.107.20.65] helo=EUR05-DB8-obe.outbound.protection.outlook.com) by merlin.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1kmt2M-0005Jw-Ua for linux-arm-kernel@lists.infradead.org; Wed, 09 Dec 2020 06:33:19 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=bR2B5zcl5I+q8O5wQnu6Wdz/x8ROf6IY5YzHz88iDMPG8N19y6kf70lBR1Akl4oKJE1Rvc3OveJACd9dndIVWNExjXbwJ0z1QIDgV1/uk2GYXPS5Ect15EcoL2uuhsXVQI+kheNN+nJ98r32tqKD6peRK7um54MwBER+VtUsaWhvxIUN6xEHoOPqV6gT5oLRk0b0uk/InmWdCEM52NGahCahQLLg49M182tI+pE80med7i0P4oRK6xE0UdPydpu98QdWvQMx5ue3083gZ35Kb9x4OhSg0OlQBsenj6MofgotVIwNNRPXJyvox2UgKwxUs4i1efTjtzoC4Y/lOtETng== 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-SenderADCheck; bh=UlVIqCF3ResnuFKj8jDnBInEWttMi/afewLrFoCzYy4=; b=D7FOnCQ8qjzcYs2Mc9k+xOeu5TZH+2VSEVIqNiOtq2tFome2DueVuEs5ySH5j+934bgYCr+70l6WpqYPCkuhzMYm68NFHU/PC1pkYTP3uAeOj1kuHt2e3OiNGPbLE0al4o3geDZ4lDWGL8TCP7Gyc3BLJ7EB8Dmcpis+auKTJIXX1IGcu3j+h2VvFp/APEF0Vd2AWgYTUQxPgbtF50m3xxse1bFL3Z2rL11A+Ra63Dolfl3O8XWmwk/KlwqexFffWe4Gd5vtRwtwUnoi1WWtFNVF+fzueMDqz2NNRVeK0oxOvZBLMn6+F1IFd+Lu1PPvbitI+3zDvDJSJ854yL+VLQ== 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=UlVIqCF3ResnuFKj8jDnBInEWttMi/afewLrFoCzYy4=; b=fEUQU7RQI+WArBmlZ/GNwvM0GZV/4wfiMMe4KYdyJKfL527lCGriBfz6JhFGDwWSYiGHR1dXwhVpQ7C49aJ89mPwp+yiB/Cq5gnrKKmDNQTgk4zpgebcb+TlkHE5ZQ/nKCquvuPHEwZ2Nb5CSxI6P0VJO/pqeSw/uFCzrKERvAs= Authentication-Results: vger.kernel.org; dkim=none (message not signed) header.d=none;vger.kernel.org; dmarc=none action=none header.from=nxp.com; Received: from VI1PR04MB3983.eurprd04.prod.outlook.com (2603:10a6:803:4c::16) by VI1PR04MB6144.eurprd04.prod.outlook.com (2603:10a6:803:fd::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3632.17; Wed, 9 Dec 2020 06:33:12 +0000 Received: from VI1PR04MB3983.eurprd04.prod.outlook.com ([fe80::dcb7:6117:3def:2685]) by VI1PR04MB3983.eurprd04.prod.outlook.com ([fe80::dcb7:6117:3def:2685%7]) with mapi id 15.20.3632.023; Wed, 9 Dec 2020 06:33:12 +0000 From: Liu Ying To: linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, dri-devel@lists.freedesktop.org, linux-arm-kernel@lists.infradead.org Subject: [PATCH v2 3/5] dt-bindings: phy: Convert mixel, mipi-dsi-phy to json-schema Date: Wed, 9 Dec 2020 14:24:26 +0800 Message-Id: <1607495069-10946-4-git-send-email-victor.liu@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1607495069-10946-1-git-send-email-victor.liu@nxp.com> References: <1607495069-10946-1-git-send-email-victor.liu@nxp.com> X-Originating-IP: [119.31.174.66] X-ClientProxiedBy: SG2PR06CA0148.apcprd06.prod.outlook.com (2603:1096:1:1f::26) To VI1PR04MB3983.eurprd04.prod.outlook.com (2603:10a6:803:4c::16) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from localhost.localdomain (119.31.174.66) by SG2PR06CA0148.apcprd06.prod.outlook.com (2603:1096:1:1f::26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256) id 15.20.3654.12 via Frontend Transport; Wed, 9 Dec 2020 06:33:06 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: aa97d772-ec87-404b-5f87-08d89c0c4da5 X-MS-TrafficTypeDiagnostic: VI1PR04MB6144: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:7219; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: ckiPI9h8cplZwygdNyDWwmzuNIvMKcthP3hxpFsxSW55Nd82vHYjDfk4fjmKpt+8BCyycF3D06cw77kkOCMvEAJLkYCLGTkhYtjBsHfmS3qhM4qaTaPWJ9LwUP/yxEWIhF5mhJVTYIChDpdAPPA6aaGDWvxYggplrGHcpVkzG3mAcqssY0VVtYqQhTy0QlLDJbvxlOlA7dhMog3FJvoW2yMfy6WRLC8D9Jjx67f87JFQVB1tpleLRTzA8K98D5gwR96wlaFuRkORQ0E06ERtCSDBuQYGVjTuSs7vo/Mvc/SAu+ON2D5nBv885lUiB4aJ+nuYMBF2nfZhEMjsWO4vS1ODuycHytwzhlVfb+PBJUmoC5gAjpZS6HQRQso9zd3i5KjvFIc8tWEDkKoY0p11naRv4yoAQFxAGEqOZFGBKt+TYog5Vsz5577CnYC53AttJEsSO8PCLsao5YDvfoywpQ== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:VI1PR04MB3983.eurprd04.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(366004)(346002)(136003)(376002)(2616005)(26005)(52116002)(5660300002)(186003)(16526019)(34490700003)(8936002)(8676002)(6486002)(66574015)(6666004)(66476007)(2906002)(7416002)(956004)(36756003)(6512007)(508600001)(66946007)(83380400001)(4326008)(6506007)(86362001)(66556008)(966005); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData: =?utf-8?q?whmjqMMFFZo+SJcaB+eBNEeyLyPJqW?= =?utf-8?q?CBvsp1BQ77IebZ66hh/vcEzk0NV2hSFJHuqvwnfjHr5R8/qSldbm66/+t414yi5si?= =?utf-8?q?eMp65t7O9+ENLQEQ9L0x9akdm5BkXRPoNGDdPNx84sgBEalYvniqp1E0QckFduo0E?= =?utf-8?q?q4DX+9zJsFnyNpURsmx9ffoOnk7J/zIYuLylgYSJELCF7fKA/OTNkvCE6IhRqpvl2?= =?utf-8?q?X1XjfySakVOtyofatdptUYPut9JWQySKj8/8/i0ILJn1/upRMFULpnLuUo3k3YNVA?= =?utf-8?q?QYzgOHYqeQIN1LuPprW1OqQThX9xZE0aQSBR25kcF2IdokITC6bUd0c9Jiv0zwQvr?= =?utf-8?q?JLpsN81qRPu3SncmFkgf3xF2kVQ3xarZNifmzWNYbVkM1Hy/kpX6UcAmEClDX9n6P?= =?utf-8?q?w0KIRXpSagtmpgNbeIPvwIlA+87rX6u7cOu7DHGQu48OBe6yN90RY/Xl1GjAfqVYZ?= =?utf-8?q?I19Kp3rgrVOlDGHSF4PUfTCrtNrDq248ZoW6E73OZbDsBbalBxh6IvwhLKLL2Phps?= =?utf-8?q?DjlU8rNfdCt+F+sulu17QHZZPQuVGdGfPpq+PU9dLbQDyA7gtvlcfj1ayrZ50Ed7+?= =?utf-8?q?H/XO7aTBGSfxnyHy57mzCxdYduBNA4lSTXQd8hgKWBCpjMZEQwLWQSXpdey5J/xc1?= =?utf-8?q?vc5JyWLXdCq3vGpie3klMHi//63AHCwQBNuAMTnqgVkSTQw48DGIbL+y2DhH20sDF?= =?utf-8?q?u4QixmRre9pKk4ELodtjV3jbj/OYkO0zVGGEDxM6Z15L9KFhexU9Civ/6F3jmXK3T?= =?utf-8?q?8ooNFIOADZt3IFTmi6ABwB+8hxZ77IngBOzEMEyj67XCWreHOvBK4O4MxR4sczgFh?= =?utf-8?q?/jBFPBZCUbe58DgKl6iCqLXgCEcRNlkVqN7S1A4WO5Oyq+w4SxrnqwLtDDmZO5TIV?= =?utf-8?q?It3bJ2/+u3QApGUNzrIeygbxfdPLvRJBPqOOgKwjI6Lxv6wCRdg/2XC/huPaUHhiy?= =?utf-8?q?yau+zzrLoCrqZZ/oSz8?= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-AuthSource: VI1PR04MB3983.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Dec 2020 06:33:12.7900 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-Network-Message-Id: aa97d772-ec87-404b-5f87-08d89c0c4da5 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: UgTEC7ApeNUlHaFBAwqMfGR+avdiS/zROMyKI7rsCKbxrC9VXlpeu7fxySebPeBBb3T4DFaLiaWwcCO4D4MM/g== X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR04MB6144 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20201209_013319_011149_5117AA7D X-CRM114-Status: GOOD ( 20.06 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: martin.kepplinger@puri.sm, jernej.skrabec@siol.net, kernel@pengutronix.de, narmstrong@baylibre.com, airlied@linux.ie, festevam@gmail.com, s.hauer@pengutronix.de, jonas@kwiboo.se, kishon@ti.com, a.hajda@samsung.com, vkoul@kernel.org, robh+dt@kernel.org, Laurent.pinchart@ideasonboard.com, daniel@ffwll.ch, robert.chiras@nxp.com, shawnguo@kernel.org, agx@sigxcpu.org, linux-imx@nxp.com Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=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 Signed-off-by: Liu Ying Reviewed-by: Rob Herring --- v1->v2: * Newly introduced in v2. (Guido) .../devicetree/bindings/phy/mixel,mipi-dsi-phy.txt | 29 --------- .../bindings/phy/mixel,mipi-dsi-phy.yaml | 73 ++++++++++++++++++++++ 2 files changed, 73 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 9b23407..00000000 --- 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 00000000..f869fd2 --- /dev/null +++ b/Documentation/devicetree/bindings/phy/mixel,mipi-dsi-phy.yaml @@ -0,0 +1,73 @@ +# 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: + items: + - 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>; + };