GNU Linux-libre 5.19-rc6-gnu
[releases.git] / Documentation / devicetree / bindings / rtc / rtc-ds1307.txt
1 Dallas DS1307 and compatible RTC
2
3 Required properties:
4 - compatible: should be one of:
5         "dallas,ds1307",
6         "dallas,ds1308",
7         "dallas,ds1337",
8         "dallas,ds1338",
9         "dallas,ds1339",
10         "dallas,ds1388",
11         "dallas,ds1340",
12         "dallas,ds1341",
13         "maxim,ds3231",
14         "st,m41t0",
15         "st,m41t00",
16         "st,m41t11",
17         "microchip,mcp7940x",
18         "microchip,mcp7941x",
19         "pericom,pt7c4338",
20         "epson,rx8025",
21         "isil,isl12057"
22         "epson,rx8130"
23 - reg: I2C bus address of the device
24
25 Optional properties:
26 - interrupts: rtc alarm interrupt.
27 - clock-output-names: From common clock binding to override the default output
28                       clock name
29 - wakeup-source: Enables wake up of host system on alarm
30 - trickle-resistor-ohms : ds1339, ds1340 and ds 1388 only
31         Selected resistor for trickle charger
32         Possible values are 250, 2000, 4000
33         Should be given if trickle charger should be enabled
34 - aux-voltage-chargeable: ds1339, ds1340, ds1388 and rx8130 only
35         Tells whether the battery/supercap of the RTC (if any) is
36         chargeable or not.
37         Possible values are 0 (not chargeable), 1 (chargeable)
38
39 Deprecated properties:
40 - trickle-diode-disable : ds1339, ds1340 and ds1388 only
41         Do not use internal trickle charger diode
42         Should be given if internal trickle charger diode should be disabled
43         (superseded by aux-voltage-chargeable)
44
45 Example:
46         ds1339: rtc@68 {
47                 compatible = "dallas,ds1339";
48                 reg = <0x68>;
49                 interrupt-parent = <&gpio4>;
50                 interrupts = <20 0>;
51                 trickle-resistor-ohms = <250>;
52         };