Commit e760eab4 authored by Charan Pedumuru's avatar Charan Pedumuru Committed by Ulf Hansson
Browse files

dt-binding: mmc: microchip,sdhci-pic32: convert text based binding to json schema 



Update text binding to YAML.
Changes during conversion:
Add appropriate include statements for interrupts and clock-names
to resolve errors identified by `dt_binding_check` and `dtbs_check`.

Signed-off-by: default avatarCharan Pedumuru <charan.pedumuru@gmail.com>
Acked-by: default avatarConor Dooley <conor.dooley@microchip.com>
Link: https://lore.kernel.org/r/20250507-mchp-sdhci-v1-2-ed29de05295a@gmail.com


Signed-off-by: default avatarUlf Hansson <ulf.hansson@linaro.org>
parent eb68ba4a

Documentation/devicetree/bindings/mmc/microchip,sdhci-pic32.txt

deleted100644 → 0
+0 −29
Original line number Diff line number Diff line 
* Microchip PIC32 SDHCI Controller



This file documents differences between the core properties in mmc.txt

and the properties used by the sdhci-pic32 driver.



Required properties:

- compatible: Should be "microchip,pic32mzda-sdhci"

- interrupts: Should contain interrupt

- clock-names: Should be "base_clk", "sys_clk".

               See: Documentation/devicetree/bindings/resource-names.txt

- clocks: Phandle to the clock.

          See: Documentation/devicetree/bindings/clock/clock-bindings.txt

- pinctrl-names: A pinctrl state names "default" must be defined.

- pinctrl-0: Phandle referencing pin configuration of the SDHCI controller.

             See: Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt



Example:



	sdhci@1f8ec000 {

		compatible = "microchip,pic32mzda-sdhci";

		reg = <0x1f8ec000 0x100>;

		interrupts = <191 IRQ_TYPE_LEVEL_HIGH>;

		clocks = <&rootclk REF4CLK>, <&rootclk PB5CLK>;

		clock-names = "base_clk", "sys_clk";

		bus-width = <4>;

		cap-sd-highspeed;

		pinctrl-names = "default";

		pinctrl-0 = <&pinctrl_sdhc1>;

	};

Documentation/devicetree/bindings/mmc/microchip,sdhci-pic32.yaml

0 → 100644
+66 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/mmc/microchip,sdhci-pic32.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Microchip PIC32 SDHI Controller



description:

  The Microchip PIC32 family of microcontrollers (MCUs) includes models with

  Secure Digital Host Controller Interface (SDHCI) controllers, allowing them

  to interface with Secure Digital (SD) cards. This interface is used for reading,

  writing, and managing data on SD cards, enabling storage and data transfer

  capabilities in embedded systems.



allOf:

  - $ref: mmc-controller.yaml



maintainers:

  - Ulf Hansson <ulf.hansson@linaro.org>



properties:

  compatible:

    const: microchip,pic32mzda-sdhci



  reg:

    maxItems: 1



  interrupts:

    maxItems: 1



  clocks:

    maxItems: 2



  clock-names:

    items:

      - const: base_clk

      - const: sys_clk



required:

  - compatible

  - reg

  - interrupts

  - clocks

  - clock-names

  - pinctrl-names

  - pinctrl-0



unevaluatedProperties: false



examples:

  - |

    #include <dt-bindings/interrupt-controller/irq.h>

    #include <dt-bindings/clock/microchip,pic32-clock.h>

    mmc@1f8ec000 {

        compatible = "microchip,pic32mzda-sdhci";

        reg = <0x1f8ec000 0x100>;

        interrupts = <191 IRQ_TYPE_LEVEL_HIGH>;

        clocks = <&rootclk REF4CLK>, <&rootclk PB5CLK>;

        clock-names = "base_clk", "sys_clk";

        bus-width = <4>;

        cap-sd-highspeed;

        pinctrl-names = "default";

        pinctrl-0 = <&pinctrl_sdhc1>;

    };

...