1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/spi/omap-sp 4 $id: http://devicetree.org/schemas/spi/omap-spi.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: SPI Controller on OMAP and K3 SoCs !! 7 title: SPI controller bindings for OMAP and K3 SoCs
8 8
9 maintainers: 9 maintainers:
10 - Aswath Govindraju <a-govindraju@ti.com> 10 - Aswath Govindraju <a-govindraju@ti.com>
11 11
12 allOf: 12 allOf:
13 - $ref: spi-controller.yaml# 13 - $ref: spi-controller.yaml#
14 14
15 properties: 15 properties:
16 compatible: 16 compatible:
17 oneOf: 17 oneOf:
18 - items: 18 - items:
19 - enum: 19 - enum:
20 - ti,am654-mcspi 20 - ti,am654-mcspi
21 - ti,am4372-mcspi 21 - ti,am4372-mcspi
22 - const: ti,omap4-mcspi 22 - const: ti,omap4-mcspi
23 - items: 23 - items:
24 - enum: 24 - enum:
25 - ti,omap2-mcspi 25 - ti,omap2-mcspi
26 - ti,omap4-mcspi 26 - ti,omap4-mcspi
27 27
28 reg: 28 reg:
29 maxItems: 1 29 maxItems: 1
30 30
31 interrupts: 31 interrupts:
32 maxItems: 1 32 maxItems: 1
33 33
34 clocks: 34 clocks:
35 maxItems: 1 35 maxItems: 1
36 36
37 power-domains: 37 power-domains:
38 maxItems: 1 38 maxItems: 1
39 39
40 ti,spi-num-cs: 40 ti,spi-num-cs:
41 $ref: /schemas/types.yaml#/definitions/uin 41 $ref: /schemas/types.yaml#/definitions/uint32
42 description: Number of chipselect supporte 42 description: Number of chipselect supported by the instance.
43 minimum: 1 43 minimum: 1
44 maximum: 4 44 maximum: 4
45 45
46 ti,hwmods: 46 ti,hwmods:
47 $ref: /schemas/types.yaml#/definitions/str 47 $ref: /schemas/types.yaml#/definitions/string
48 description: 48 description:
49 Must be "mcspi<n>", n being the instance 49 Must be "mcspi<n>", n being the instance number (1-based).
50 This property is applicable only on lega 50 This property is applicable only on legacy platforms mainly omap2/3
51 and ti81xx and should not be used on oth 51 and ti81xx and should not be used on other platforms.
52 deprecated: true 52 deprecated: true
53 53
54 ti,pindir-d0-out-d1-in: 54 ti,pindir-d0-out-d1-in:
55 description: 55 description:
56 Select the D0 pin as output and D1 as in 56 Select the D0 pin as output and D1 as input. The default is D0
57 as input and D1 as output. 57 as input and D1 as output.
58 type: boolean 58 type: boolean
59 59
60 dmas: 60 dmas:
61 description: 61 description:
62 List of DMA specifiers with the controll 62 List of DMA specifiers with the controller specific format as
63 described in the generic DMA client bind 63 described in the generic DMA client binding. A tx and rx
64 specifier is required for each chip sele 64 specifier is required for each chip select.
65 minItems: 1 65 minItems: 1
66 maxItems: 8 66 maxItems: 8
67 67
68 dma-names: 68 dma-names:
69 description: 69 description:
70 List of DMA request names. These strings 70 List of DMA request names. These strings correspond 1:1 with
71 the DMA specifiers listed in dmas. The s !! 71 the DMA sepecifiers listed in dmas. The string names is to be
72 "rxN" and "txN" for RX and TX requests, 72 "rxN" and "txN" for RX and TX requests, respectively. Where N
73 is the chip select number. 73 is the chip select number.
74 minItems: 1 74 minItems: 1
75 maxItems: 8 75 maxItems: 8
76 76
77 required: 77 required:
78 - compatible 78 - compatible
79 - reg 79 - reg
80 - interrupts 80 - interrupts
81 81
82 unevaluatedProperties: false 82 unevaluatedProperties: false
83 83
84 if: 84 if:
85 properties: 85 properties:
86 compatible: 86 compatible:
87 enum: 87 enum:
88 - ti,omap2-mcspi 88 - ti,omap2-mcspi
89 - ti,omap4-mcspi 89 - ti,omap4-mcspi
90 90
91 then: 91 then:
92 properties: 92 properties:
93 ti,hwmods: 93 ti,hwmods:
94 items: 94 items:
95 - pattern: "^mcspi([1-9])$" 95 - pattern: "^mcspi([1-9])$"
96 96
97 else: 97 else:
98 properties: 98 properties:
99 ti,hwmods: false 99 ti,hwmods: false
100 100
101 examples: 101 examples:
102 - | 102 - |
103 #include <dt-bindings/interrupt-controller 103 #include <dt-bindings/interrupt-controller/irq.h>
104 #include <dt-bindings/interrupt-controller 104 #include <dt-bindings/interrupt-controller/arm-gic.h>
105 #include <dt-bindings/soc/ti,sci_pm_domain 105 #include <dt-bindings/soc/ti,sci_pm_domain.h>
106 106
107 spi@2100000 { 107 spi@2100000 {
108 compatible = "ti,am654-mcspi","ti,omap4- 108 compatible = "ti,am654-mcspi","ti,omap4-mcspi";
109 reg = <0x2100000 0x400>; 109 reg = <0x2100000 0x400>;
110 interrupts = <GIC_SPI 184 IRQ_TYPE_LEVEL 110 interrupts = <GIC_SPI 184 IRQ_TYPE_LEVEL_HIGH>;
111 clocks = <&k3_clks 137 1>; 111 clocks = <&k3_clks 137 1>;
112 power-domains = <&k3_pds 137 TI_SCI_PD_E 112 power-domains = <&k3_pds 137 TI_SCI_PD_EXCLUSIVE>;
113 #address-cells = <1>; 113 #address-cells = <1>;
114 #size-cells = <0>; 114 #size-cells = <0>;
115 dmas = <&main_udmap 0xc500>, <&main_udma 115 dmas = <&main_udmap 0xc500>, <&main_udmap 0x4500>;
116 dma-names = "tx0", "rx0"; 116 dma-names = "tx0", "rx0";
117 }; 117 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.