Documentation/devicetree/bindings/rtc/s3c-rtc.yaml

   1 # SPDX-License-Identifier: GPL-2.0
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/rtc/s3c-rtc.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Samsung S3C, S5P and Exynos Real Time Clock controller
   8
   9 maintainers:
  10   - Krzysztof Kozlowski <krzk@kernel.org>
  11
  12 properties:
  13   compatible:
  14     oneOf:
  15       - enum:
  16           - samsung,s3c2410-rtc
  17           - samsung,s3c2416-rtc
  18           - samsung,s3c2443-rtc
  19           - samsung,s3c6410-rtc
  20       - items:
  21           - enum:
  22               - samsung,exynos7-rtc
  23               - samsung,exynos850-rtc
  24           - const: samsung,s3c6410-rtc
  25       - const: samsung,exynos3250-rtc
  26         deprecated: true
  27
  28   reg:
  29     maxItems: 1
  30
  31   clocks:
  32     description:
  33       Must contain a list of phandle and clock specifier for the rtc
  34       clock and in the case of a s3c6410 compatible controller, also
  35       a source clock.
  36     minItems: 1
  37     maxItems: 2
  38
  39   clock-names:
  40     description:
  41       Must contain "rtc" and for a s3c6410 compatible controller
  42       also "rtc_src".
  43     minItems: 1
  44     maxItems: 2
  45
  46   interrupts:
  47     description:
  48       Two interrupt numbers to the cpu should be specified. First
  49       interrupt number is the rtc alarm interrupt and second interrupt number
  50       is the rtc tick interrupt. The number of cells representing a interrupt
  51       depends on the parent interrupt controller.
  52     minItems: 2
  53     maxItems: 2
  54
  55 allOf:
  56   - $ref: rtc.yaml#
  57   - if:
  58       properties:
  59         compatible:
  60           contains:
  61             enum:
  62               - samsung,s3c6410-rtc
  63               - samsung,exynos3250-rtc
  64     then:
  65       properties:
  66         clocks:
  67           minItems: 2
  68           maxItems: 2
  69         clock-names:
  70           items:
  71             - const: rtc
  72             - const: rtc_src
  73     else:
  74       properties:
  75         clocks:
  76           minItems: 1
  77           maxItems: 1
  78         clock-names:
  79           items:
  80             - const: rtc
  81
  82 unevaluatedProperties: false
  83
  84 examples:
  85   - |
  86     #include <dt-bindings/clock/exynos5420.h>
  87     #include <dt-bindings/clock/samsung,s2mps11.h>
  88
  89     rtc@10070000 {
  90         compatible = "samsung,s3c6410-rtc";
  91         reg = <0x10070000 0x100>;
  92         interrupts = <0 44 4>, <0 45 4>;
  93         clocks = <&clock CLK_RTC>,
  94                  <&s2mps11_osc S2MPS11_CLK_AP>;
  95         clock-names = "rtc", "rtc_src";
  96     };