xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/rtc/allwinner,sun6i-a31-rtc.yaml (revision 4882a59341e53eb6f0b4789bf948001014eff981) 
1*4882a593Smuzhiyun# SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun%YAML 1.2
3*4882a593Smuzhiyun---
4*4882a593Smuzhiyun$id: http://devicetree.org/schemas/rtc/allwinner,sun6i-a31-rtc.yaml#
5*4882a593Smuzhiyun$schema: http://devicetree.org/meta-schemas/core.yaml#
6*4882a593Smuzhiyun
7*4882a593Smuzhiyuntitle: Allwinner A31 RTC Device Tree Bindings
8*4882a593Smuzhiyun
9*4882a593Smuzhiyunmaintainers:
10*4882a593Smuzhiyun  - Chen-Yu Tsai <wens@csie.org>
11*4882a593Smuzhiyun  - Maxime Ripard <mripard@kernel.org>
12*4882a593Smuzhiyun
13*4882a593Smuzhiyunproperties:
14*4882a593Smuzhiyun  "#clock-cells":
15*4882a593Smuzhiyun    const: 1
16*4882a593Smuzhiyun
17*4882a593Smuzhiyun  compatible:
18*4882a593Smuzhiyun    oneOf:
19*4882a593Smuzhiyun      - const: allwinner,sun6i-a31-rtc
20*4882a593Smuzhiyun      - const: allwinner,sun8i-a23-rtc
21*4882a593Smuzhiyun      - const: allwinner,sun8i-h3-rtc
22*4882a593Smuzhiyun      - const: allwinner,sun8i-r40-rtc
23*4882a593Smuzhiyun      - const: allwinner,sun8i-v3-rtc
24*4882a593Smuzhiyun      - const: allwinner,sun50i-h5-rtc
25*4882a593Smuzhiyun      - items:
26*4882a593Smuzhiyun          - const: allwinner,sun50i-a64-rtc
27*4882a593Smuzhiyun          - const: allwinner,sun8i-h3-rtc
28*4882a593Smuzhiyun      - const: allwinner,sun50i-h6-rtc
29*4882a593Smuzhiyun
30*4882a593Smuzhiyun  reg:
31*4882a593Smuzhiyun    maxItems: 1
32*4882a593Smuzhiyun
33*4882a593Smuzhiyun  interrupts:
34*4882a593Smuzhiyun    minItems: 1
35*4882a593Smuzhiyun    maxItems: 2
36*4882a593Smuzhiyun    items:
37*4882a593Smuzhiyun      - description: RTC Alarm 0
38*4882a593Smuzhiyun      - description: RTC Alarm 1
39*4882a593Smuzhiyun
40*4882a593Smuzhiyun  clocks:
41*4882a593Smuzhiyun    maxItems: 1
42*4882a593Smuzhiyun
43*4882a593Smuzhiyun  clock-output-names:
44*4882a593Smuzhiyun    minItems: 1
45*4882a593Smuzhiyun    maxItems: 3
46*4882a593Smuzhiyun    description:
47*4882a593Smuzhiyun      The RTC provides up to three clocks
48*4882a593Smuzhiyun        - the Low Frequency Oscillator or LOSC, at index 0,
49*4882a593Smuzhiyun        - the Low Frequency Oscillator External output (X32KFOUT in
50*4882a593Smuzhiyun          the datasheet), at index 1,
51*4882a593Smuzhiyun        - the Internal Oscillator, at index 2.
52*4882a593Smuzhiyun
53*4882a593SmuzhiyunallOf:
54*4882a593Smuzhiyun  - $ref: "rtc.yaml#"
55*4882a593Smuzhiyun  - if:
56*4882a593Smuzhiyun      properties:
57*4882a593Smuzhiyun        compatible:
58*4882a593Smuzhiyun          contains:
59*4882a593Smuzhiyun            const: allwinner,sun6i-a31-rtc
60*4882a593Smuzhiyun
61*4882a593Smuzhiyun    then:
62*4882a593Smuzhiyun      properties:
63*4882a593Smuzhiyun        clock-output-names:
64*4882a593Smuzhiyun          minItems: 1
65*4882a593Smuzhiyun          maxItems: 1
66*4882a593Smuzhiyun
67*4882a593Smuzhiyun  - if:
68*4882a593Smuzhiyun      properties:
69*4882a593Smuzhiyun        compatible:
70*4882a593Smuzhiyun          contains:
71*4882a593Smuzhiyun            enum:
72*4882a593Smuzhiyun              - allwinner,sun8i-a23-rtc
73*4882a593Smuzhiyun              - allwinner,sun8i-r40-rtc
74*4882a593Smuzhiyun              - allwinner,sun8i-v3-rtc
75*4882a593Smuzhiyun
76*4882a593Smuzhiyun    then:
77*4882a593Smuzhiyun      properties:
78*4882a593Smuzhiyun        clock-output-names:
79*4882a593Smuzhiyun          minItems: 2
80*4882a593Smuzhiyun          maxItems: 2
81*4882a593Smuzhiyun
82*4882a593Smuzhiyun  - if:
83*4882a593Smuzhiyun      properties:
84*4882a593Smuzhiyun        compatible:
85*4882a593Smuzhiyun          contains:
86*4882a593Smuzhiyun            enum:
87*4882a593Smuzhiyun              - allwinner,sun8i-h3-rtc
88*4882a593Smuzhiyun              - allwinner,sun50i-h5-rtc
89*4882a593Smuzhiyun
90*4882a593Smuzhiyun    then:
91*4882a593Smuzhiyun      properties:
92*4882a593Smuzhiyun        clock-output-names:
93*4882a593Smuzhiyun          minItems: 3
94*4882a593Smuzhiyun          maxItems: 3
95*4882a593Smuzhiyun
96*4882a593Smuzhiyun  - if:
97*4882a593Smuzhiyun      properties:
98*4882a593Smuzhiyun        compatible:
99*4882a593Smuzhiyun          contains:
100*4882a593Smuzhiyun            const: allwinner,sun50i-h6-rtc
101*4882a593Smuzhiyun
102*4882a593Smuzhiyun    then:
103*4882a593Smuzhiyun      properties:
104*4882a593Smuzhiyun        clock-output-names:
105*4882a593Smuzhiyun          minItems: 3
106*4882a593Smuzhiyun          maxItems: 3
107*4882a593Smuzhiyun
108*4882a593Smuzhiyun  - if:
109*4882a593Smuzhiyun      properties:
110*4882a593Smuzhiyun        compatible:
111*4882a593Smuzhiyun          contains:
112*4882a593Smuzhiyun            const: allwinner,sun8i-r40-rtc
113*4882a593Smuzhiyun
114*4882a593Smuzhiyun    then:
115*4882a593Smuzhiyun      properties:
116*4882a593Smuzhiyun        interrupts:
117*4882a593Smuzhiyun          minItems: 1
118*4882a593Smuzhiyun          maxItems: 1
119*4882a593Smuzhiyun
120*4882a593Smuzhiyun    else:
121*4882a593Smuzhiyun      properties:
122*4882a593Smuzhiyun        interrupts:
123*4882a593Smuzhiyun          minItems: 2
124*4882a593Smuzhiyun          maxItems: 2
125*4882a593Smuzhiyun
126*4882a593Smuzhiyunrequired:
127*4882a593Smuzhiyun  - "#clock-cells"
128*4882a593Smuzhiyun  - compatible
129*4882a593Smuzhiyun  - reg
130*4882a593Smuzhiyun  - interrupts
131*4882a593Smuzhiyun  - clocks
132*4882a593Smuzhiyun  - clock-output-names
133*4882a593Smuzhiyun
134*4882a593SmuzhiyunadditionalProperties: false
135*4882a593Smuzhiyun
136*4882a593Smuzhiyunexamples:
137*4882a593Smuzhiyun  - |
138*4882a593Smuzhiyun    rtc: rtc@1f00000 {
139*4882a593Smuzhiyun        compatible = "allwinner,sun6i-a31-rtc";
140*4882a593Smuzhiyun        reg = <0x01f00000 0x400>;
141*4882a593Smuzhiyun        interrupts = <0 40 4>, <0 41 4>;
142*4882a593Smuzhiyun        clock-output-names = "osc32k";
143*4882a593Smuzhiyun        clocks = <&ext_osc32k>;
144*4882a593Smuzhiyun        #clock-cells = <1>;
145*4882a593Smuzhiyun    };
146*4882a593Smuzhiyun
147*4882a593Smuzhiyun...
148