xref: /freebsd/sys/contrib/device-tree/Bindings/spi/spi-gpio.yaml (revision 8ddb146abcdf061be9f2c0db7e391697dafad85c) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/spi/spi-gpio.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: SPI-GPIO devicetree bindings
8
9maintainers:
10  - Rob Herring <robh@kernel.org>
11
12description:
13  This represents a group of 3-n GPIO lines used for bit-banged SPI on
14  dedicated GPIO lines.
15
16allOf:
17  - $ref: "/schemas/spi/spi-controller.yaml#"
18
19properties:
20  compatible:
21    const: spi-gpio
22
23  sck-gpios:
24    description: GPIO spec for the SCK line to use
25    maxItems: 1
26
27  miso-gpios:
28    description: GPIO spec for the MISO line to use
29    maxItems: 1
30
31  mosi-gpios:
32    description: GPIO spec for the MOSI line to use
33    maxItems: 1
34
35  cs-gpios:
36    description: GPIOs to use for chipselect lines.
37      Not needed if num-chipselects = <0>.
38    minItems: 1
39    maxItems: 1024
40
41  num-chipselects:
42    description: Number of chipselect lines. Should be <0> if a single device
43      with no chip select is connected.
44    $ref: "/schemas/types.yaml#/definitions/uint32"
45
46  # Deprecated properties
47  gpio-sck: false
48  gpio-miso: false
49  gpio-mosi: false
50
51required:
52  - compatible
53  - num-chipselects
54  - sck-gpios
55
56unevaluatedProperties: false
57
58examples:
59  - |
60    spi {
61      compatible = "spi-gpio";
62      #address-cells = <0x1>;
63      #size-cells = <0x0>;
64
65      sck-gpios = <&gpio 95 0>;
66      miso-gpios = <&gpio 98 0>;
67      mosi-gpios = <&gpio 97 0>;
68      cs-gpios = <&gpio 125 0>;
69      num-chipselects = <1>;
70
71      /* clients */
72    };
73
74...
75