xref: /freebsd/sys/contrib/device-tree/Bindings/mmc/synopsys-dw-mshc.yaml (revision e9ac41698b2f322d55ccf9da50a3596edb2c1800) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/mmc/synopsys-dw-mshc.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Synopsys Designware Mobile Storage Host Controller
8
9maintainers:
10  - Ulf Hansson <ulf.hansson@linaro.org>
11
12# Everything else is described in the common file
13properties:
14  compatible:
15    enum:
16      - altr,socfpga-dw-mshc
17      - img,pistachio-dw-mshc
18      - snps,dw-mshc
19
20  reg:
21    maxItems: 1
22
23  interrupts:
24    maxItems: 1
25
26  clocks:
27    minItems: 2
28    maxItems: 2
29    description:
30      Handle to "biu" and "ciu" clocks for the
31      bus interface unit clock and the card interface unit clock.
32
33  clock-names:
34    items:
35      - const: biu
36      - const: ciu
37
38  iommus:
39    maxItems: 1
40
41  altr,sysmgr-syscon:
42    $ref: /schemas/types.yaml#/definitions/phandle-array
43    items:
44      - items:
45          - description: phandle to the sysmgr node
46          - description: register offset that controls the SDMMC clock phase
47          - description: register shift for the smplsel(drive in) setting
48    description:
49      This property is optional. Contains the phandle to System Manager block
50      that contains the SDMMC clock-phase control register. The first value is
51      the pointer to the sysmgr, the 2nd value is the register offset for the
52      SDMMC clock phase register, and the 3rd value is the bit shift for the
53      smplsel(drive in) setting.
54
55allOf:
56  - $ref: synopsys-dw-mshc-common.yaml#
57
58  - if:
59      properties:
60        compatible:
61          contains:
62            const: altr,socfpga-dw-mshc
63    then:
64      properties:
65        altr,sysmgr-syscon: true
66    else:
67      properties:
68        iommus: false
69        altr,sysmgr-syscon: false
70
71required:
72  - compatible
73  - reg
74  - interrupts
75  - clocks
76  - clock-names
77
78unevaluatedProperties: false
79
80examples:
81  - |
82    mmc@12200000 {
83      compatible = "snps,dw-mshc";
84      reg = <0x12200000 0x1000>;
85      interrupts = <0 75 0>;
86      clocks = <&clock 351>, <&clock 132>;
87      clock-names = "biu", "ciu";
88      dmas = <&pdma 12>;
89      dma-names = "rx-tx";
90      resets = <&rst 20>;
91      reset-names = "reset";
92      vmmc-supply = <&buck8>;
93      #address-cells = <1>;
94      #size-cells = <0>;
95      broken-cd;
96      bus-width = <8>;
97      cap-mmc-highspeed;
98      cap-sd-highspeed;
99      card-detect-delay = <200>;
100      max-frequency = <200000000>;
101      clock-frequency = <400000000>;
102      data-addr = <0x200>;
103      fifo-depth = <0x80>;
104      fifo-watermark-aligned;
105    };
106