bindings/spi/spi-controller.yaml

1 # SPDX-License-Identifier: GPL-2.0
3 ---
4 $id: http://devicetree.org/schemas/spi/spi-controller.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: SPI Controller Common Properties
10   - Mark Brown <broonie@kernel.org>
13   SPI busses can be described with a node for the SPI controller device
14   and a set of child nodes for each SPI slave on the bus. The system SPI
15   controller may be described for use in SPI master mode or in SPI slave mode,
20     pattern: "^spi(@.*|-([0-9]|[1-9][0-9]+))?$"
22   "#address-cells":
25   "#size-cells":
28   cs-gpios:
32       increased automatically with max(cs-gpios, hardware chip selects).
35       cs-gpios looks like this
36         cs-gpios = <&gpio1 0 0>, <0>, <&gpio1 1 0>, <&gpio1 2 0>;
49       cs-gpio with the optional spi-cs-high flag for SPI slaves.
54       device node     | cs-gpio       | CS pin state active | Note
56       spi-cs-high     | -             | H                   |
57       -               | -             | L                   |
58       spi-cs-high     | ACTIVE_HIGH   | H                   |
59       -               | ACTIVE_HIGH   | L                   | 1
60       spi-cs-high     | ACTIVE_LOW    | H                   | 2
61       -               | ACTIVE_LOW    | L                   |
68          because ACTIVE_LOW is overridden by spi-cs-high.
70          spi-cs-high + ACTIVE_HIGH.
72   num-cs:
77   spi-slave:
80       The SPI controller acts as a slave, instead of a master.
88           Compatible of the SPI device.
91       - compatible
94   "^.*@[0-9a-f]+$":
96     $ref: spi-peripheral-props.yaml
100       spi-3wire:
103           The device requires 3-wire mode.
105       spi-cpha:
110       spi-cpol:
116       - compatible
117       - reg
120   - if:
123           - spi-slave
126         "#address-cells":
130         "#address-cells":
136   - |
137     spi@80010000 {
138         #address-cells = <1>;
139         #size-cells = <0>;
140         compatible = "fsl,imx28-spi";
144         dma-names = "rx-tx";
148             spi-max-frequency = <1000000>;
154             spi-max-frequency = <100000>;
159             compatible = "jedec,spi-nor";
160             spi-max-frequency = <50000000>;
161             reg = <2>, <3>;
162             stacked-memories = /bits/ 64 <0x10000000 0x10000000>;