From patchwork Wed Feb 14 05:43:43 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Balakrishnan Sambath X-Patchwork-Id: 13555974 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 ECAF6C4829A for ; Wed, 14 Feb 2024 05:44:58 +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:CC:To:Message-ID:MIME-Version:Subject: Date:From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References: List-Owner; bh=qQLLMaFve/PpMCEp0+fGL+kXPBzBvixTZ5Ywssmk8LI=; b=1IveTQqmc7GlRE jRMGOZlQQkmK+p1GgbbeEViH3y1dkkz85+A1Syh0GR+n9gV+Tbhv9vEaI5OW/s2t8VvFCAw3fr+ng bMUR8OIXFTyKk6/TCNgw93BDiR82WDCgwZByeMOq9FN+zD9ptatzWGxdYS0L4BTkn65eo+cvTuYak ibtVe/kJ1GYkImTev8iP6Nu8PwMRnMisYamMqhFV2rOs/6eUYTKD/wK+e4oyVqNTY8fULXshEZZ15 iAqCbPn859DFFL70xuMtSBJZE4UERbOLz4MQyxz7eqgAJq7BuXa8jnVUR1oaXhKBHLl+797m1dQJM fGW7ihk8zRVLcuXETbdw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1ra84X-0000000Bu6V-1ChR; Wed, 14 Feb 2024 05:44:41 +0000 Received: from esa.microchip.iphmx.com ([68.232.153.233]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1ra84T-0000000Bu5O-49TQ for linux-arm-kernel@lists.infradead.org; Wed, 14 Feb 2024 05:44:39 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=microchip.com; i=@microchip.com; q=dns/txt; s=mchp; t=1707889477; x=1739425477; h=from:date:subject:mime-version:content-transfer-encoding: message-id:to:cc; bh=GNw4J/KFvcmUundha/TAxbmJFey7T/uVB6L9JYLTTIU=; b=N+XV6XBLKQ1vuCSsMM3oOR8qzSV9QlVsIMDishfQtKPVI7eeymtkd2Rc 6n5BVelDubZoLoQJ3bSR/EyDRxe0+V8w9t/jxtj7YvqaGzSuQDrZ5MuP8 9ZqNVKArE1AHe11PEJ9oRxJm11Teo/1SF3JM0l91CRkecBNbElxbaheYI nvGBFPdAnCCjtSE6exhyPjPSHNjPWCnaainMihtChS4tZW4qxHXv/LWAJ 0yhRG9pJjLGKO+8DuEEgxeDVXb+/TMp060OotIkPc4Qa9ojRt47halWNn E7HciPg+mbQoLMDHNvd1l3Hitgd4b6EGsDH7uV2L72Q+eddH+3gnKER0m w==; X-CSE-ConnectionGUID: YUbQA9s/RgiTYXtTM1m92A== X-CSE-MsgGUID: waKejkziQUyMUj0I4zCgQw== X-IronPort-AV: E=Sophos;i="6.06,159,1705388400"; d="scan'208";a="17662184" X-Amp-Result: SKIPPED(no attachment in message) Received: from unknown (HELO email.microchip.com) ([170.129.1.10]) by esa1.microchip.iphmx.com with ESMTP/TLS/ECDHE-RSA-AES128-GCM-SHA256; 13 Feb 2024 22:44:34 -0700 Received: from chn-vm-ex03.mchp-main.com (10.10.85.151) by chn-vm-ex03.mchp-main.com (10.10.85.151) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35; Tue, 13 Feb 2024 22:44:03 -0700 Received: from [127.0.0.1] (10.10.85.11) by chn-vm-ex03.mchp-main.com (10.10.85.151) with Microsoft SMTP Server id 15.1.2507.35 via Frontend Transport; Tue, 13 Feb 2024 22:43:59 -0700 From: Balakrishnan Sambath Date: Wed, 14 Feb 2024 11:13:43 +0530 Subject: [PATCH] dt-bindings: mfd: Convert atmel-flexcom to json-schema MIME-Version: 1.0 Message-ID: <20240214-sama5d2-flexcom-yaml-v1-1-5dedd0eba08e@microchip.com> X-B4-Tracking: v=1; b=H4sIAA5TzGUC/x3MQQqAIBBA0avErBswzaiuEi1ExxrICoUworsnL d/i/wcSRaYEY/VApIsTH3tBU1dgV7MvhOyKQQrZCtkoTCYY7ST6jbI9At4mbKiEtb4bhk7pHkp 6RvKc/+00v+8HFcdF6mYAAAA= To: Lee Jones , Rob Herring , "Krzysztof Kozlowski" , Conor Dooley , Nicolas Ferre , "Alexandre Belloni" , Claudiu Beznea , Kavyasree Kotagiri CC: , , , Hari Prasath Gujulan Elango , Rob Herring , "Krzysztof Kozlowski" , Balakrishnan Sambath X-Mailer: b4 0.12.4 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240213_214438_196903_A76B714C X-CRM114-Status: GOOD ( 20.91 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org From: Kavyasree Kotagiri Convert the Atmel flexcom device tree bindings to json schema. Signed-off-by: Kavyasree Kotagiri Reviewed-by: Rob Herring Acked-by: Krzysztof Kozlowski Signed-off-by: Balakrishnan Sambath --- The yaml DT bindings for the atmel-flexcom driver were submitted upstream in a separate patch series in 2022 [1] which was Acked-by Krzysztof Kozlowski. However, it has been observed recently that the patch has not been merged into the mainline codebase.When attempting to apply the patch to the latest upstream kernel,a conflict arose due to a recent addition to the original device tree binding in text format. The conflict has now been resolved and we are sending a updated version of the patch. [1]https://lore.kernel.org/linux-arm-kernel/22063373-6060-d605-62af-35d82ba1729c@linaro.org/ --- .../bindings/mfd/atmel,sama5d2-flexcom.yaml | 92 ++++++++++++++++++++++ .../devicetree/bindings/mfd/atmel-flexcom.txt | 64 --------------- 2 files changed, 92 insertions(+), 64 deletions(-) --- base-commit: 0dd3ee31125508cd67f7e7172247f05b7fd1753a change-id: 20240213-sama5d2-flexcom-yaml-30ccf6996358 Best regards, diff --git a/Documentation/devicetree/bindings/mfd/atmel,sama5d2-flexcom.yaml b/Documentation/devicetree/bindings/mfd/atmel,sama5d2-flexcom.yaml new file mode 100644 index 000000000000..f28522cd987a --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/atmel,sama5d2-flexcom.yaml @@ -0,0 +1,92 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mfd/atmel,sama5d2-flexcom.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Atmel Flexcom (Flexible Serial Communication Unit) + +maintainers: + - Kavyasree Kotagiri + +description: + The Atmel Flexcom is just a wrapper which embeds a SPI controller, + an I2C controller and an USART. Only one function can be used at a + time and is chosen at boot time according to the device tree. + +properties: + compatible: + enum: + - atmel,sama5d2-flexcom + + reg: + maxItems: 1 + + clocks: + maxItems: 1 + + "#address-cells": + const: 1 + + "#size-cells": + const: 1 + + ranges: + description: + One range for the full I/O register region. (including USART, + TWI and SPI registers). + items: + maxItems: 3 + + atmel,flexcom-mode: + description: | + Specifies the flexcom mode as follows: + 1: USART + 2: SPI + 3: I2C. + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [1, 2, 3] + +patternProperties: + "^serial@[0-9a-f]+$": + type: object + description: + Child node describing USART. See atmel-usart.txt for details + of USART bindings. + + "^spi@[0-9a-f]+$": + type: object + description: + Child node describing SPI. See ../spi/spi_atmel.txt for details + of SPI bindings. + + "^i2c@[0-9a-f]+$": + $ref: /schemas/i2c/atmel,at91sam-i2c.yaml + description: + Child node describing I2C. + +required: + - compatible + - reg + - clocks + - "#address-cells" + - "#size-cells" + - ranges + - atmel,flexcom-mode + +additionalProperties: false + +examples: + - | + #include + + flx0: flexcom@f8034000 { + compatible = "atmel,sama5d2-flexcom"; + reg = <0xf8034000 0x200>; + clocks = <&flx0_clk>; + #address-cells = <1>; + #size-cells = <1>; + ranges = <0x0 0xf8034000 0x800>; + atmel,flexcom-mode = <2>; + }; +... diff --git a/Documentation/devicetree/bindings/mfd/atmel-flexcom.txt b/Documentation/devicetree/bindings/mfd/atmel-flexcom.txt deleted file mode 100644 index af692e8833a5..000000000000 --- a/Documentation/devicetree/bindings/mfd/atmel-flexcom.txt +++ /dev/null @@ -1,64 +0,0 @@ -* Device tree bindings for Atmel Flexcom (Flexible Serial Communication Unit) - -The Atmel Flexcom is just a wrapper which embeds a SPI controller, an I2C -controller and an USART. Only one function can be used at a time and is chosen -at boot time according to the device tree. - -Required properties: -- compatible: Should be "atmel,sama5d2-flexcom" - or "microchip,sam9x7-flexcom", "atmel,sama5d2-flexcom" -- reg: Should be the offset/length value for Flexcom dedicated - I/O registers (without USART, TWI or SPI registers). -- clocks: Should be the Flexcom peripheral clock from PMC. -- #address-cells: Should be <1> -- #size-cells: Should be <1> -- ranges: Should be one range for the full I/O register region - (including USART, TWI and SPI registers). -- atmel,flexcom-mode: Should be one of the following values: - - <1> for USART - - <2> for SPI - - <3> for I2C - -Required child: -A single available child device of type matching the "atmel,flexcom-mode" -property. - -The phandle provided by the clocks property of the child is the same as one for -the Flexcom parent. - -For other properties, please refer to the documentations of the respective -device: -- ../serial/atmel-usart.txt -- ../spi/spi_atmel.txt -- ../i2c/i2c-at91.txt - -Example: - -flexcom@f8034000 { - compatible = "atmel,sama5d2-flexcom"; - reg = <0xf8034000 0x200>; - clocks = <&flx0_clk>; - #address-cells = <1>; - #size-cells = <1>; - ranges = <0x0 0xf8034000 0x800>; - atmel,flexcom-mode = <2>; - - spi@400 { - compatible = "atmel,at91rm9200-spi"; - reg = <0x400 0x200>; - interrupts = <19 IRQ_TYPE_LEVEL_HIGH 7>; - pinctrl-names = "default"; - pinctrl-0 = <&pinctrl_flx0_default>; - #address-cells = <1>; - #size-cells = <0>; - clocks = <&flx0_clk>; - clock-names = "spi_clk"; - atmel,fifo-size = <32>; - - flash@0 { - compatible = "atmel,at25f512b"; - reg = <0>; - spi-max-frequency = <20000000>; - }; - }; -};