c45b91099325a325f40e72bc21fa158274bd98b4
[platform/kernel/linux-starfive.git] / Documentation / devicetree / bindings / mmc / mmc-spi-slot.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/mmc-spi-slot.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: MMC/SD/SDIO slot directly connected to a SPI bus
8
9 maintainers:
10   - Ulf Hansson <ulf.hansson@linaro.org>
11
12 allOf:
13   - $ref: "mmc-controller.yaml"
14   - $ref: /schemas/spi/spi-peripheral-props.yaml
15
16 description: |
17   The extra properties used by an mmc connected via SPI.
18
19 properties:
20   compatible:
21     const: mmc-spi-slot
22
23   reg:
24     maxItems: 1
25
26   spi-max-frequency: true
27
28   interrupts:
29     maxItems: 1
30
31   voltage-ranges:
32     $ref: /schemas/types.yaml#/definitions/uint32-array
33     description: |
34       Two cells are required, first cell specifies minimum slot voltage (mV),
35       second cell specifies maximum slot voltage (mV).
36     items:
37       - description: |
38           value for minimum slot voltage in mV
39         default: 3200
40       - description: |
41           value for maximum slot voltage in mV
42         default: 3400
43
44   gpios:
45     description: |
46       For historical reasons, this does not follow the generic mmc-controller
47       binding.
48     minItems: 1
49     items:
50       - description: Card-Detect GPIO
51       - description: Write-Protect GPIO
52
53 required:
54   - compatible
55   - reg
56   - spi-max-frequency
57
58 unevaluatedProperties: false
59
60 examples:
61   - |
62     #include <dt-bindings/gpio/gpio.h>
63     spi {
64       #address-cells = <1>;
65       #size-cells = <0>;
66       mmc@0 {
67         compatible = "mmc-spi-slot";
68         reg = <0>;
69         gpios = <&gpio 14 GPIO_ACTIVE_LOW>, <&gpio 15 GPIO_ACTIVE_HIGH>;
70         voltage-ranges = <3300 3300>;
71         spi-max-frequency = <50000000>;
72         interrupts = <42>;
73         interrupt-parent = <&PIC>;
74       };
75     };
76
77 ...