xref: /linux/Documentation/devicetree/bindings/rtc/rtc-ds1307.yaml (revision 3bf4c5970ca8c4bcd8312a3e9d577894e438c3a1)
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/rtc/rtc-ds1307.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Dallas DS1307 and compatible RTC
8
9maintainers:
10  - Alexandre Belloni <alexandre.belloni@bootlin.com>
11
12properties:
13  compatible:
14    oneOf:
15      - enum:
16          - dallas,ds1307
17          - dallas,ds1308
18          - dallas,ds1337
19          - dallas,ds1338
20          - dallas,ds1339
21          - dallas,ds1388
22          - dallas,ds1340
23          - dallas,ds1341
24          - maxim,ds3231
25          - st,m41t0
26          - st,m41t00
27          - st,m41t11
28          - microchip,mcp7940x
29          - microchip,mcp7941x
30          - pericom,pt7c4338
31          - epson,rx8025
32          - isil,isl12057
33          - epson,rx8130
34          - epson,rx8901
35
36      - items:
37          - enum:
38              - st,m41t00
39          - const: dallas,ds1338
40
41  reg:
42    maxItems: 1
43
44  interrupts:
45    minItems: 1
46    maxItems: 2
47
48  interrupt-names:
49    maxItems: 2
50
51  "#clock-cells":
52    const: 1
53
54  clock-output-names:
55    description: From common clock binding to override the default output clock name.
56
57  wakeup-source:
58    description: Enables wake up of host system on alarm.
59
60  vcc-supply: true
61
62allOf:
63  - $ref: rtc.yaml
64  - if:
65      properties:
66        compatible:
67          contains:
68            enum:
69              - dallas,ds1339
70              - dallas,ds1340
71              - dallas,ds1388
72    then:
73      properties:
74        trickle-resistor-ohms:
75          description: Selected resistor for trickle charger. Should be specified if trickle
76            charger should be enabled.
77          enum: [ 250, 2000, 4000 ]
78
79        trickle-diode-disable:
80          description: Do not use internal trickle charger diode. Should be given if internal
81            trickle charger diode should be disabled (superseded by aux-voltage-chargeable)
82          deprecated: true
83
84unevaluatedProperties: false
85
86required:
87  - compatible
88  - reg
89
90examples:
91  - |
92    i2c {
93      #address-cells = <1>;
94      #size-cells = <0>;
95
96      rtc@68 {
97        compatible = "dallas,ds1337";
98        reg = <0x68>;
99        interrupt-parent = <&gpio4>;
100        interrupts = <20 0>;
101        trickle-resistor-ohms = <250>;
102      };
103    };
104