xref: /freebsd/sys/contrib/device-tree/Bindings/spi/spi-gpio.yaml (revision cfd6422a5217410fbd66f7a7a8a64d9d85e61229)
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
56examples:
57  - |
58    spi {
59      compatible = "spi-gpio";
60      #address-cells = <0x1>;
61      #size-cells = <0x0>;
62
63      sck-gpios = <&gpio 95 0>;
64      miso-gpios = <&gpio 98 0>;
65      mosi-gpios = <&gpio 97 0>;
66      cs-gpios = <&gpio 125 0>;
67      num-chipselects = <1>;
68
69      /* clients */
70    };
71
72...
73