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

# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/rtc/intersil,isl12022.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Intersil ISL12022 Real-time Clock

maintainers:
  - Alexandre Belloni <alexandre.belloni@bootlin.com>

properties:
  compatible:
    const: isil,isl12022

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  '#clock-cells':
    const: 0

  isil,battery-trip-levels-microvolt:
    description:
      The battery voltages at which the first alarm and second alarm
      should trigger (normally ~85% and ~75% of nominal V_BAT).
    items:
      - enum: [2125000, 2295000, 2550000, 2805000, 3060000, 4250000, 4675000]
      - enum: [1875000, 2025000, 2250000, 2475000, 2700000, 3750000, 4125000]

required:
  - compatible
  - reg

allOf:
  - $ref: rtc.yaml#
  # If #clock-cells is present, interrupts must not be present
  - if:
      required:
        - '#clock-cells'
    then:
      properties:
        interrupts: false

unevaluatedProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>
    i2c {
        #address-cells = <1>;
        #size-cells = <0>;

        rtc@6f {
            compatible = "isil,isl12022";
            reg = <0x6f>;
            interrupts-extended = <&gpio1 5 IRQ_TYPE_LEVEL_LOW>;
            isil,battery-trip-levels-microvolt = <2550000>, <2250000>;
        };
    };

...