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