Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: mmc: sdhci-atmel: Convert to json schema

Convert sdhci-atmel documentation to yaml format. The new file will inherit
from sdhci-common.yaml.

Note: Add microchip,sama7g5-sdhci to compatible list as we already use it
in the DT.

Signed-off-by: Dharma Balasubiramani <dharma.b@microchip.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20240902-atmel-sdhci-v4-1-96912fab6b2d@microchip.com
Signed-off-by: Ulf Hansson <ulf.hansson@linaro.org>

authored by

Dharma Balasubiramani and committed by
Ulf Hansson
1c97ea11 6f25e5de

+92 -35
+92
Documentation/devicetree/bindings/mmc/atmel,sama5d2-sdhci.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/mmc/atmel,sama5d2-sdhci.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Atmel SDHCI controller 8 + 9 + maintainers: 10 + - Aubin Constans <aubin.constans@microchip.com> 11 + - Nicolas Ferre <nicolas.ferre@microchip.com> 12 + 13 + description: 14 + Bindings for the SDHCI controller found in Atmel/Microchip SoCs. 15 + 16 + properties: 17 + compatible: 18 + oneOf: 19 + - enum: 20 + - atmel,sama5d2-sdhci 21 + - microchip,sam9x60-sdhci 22 + - items: 23 + - enum: 24 + - microchip,sam9x7-sdhci 25 + - microchip,sama7g5-sdhci 26 + - const: microchip,sam9x60-sdhci 27 + 28 + reg: 29 + maxItems: 1 30 + 31 + interrupts: 32 + maxItems: 1 33 + 34 + clocks: 35 + items: 36 + - description: hclock 37 + - description: multclk 38 + - description: baseclk 39 + minItems: 2 40 + 41 + clock-names: 42 + items: 43 + - const: hclock 44 + - const: multclk 45 + - const: baseclk 46 + minItems: 2 47 + 48 + microchip,sdcal-inverted: 49 + type: boolean 50 + description: 51 + When present, polarity on the SDCAL SoC pin is inverted. The default 52 + polarity for this signal is described in the datasheet. For instance on 53 + SAMA5D2, the pin is usually tied to the GND with a resistor and a 54 + capacitor (see "SDMMC I/O Calibration" chapter). 55 + 56 + required: 57 + - compatible 58 + - reg 59 + - interrupts 60 + - clocks 61 + - clock-names 62 + 63 + allOf: 64 + - $ref: sdhci-common.yaml# 65 + - if: 66 + properties: 67 + compatible: 68 + contains: 69 + enum: 70 + - atmel,sama5d2-sdhci 71 + then: 72 + properties: 73 + clocks: 74 + minItems: 3 75 + clock-names: 76 + minItems: 3 77 + 78 + unevaluatedProperties: false 79 + 80 + examples: 81 + - | 82 + #include <dt-bindings/interrupt-controller/irq.h> 83 + #include <dt-bindings/clock/at91.h> 84 + mmc@a0000000 { 85 + compatible = "atmel,sama5d2-sdhci"; 86 + reg = <0xa0000000 0x300>; 87 + interrupts = <31 IRQ_TYPE_LEVEL_HIGH 0>; 88 + clocks = <&sdmmc0_hclk>, <&sdmmc0_gclk>, <&main>; 89 + clock-names = "hclock", "multclk", "baseclk"; 90 + assigned-clocks = <&sdmmc0_gclk>; 91 + assigned-clock-rates = <480000000>; 92 + };
-35
Documentation/devicetree/bindings/mmc/sdhci-atmel.txt
··· 1 - * Atmel SDHCI controller 2 - 3 - This file documents the differences between the core properties in 4 - Documentation/devicetree/bindings/mmc/mmc.txt and the properties used by the 5 - sdhci-of-at91 driver. 6 - 7 - Required properties: 8 - - compatible: Must be "atmel,sama5d2-sdhci" or "microchip,sam9x60-sdhci" 9 - or "microchip,sam9x7-sdhci", "microchip,sam9x60-sdhci". 10 - - clocks: Phandlers to the clocks. 11 - - clock-names: Must be "hclock", "multclk", "baseclk" for 12 - "atmel,sama5d2-sdhci". 13 - Must be "hclock", "multclk" for "microchip,sam9x60-sdhci". 14 - Must be "hclock", "multclk" for "microchip,sam9x7-sdhci". 15 - 16 - Optional properties: 17 - - assigned-clocks: The same with "multclk". 18 - - assigned-clock-rates The rate of "multclk" in order to not rely on the 19 - gck configuration set by previous components. 20 - - microchip,sdcal-inverted: when present, polarity on the SDCAL SoC pin is 21 - inverted. The default polarity for this signal is described in the datasheet. 22 - For instance on SAMA5D2, the pin is usually tied to the GND with a resistor 23 - and a capacitor (see "SDMMC I/O Calibration" chapter). 24 - 25 - Example: 26 - 27 - mmc0: sdio-host@a0000000 { 28 - compatible = "atmel,sama5d2-sdhci"; 29 - reg = <0xa0000000 0x300>; 30 - interrupts = <31 IRQ_TYPE_LEVEL_HIGH 0>; 31 - clocks = <&sdmmc0_hclk>, <&sdmmc0_gclk>, <&main>; 32 - clock-names = "hclock", "multclk", "baseclk"; 33 - assigned-clocks = <&sdmmc0_gclk>; 34 - assigned-clock-rates = <480000000>; 35 - };