Documentation/devicetree/bindings/net/nfc/samsung,s3fwrn5.yaml

   1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/net/nfc/samsung,s3fwrn5.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Samsung S3FWRN5 NCI NFC Controller
   8
   9 maintainers:
  10   - Krzysztof Kozlowski <krzk@kernel.org>
  11   - Krzysztof Opasiak <k.opasiak@samsung.com>
  12
  13 properties:
  14   compatible:
  15     const: samsung,s3fwrn5-i2c
  16
  17   en-gpios:
  18     maxItems: 1
  19     description:
  20       Output GPIO pin used for enabling/disabling the chip
  21
  22   interrupts:
  23     maxItems: 1
  24
  25   reg:
  26     maxItems: 1
  27
  28   wake-gpios:
  29     maxItems: 1
  30     description:
  31       Output GPIO pin used to enter firmware mode and sleep/wakeup control
  32
  33   s3fwrn5,en-gpios:
  34     maxItems: 1
  35     deprecated: true
  36     description:
  37       Use en-gpios
  38
  39   s3fwrn5,fw-gpios:
  40     maxItems: 1
  41     deprecated: true
  42     description:
  43       Use wake-gpios
  44
  45 additionalProperties: false
  46
  47 required:
  48   - compatible
  49   - en-gpios
  50   - interrupts
  51   - reg
  52   - wake-gpios
  53
  54 examples:
  55   - |
  56     #include <dt-bindings/gpio/gpio.h>
  57     #include <dt-bindings/interrupt-controller/irq.h>
  58
  59     i2c4 {
  60         #address-cells = <1>;
  61         #size-cells = <0>;
  62
  63         s3fwrn5@27 {
  64             compatible = "samsung,s3fwrn5-i2c";
  65             reg = <0x27>;
  66
  67             interrupt-parent = <&gpa1>;
  68             interrupts = <3 IRQ_TYPE_LEVEL_HIGH>;
  69
  70             en-gpios = <&gpf1 4 GPIO_ACTIVE_HIGH>;
  71             wake-gpios = <&gpj0 2 GPIO_ACTIVE_HIGH>;
  72         };
  73     };