Message ID | 20230604121223.9625-9-stefan.wahren@i2se.com |
---|---|
State | New |
Headers | show |
Series | ARM: dts: bcm283x: Improve device-trees and bindings | expand |
On Sun, 04 Jun 2023 14:12:21 +0200, Stefan Wahren wrote: > Convert the DT binding document for bcm2835-sdhost from .txt to YAML. > > Signed-off-by: Stefan Wahren <stefan.wahren@i2se.com> > --- > .../bindings/mmc/brcm,bcm2835-sdhost.txt | 23 -------- > .../bindings/mmc/brcm,bcm2835-sdhost.yaml | 54 +++++++++++++++++++ > 2 files changed, 54 insertions(+), 23 deletions(-) > delete mode 100644 Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.txt > create mode 100644 Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.yaml > Reviewed-by: Rob Herring <robh@kernel.org>
On Sun, 4 Jun 2023 at 14:13, Stefan Wahren <stefan.wahren@i2se.com> wrote: > > Convert the DT binding document for bcm2835-sdhost from .txt to YAML. > > Signed-off-by: Stefan Wahren <stefan.wahren@i2se.com> Applied for next, thanks! Kind regards Uffe > --- > .../bindings/mmc/brcm,bcm2835-sdhost.txt | 23 -------- > .../bindings/mmc/brcm,bcm2835-sdhost.yaml | 54 +++++++++++++++++++ > 2 files changed, 54 insertions(+), 23 deletions(-) > delete mode 100644 Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.txt > create mode 100644 Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.yaml > > diff --git a/Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.txt b/Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.txt > deleted file mode 100644 > index d876580ae3b8..000000000000 > --- a/Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.txt > +++ /dev/null > @@ -1,23 +0,0 @@ > -Broadcom BCM2835 SDHOST controller > - > -This file documents differences between the core properties described > -by mmc.txt and the properties that represent the BCM2835 controller. > - > -Required properties: > -- compatible: Should be "brcm,bcm2835-sdhost". > -- clocks: The clock feeding the SDHOST controller. > - > -Optional properties: > -- dmas: DMA channel for read and write. > - See Documentation/devicetree/bindings/dma/dma.txt for details > - > -Example: > - > -sdhost: mmc@7e202000 { > - compatible = "brcm,bcm2835-sdhost"; > - reg = <0x7e202000 0x100>; > - interrupts = <2 24>; > - clocks = <&clocks BCM2835_CLOCK_VPU>; > - dmas = <&dma 13>; > - dma-names = "rx-tx"; > -}; > diff --git a/Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.yaml b/Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.yaml > new file mode 100644 > index 000000000000..3a5a44800675 > --- /dev/null > +++ b/Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.yaml > @@ -0,0 +1,54 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/mmc/brcm,bcm2835-sdhost.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Broadcom BCM2835 SDHOST controller > + > +maintainers: > + - Stefan Wahren <stefan.wahren@i2se.com> > + > +allOf: > + - $ref: mmc-controller.yaml > + > +properties: > + compatible: > + const: brcm,bcm2835-sdhost > + > + reg: > + maxItems: 1 > + > + interrupts: > + maxItems: 1 > + > + clocks: > + maxItems: 1 > + > + dmas: > + maxItems: 1 > + > + dma-names: > + const: rx-tx > + > +required: > + - compatible > + - reg > + - interrupts > + - clocks > + > +unevaluatedProperties: false > + > +examples: > + - | > + #include <dt-bindings/clock/bcm2835.h> > + > + sdhost: mmc@7e202000 { > + compatible = "brcm,bcm2835-sdhost"; > + reg = <0x7e202000 0x100>; > + interrupts = <2 24>; > + clocks = <&clocks BCM2835_CLOCK_VPU>; > + dmas = <&dma 13>; > + dma-names = "rx-tx"; > + bus-width = <4>; > + }; > -- > 2.34.1 >
diff --git a/Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.txt b/Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.txt deleted file mode 100644 index d876580ae3b8..000000000000 --- a/Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.txt +++ /dev/null @@ -1,23 +0,0 @@ -Broadcom BCM2835 SDHOST controller - -This file documents differences between the core properties described -by mmc.txt and the properties that represent the BCM2835 controller. - -Required properties: -- compatible: Should be "brcm,bcm2835-sdhost". -- clocks: The clock feeding the SDHOST controller. - -Optional properties: -- dmas: DMA channel for read and write. - See Documentation/devicetree/bindings/dma/dma.txt for details - -Example: - -sdhost: mmc@7e202000 { - compatible = "brcm,bcm2835-sdhost"; - reg = <0x7e202000 0x100>; - interrupts = <2 24>; - clocks = <&clocks BCM2835_CLOCK_VPU>; - dmas = <&dma 13>; - dma-names = "rx-tx"; -}; diff --git a/Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.yaml b/Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.yaml new file mode 100644 index 000000000000..3a5a44800675 --- /dev/null +++ b/Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.yaml @@ -0,0 +1,54 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mmc/brcm,bcm2835-sdhost.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Broadcom BCM2835 SDHOST controller + +maintainers: + - Stefan Wahren <stefan.wahren@i2se.com> + +allOf: + - $ref: mmc-controller.yaml + +properties: + compatible: + const: brcm,bcm2835-sdhost + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + clocks: + maxItems: 1 + + dmas: + maxItems: 1 + + dma-names: + const: rx-tx + +required: + - compatible + - reg + - interrupts + - clocks + +unevaluatedProperties: false + +examples: + - | + #include <dt-bindings/clock/bcm2835.h> + + sdhost: mmc@7e202000 { + compatible = "brcm,bcm2835-sdhost"; + reg = <0x7e202000 0x100>; + interrupts = <2 24>; + clocks = <&clocks BCM2835_CLOCK_VPU>; + dmas = <&dma 13>; + dma-names = "rx-tx"; + bus-width = <4>; + };
Convert the DT binding document for bcm2835-sdhost from .txt to YAML. Signed-off-by: Stefan Wahren <stefan.wahren@i2se.com> --- .../bindings/mmc/brcm,bcm2835-sdhost.txt | 23 -------- .../bindings/mmc/brcm,bcm2835-sdhost.yaml | 54 +++++++++++++++++++ 2 files changed, 54 insertions(+), 23 deletions(-) delete mode 100644 Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.txt create mode 100644 Documentation/devicetree/bindings/mmc/brcm,bcm2835-sdhost.yaml