Documentation/devicetree/bindings/timer/sprd,sc9860-timer.yaml

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

title: Spreadtrum SC9860 timer

maintainers:
  - Orson Zhai <orsonzhai@gmail.com>
  - Baolin Wang <baolin.wang7@gmail.com>
  - Chunyan Zhang <zhang.lyra@gmail.com>

description:
  The Spreadtrum SC9860 platform provides 3 general-purpose timers.
  These timers can support 32bit or 64bit counter, as well as supporting
  period mode or one-shot mode, and they can be a wakeup source
  during deep sleep.

properties:
  compatible:
    enum:
      - sprd,sc9860-timer
      - sprd,sc9860-suspend-timer

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  clocks:
    maxItems: 1

required:
  - compatible
  - reg
  - clocks

allOf:
  - if:
      properties:
        compatible:
          contains:
            const: sprd,sc9860-timer
    then:
      required:
        - interrupts

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/interrupt-controller/irq.h>

    soc {
      #address-cells = <2>;
      #size-cells = <2>;

      timer@40050000 {
        compatible = "sprd,sc9860-timer";
        reg = <0 0x40050000 0 0x20>;
        interrupts = <GIC_SPI 26 IRQ_TYPE_LEVEL_HIGH>;
        clocks = <&ext_32k>;
      };
    };
...