xref: /linux/Documentation/devicetree/bindings/rtc/ti,omap-rtc.yaml (revision 3a2c4d55e32ad65efebdb6de44eef3bfa08bb49d) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/rtc/ti,omap-rtc.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Texas Instruments OMAP Real Time Clock
8
9maintainers:
10  - Keerthy <j-keerthy@ti.com>
11  - Afzal Mohammed <afzal@ti.com>
12
13description:
14  The OMAP RTC is a year/month/day/hours/minutes/seconds BCD clock with
15  century-range alarm matching, driven by the 32kHz clock.
16
17properties:
18  compatible:
19    oneOf:
20      - const: ti,da830-rtc
21      - items:
22          - const: ti,am3352-rtc
23          - const: ti,da830-rtc
24      - items:
25          - const: ti,am4372-rtc
26          - const: ti,am3352-rtc
27          - const: ti,da830-rtc
28
29  reg:
30    maxItems: 1
31
32  interrupts:
33    minItems: 2
34    maxItems: 2
35
36  system-power-controller:
37    type: boolean
38    description:
39      Indicates that this RTC controls system power via the pmic_power_en pin.
40
41  clocks:
42    minItems: 1
43    maxItems: 2
44
45  clock-names:
46    minItems: 1
47    items:
48      - enum: [ext-clk, int-clk]
49      - const: int-clk
50
51  pinctrl-0:
52    description:
53      Phandle to pin configuration for the external wakeup pins.
54
55  pinctrl-names:
56    minItems: 1
57
58  ti,hwmods:
59    $ref: /schemas/types.yaml#/definitions/string
60    description:
61      Name of the hwmod associated with the RTC.
62    const: rtc
63    deprecated: true
64
65patternProperties:
66  "^ext-wakeup(-[0-9]+)?$":
67    type: object
68
69    description:
70      Child node describing external wakeup pin configuration.
71
72    properties:
73      pins:
74        pattern: '^ext_wakeup[0-3]$'
75
76      input-enable:
77        type: boolean
78        description:
79          Enables the external wakeup input on the selected pin.
80
81      ti,active-high:
82        type: boolean
83        description:
84          Sets the wakeup input polarity to active high. By default the
85          input is active low.
86
87    required:
88      - pins
89
90    additionalProperties: false
91
92required:
93  - compatible
94  - reg
95  - interrupts
96
97allOf:
98  - $ref: rtc.yaml#
99  - if:
100      not:
101        properties:
102          compatible:
103            contains:
104              const: ti,am3352-rtc
105    then:
106      properties:
107        system-power-controller: false
108      patternProperties:
109        "^ext-wakeup(-[0-9]+)?$": false
110
111unevaluatedProperties: false
112
113examples:
114  - |
115    rtc@23000 {
116        compatible = "ti,da830-rtc";
117        reg = <0x23000 0x1000>;
118        interrupts = <19>, <19>;
119        clocks = <&clk_32768_ck>;
120        clock-names = "int-clk";
121    };
122
123  - |
124    rtc@0 {
125        compatible = "ti,am3352-rtc", "ti,da830-rtc";
126        reg = <0x0 0x1000>;
127        interrupts = <75>, <76>;
128        system-power-controller;
129        clocks = <&clk_32k_rtc>, <&clk_32768_ck>;
130        clock-names = "ext-clk", "int-clk";
131
132        pinctrl-0 = <&ext_wakeup>;
133        pinctrl-names = "default";
134
135        ext-wakeup {
136            pins = "ext_wakeup0";
137            input-enable;
138            ti,active-high;
139        };
140    };
141