1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/iio/light/s 4 $id: http://devicetree.org/schemas/iio/light/sharp,gp2ap002.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Sharp GP2AP002A00F and GP2AP002S00F pro 7 title: Sharp GP2AP002A00F and GP2AP002S00F proximity and ambient light sensors
8 8
9 maintainers: 9 maintainers:
10 - Linus Walleij <linus.walleij@linaro.org> 10 - Linus Walleij <linus.walleij@linaro.org>
11 11
12 description: | 12 description: |
13 Proximity and ambient light sensor with IR L 13 Proximity and ambient light sensor with IR LED for the proximity
14 sensing and an analog output for light inten 14 sensing and an analog output for light intensity. The ambient light
15 sensor output is not available on the GP2AP0 15 sensor output is not available on the GP2AP002S00F variant.
16 16
17 properties: 17 properties:
18 compatible: 18 compatible:
19 enum: 19 enum:
20 - sharp,gp2ap002a00f 20 - sharp,gp2ap002a00f
21 - sharp,gp2ap002s00f 21 - sharp,gp2ap002s00f
22 22
23 reg: 23 reg:
24 maxItems: 1 24 maxItems: 1
25 25
26 interrupts: 26 interrupts:
27 maxItems: 1 27 maxItems: 1
28 description: an interrupt for proximity, u 28 description: an interrupt for proximity, usually a GPIO line
29 29
30 vdd-supply: 30 vdd-supply:
31 description: VDD power supply a phandle to 31 description: VDD power supply a phandle to a regulator
32 32
33 vio-supply: 33 vio-supply:
34 description: VIO power supply a phandle to 34 description: VIO power supply a phandle to a regulator
35 35
36 io-channels: 36 io-channels:
37 maxItems: 1 37 maxItems: 1
38 description: ALSOUT ADC channel to read th 38 description: ALSOUT ADC channel to read the ambient light
39 39
40 io-channel-names: 40 io-channel-names:
41 const: alsout 41 const: alsout
42 42
43 sharp,proximity-far-hysteresis: 43 sharp,proximity-far-hysteresis:
44 $ref: /schemas/types.yaml#/definitions/uin 44 $ref: /schemas/types.yaml#/definitions/uint8
45 description: | 45 description: |
46 Hysteresis setting for "far" object dete 46 Hysteresis setting for "far" object detection, this setting is
47 device-unique and adjust the optical set 47 device-unique and adjust the optical setting for proximity detection
48 of a "far away" object in front of the s 48 of a "far away" object in front of the sensor.
49 49
50 sharp,proximity-close-hysteresis: 50 sharp,proximity-close-hysteresis:
51 $ref: /schemas/types.yaml#/definitions/uin 51 $ref: /schemas/types.yaml#/definitions/uint8
52 description: | 52 description: |
53 Hysteresis setting for "close" object de 53 Hysteresis setting for "close" object detection, this setting is
54 device-unique and adjust the optical set 54 device-unique and adjust the optical setting for proximity detection
55 of a "close" object in front of the sens 55 of a "close" object in front of the sensor.
56 56
57 required: 57 required:
58 - compatible 58 - compatible
59 - reg 59 - reg
60 - interrupts 60 - interrupts
61 - sharp,proximity-far-hysteresis 61 - sharp,proximity-far-hysteresis
62 - sharp,proximity-close-hysteresis 62 - sharp,proximity-close-hysteresis
63 63
64 additionalProperties: false 64 additionalProperties: false
65 65
66 examples: 66 examples:
67 - | 67 - |
68 #include <dt-bindings/interrupt-controller 68 #include <dt-bindings/interrupt-controller/irq.h>
69 69
70 i2c { 70 i2c {
71 #address-cells = <1>; 71 #address-cells = <1>;
72 #size-cells = <0>; 72 #size-cells = <0>;
73 73
74 light-sensor@44 { 74 light-sensor@44 {
75 compatible = "sharp,gp2ap002a00f"; 75 compatible = "sharp,gp2ap002a00f";
76 reg = <0x44>; 76 reg = <0x44>;
77 interrupts = <18 IRQ_TYPE_EDGE_FALLING 77 interrupts = <18 IRQ_TYPE_EDGE_FALLING>;
78 vdd-supply = <&vdd_regulator>; 78 vdd-supply = <&vdd_regulator>;
79 vio-supply = <&vio_regulator>; 79 vio-supply = <&vio_regulator>;
80 io-channels = <&adc_channel>; 80 io-channels = <&adc_channel>;
81 io-channel-names = "alsout"; 81 io-channel-names = "alsout";
82 sharp,proximity-far-hysteresis = /bits 82 sharp,proximity-far-hysteresis = /bits/ 8 <0x2f>;
83 sharp,proximity-close-hysteresis = /bi 83 sharp,proximity-close-hysteresis = /bits/ 8 <0x0f>;
84 }; 84 };
85 }; 85 };
86 86
87 ... 87 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.