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