Documentation/devicetree/bindings/iio/light/capella,cm3605.yaml

   1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/iio/light/capella,cm3605.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title:
   8   Capella Microsystems CM3605 Ambient Light and Short Distance Proximity Sensor
   9
  10 maintainers:
  11   - Linus Walleij <linus.walleij@linaro.org>
  12   - Kevin Tsai <ktsai@capellamicro.com>
  13
  14 description: |
  15   The CM3605 is an entirely analog part. However, it requires quite a bit of
  16   software logic to interface a host operating system.
  17
  18   This ALS and proximity sensor was one of the very first deployed in mobile
  19   handsets, notably it is used in the very first Nexus One Android phone from
  20   2010.
  21
  22 properties:
  23   compatible:
  24     const: capella,cm3605
  25
  26   aset-gpios:
  27     maxItems: 1
  28     description:
  29       ASET line (drive low to activate the ALS, should be flagged
  30       GPIO_ACTIVE_LOW)
  31
  32   interrupts:
  33     maxItems: 1
  34     description:
  35       Connected to the POUT (proximity sensor out) line. The edge
  36       detection must be set to IRQ_TYPE_EDGE_BOTH so as to detect
  37       movements toward and away from the proximity sensor.
  38
  39   io-channels:
  40     maxItems: 1
  41     description:
  42       ADC channel used for converting the voltage from AOUT to a digital
  43       representation.
  44
  45   io-channel-names:
  46     const: aout
  47
  48   vdd-supply: true
  49
  50   capella,aset-resistance-ohms:
  51     enum: [50000, 100000, 300000, 600000]
  52     description: >
  53       Sensitivity calibration resistance. Note that calibration curves
  54       are only provided for specific allowed values. Default: 100 kOhms.
  55
  56 required:
  57   - compatible
  58   - aset-gpios
  59   - interrupts
  60   - io-channels
  61   - io-channel-names
  62
  63 additionalProperties: false
  64
  65 examples:
  66   - |
  67     #include <dt-bindings/gpio/gpio.h>
  68     #include <dt-bindings/interrupt-controller/irq.h>
  69     light-sensor {
  70         compatible = "capella,cm3605";
  71         vdd-supply = <&foo_reg>;
  72         aset-gpios = <&foo_gpio 1 GPIO_ACTIVE_LOW>;
  73         capella,aset-resistance-ohms = <100000>;
  74         interrupts = <1 IRQ_TYPE_EDGE_BOTH>;
  75         io-channels = <&adc 0x01>;
  76         io-channel-names = "aout";
  77     };
  78 ...