Documentation/devicetree/bindings/misc/olpc,xo1.75-ec.yaml

   1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
   2 # Copyright (C) 2019,2020 Lubomir Rintel <lkundrak@v3.sk>
   3 %YAML 1.2
   4 ---
   5 $id: http://devicetree.org/schemas/misc/olpc,xo1.75-ec.yaml#
   6 $schema: http://devicetree.org/meta-schemas/core.yaml#
   7
   8 title: OLPC XO-1.75 Embedded Controller bindings
   9
  10 description: |
  11   This binding describes the Embedded Controller acting as a SPI bus master
  12   on a OLPC XO-1.75 laptop computer.
  13
  14   The embedded controller requires the SPI controller driver to signal
  15   readiness to receive a transfer (that is, when TX FIFO contains the
  16   response data) by strobing the ACK pin with the ready signal. See the
  17   "ready-gpios" property of the SSP binding as documented in:
  18   <Documentation/devicetree/bindings/spi/marvell,mmp2-ssp.yaml>.
  19
  20 maintainers:
  21   - Lubomir Rintel <lkundrak@v3.sk>
  22
  23 properties:
  24   compatible:
  25     const: olpc,xo1.75-ec
  26
  27   cmd-gpios:
  28     description: GPIO uspecifier of the CMD pin
  29     maxItems: 1
  30
  31 required:
  32   - compatible
  33   - cmd-gpios
  34
  35 unevaluatedProperties: false
  36
  37 examples:
  38   - |
  39     #include <dt-bindings/gpio/gpio.h>
  40
  41     spi {
  42       spi-slave;
  43       ready-gpios = <&gpio 125 GPIO_ACTIVE_HIGH>;
  44
  45       slave {
  46         compatible = "olpc,xo1.75-ec";
  47         spi-cpha;
  48         cmd-gpios = <&gpio 155 GPIO_ACTIVE_HIGH>;
  49       };
  50     };
  51
  52 ...