xref: /freebsd/sys/contrib/device-tree/Bindings/iio/proximity/nicera,d3323aa.yaml (revision 833e5d42ab135b0238e61c5b3c19b8619677cbfa) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/iio/proximity/nicera,d3323aa.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Nicera D3-323-AA PIR sensor
8
9maintainers:
10  - Waqar Hameed <waqar.hameed@axis.com>
11
12description: |
13  PIR sensor for human detection.
14  Datasheet: https://www.endrich.com/Datenbl%C3%A4tter/Sensoren/D3-323-AA_e.pdf
15
16properties:
17  compatible:
18    const: nicera,d3323aa
19
20  vdd-supply:
21    description:
22      Supply voltage (1.8 to 5.5 V).
23
24  vout-clk-gpios:
25    maxItems: 1
26    description:
27      GPIO for clock and detection.
28      After reset, the device signals with two falling edges on this pin that it
29      is ready for configuration (within 1.2 s).
30      During configuration, it is used as clock for data reading and writing (on
31      data-gpios).
32      After all this, when device is in operational mode, it signals on this pin
33      for any detections.
34
35  data-gpios:
36    maxItems: 1
37    description:
38      GPIO for data reading and writing. This is denoted "DO (SI)" in datasheet.
39      During configuration, this pin is used for writing and reading
40      configuration data (together with vout-clk-gpios as clock).
41      After this, during operational mode, the device will output serial data on
42      this GPIO.
43
44required:
45  - compatible
46  - vdd-supply
47  - vout-clk-gpios
48  - data-gpios
49
50additionalProperties: false
51
52examples:
53  - |
54    #include <dt-bindings/gpio/gpio.h>
55
56    proximity {
57        compatible = "nicera,d3323aa";
58        vdd-supply = <&regulator_3v3>;
59        vout-clk-gpios = <&gpio 78 GPIO_ACTIVE_HIGH>;
60        data-gpios = <&gpio 76 GPIO_ACTIVE_HIGH>;
61    };
62...
63