Documentation/devicetree/bindings/rtc/intersil,isl12022.yaml

   1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/rtc/intersil,isl12022.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Intersil ISL12022 Real-time Clock
   8
   9 maintainers:
  10   - Alexandre Belloni <alexandre.belloni@bootlin.com>
  11
  12 properties:
  13   compatible:
  14     const: isil,isl12022
  15
  16   reg:
  17     maxItems: 1
  18
  19   interrupts:
  20     maxItems: 1
  21
  22   '#clock-cells':
  23     const: 0
  24
  25   isil,battery-trip-levels-microvolt:
  26     description:
  27       The battery voltages at which the first alarm and second alarm
  28       should trigger (normally ~85% and ~75% of nominal V_BAT).
  29     items:
  30       - enum: [2125000, 2295000, 2550000, 2805000, 3060000, 4250000, 4675000]
  31       - enum: [1875000, 2025000, 2250000, 2475000, 2700000, 3750000, 4125000]
  32
  33 required:
  34   - compatible
  35   - reg
  36
  37 allOf:
  38   - $ref: rtc.yaml#
  39   # If #clock-cells is present, interrupts must not be present
  40   - if:
  41       required:
  42         - '#clock-cells'
  43     then:
  44       properties:
  45         interrupts: false
  46
  47 unevaluatedProperties: false
  48
  49 examples:
  50   - |
  51     #include <dt-bindings/interrupt-controller/irq.h>
  52     i2c {
  53         #address-cells = <1>;
  54         #size-cells = <0>;
  55
  56         rtc@6f {
  57             compatible = "isil,isl12022";
  58             reg = <0x6f>;
  59             interrupts-extended = <&gpio1 5 IRQ_TYPE_LEVEL_LOW>;
  60             isil,battery-trip-levels-microvolt = <2550000>, <2250000>;
  61         };
  62     };
  63
  64 ...