Documentation/devicetree/bindings/spi/spi-gpio.yaml

   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
   7 title: SPI-GPIO devicetree bindings
   8
   9 maintainers:
  10   - Rob Herring <robh@kernel.org>
  11
  12 description:
  13   This represents a group of 3-n GPIO lines used for bit-banged SPI on
  14   dedicated GPIO lines.
  15
  16 allOf:
  17   - $ref: "/schemas/spi/spi-controller.yaml#"
  18
  19 properties:
  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
  51 required:
  52   - compatible
  53   - num-chipselects
  54   - sck-gpios
  55
  56 unevaluatedProperties: false
  57
  58 examples:
  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 ...