1 // SPDX-License-Identifier: GPL-2.0-only
3 * rtc-ds1307.c - RTC driver for some mostly-compatible I2C chips.
5 * Copyright (C) 2005 James Chapman (ds1337 core)
6 * Copyright (C) 2006 David Brownell
7 * Copyright (C) 2009 Matthias Fuchs (rx8025 support)
8 * Copyright (C) 2012 Bertrand Achard (nvram access fixes)
11 #include <linux/bcd.h>
12 #include <linux/i2c.h>
13 #include <linux/init.h>
14 #include <linux/mod_devicetable.h>
15 #include <linux/module.h>
16 #include <linux/property.h>
17 #include <linux/rtc/ds1307.h>
18 #include <linux/rtc.h>
19 #include <linux/slab.h>
20 #include <linux/string.h>
21 #include <linux/hwmon.h>
22 #include <linux/hwmon-sysfs.h>
23 #include <linux/clk-provider.h>
24 #include <linux/regmap.h>
25 #include <linux/watchdog.h>
28 * We can't determine type by probing, but if we expect pre-Linux code
29 * to have set the chip up as a clock (turning on the oscillator and
30 * setting the date and time), Linux can ignore the non-clock features.
31 * That's a natural job for a factory or repair bench.
34 unknown_ds_type
, /* always first and 0 */
50 last_ds_type
/* always last */
51 /* rs5c372 too? different address... */
54 /* RTC registers don't differ much, except for the century flag */
55 #define DS1307_REG_SECS 0x00 /* 00-59 */
56 # define DS1307_BIT_CH 0x80
57 # define DS1340_BIT_nEOSC 0x80
58 # define MCP794XX_BIT_ST 0x80
59 #define DS1307_REG_MIN 0x01 /* 00-59 */
60 # define M41T0_BIT_OF 0x80
61 #define DS1307_REG_HOUR 0x02 /* 00-23, or 1-12{am,pm} */
62 # define DS1307_BIT_12HR 0x40 /* in REG_HOUR */
63 # define DS1307_BIT_PM 0x20 /* in REG_HOUR */
64 # define DS1340_BIT_CENTURY_EN 0x80 /* in REG_HOUR */
65 # define DS1340_BIT_CENTURY 0x40 /* in REG_HOUR */
66 #define DS1307_REG_WDAY 0x03 /* 01-07 */
67 # define MCP794XX_BIT_VBATEN 0x08
68 #define DS1307_REG_MDAY 0x04 /* 01-31 */
69 #define DS1307_REG_MONTH 0x05 /* 01-12 */
70 # define DS1337_BIT_CENTURY 0x80 /* in REG_MONTH */
71 #define DS1307_REG_YEAR 0x06 /* 00-99 */
74 * Other registers (control, status, alarms, trickle charge, NVRAM, etc)
75 * start at 7, and they differ a LOT. Only control and status matter for
76 * basic RTC date and time functionality; be careful using them.
78 #define DS1307_REG_CONTROL 0x07 /* or ds1338 */
79 # define DS1307_BIT_OUT 0x80
80 # define DS1338_BIT_OSF 0x20
81 # define DS1307_BIT_SQWE 0x10
82 # define DS1307_BIT_RS1 0x02
83 # define DS1307_BIT_RS0 0x01
84 #define DS1337_REG_CONTROL 0x0e
85 # define DS1337_BIT_nEOSC 0x80
86 # define DS1339_BIT_BBSQI 0x20
87 # define DS3231_BIT_BBSQW 0x40 /* same as BBSQI */
88 # define DS1337_BIT_RS2 0x10
89 # define DS1337_BIT_RS1 0x08
90 # define DS1337_BIT_INTCN 0x04
91 # define DS1337_BIT_A2IE 0x02
92 # define DS1337_BIT_A1IE 0x01
93 #define DS1340_REG_CONTROL 0x07
94 # define DS1340_BIT_OUT 0x80
95 # define DS1340_BIT_FT 0x40
96 # define DS1340_BIT_CALIB_SIGN 0x20
97 # define DS1340_M_CALIBRATION 0x1f
98 #define DS1340_REG_FLAG 0x09
99 # define DS1340_BIT_OSF 0x80
100 #define DS1337_REG_STATUS 0x0f
101 # define DS1337_BIT_OSF 0x80
102 # define DS3231_BIT_EN32KHZ 0x08
103 # define DS1337_BIT_A2I 0x02
104 # define DS1337_BIT_A1I 0x01
105 #define DS1339_REG_ALARM1_SECS 0x07
107 #define DS13XX_TRICKLE_CHARGER_MAGIC 0xa0
109 #define RX8025_REG_CTRL1 0x0e
110 # define RX8025_BIT_2412 0x20
111 #define RX8025_REG_CTRL2 0x0f
112 # define RX8025_BIT_PON 0x10
113 # define RX8025_BIT_VDET 0x40
114 # define RX8025_BIT_XST 0x20
116 #define RX8130_REG_ALARM_MIN 0x17
117 #define RX8130_REG_ALARM_HOUR 0x18
118 #define RX8130_REG_ALARM_WEEK_OR_DAY 0x19
119 #define RX8130_REG_EXTENSION 0x1c
120 #define RX8130_REG_EXTENSION_WADA BIT(3)
121 #define RX8130_REG_FLAG 0x1d
122 #define RX8130_REG_FLAG_VLF BIT(1)
123 #define RX8130_REG_FLAG_AF BIT(3)
124 #define RX8130_REG_CONTROL0 0x1e
125 #define RX8130_REG_CONTROL0_AIE BIT(3)
126 #define RX8130_REG_CONTROL1 0x1f
127 #define RX8130_REG_CONTROL1_INIEN BIT(4)
128 #define RX8130_REG_CONTROL1_CHGEN BIT(5)
130 #define MCP794XX_REG_CONTROL 0x07
131 # define MCP794XX_BIT_ALM0_EN 0x10
132 # define MCP794XX_BIT_ALM1_EN 0x20
133 #define MCP794XX_REG_ALARM0_BASE 0x0a
134 #define MCP794XX_REG_ALARM0_CTRL 0x0d
135 #define MCP794XX_REG_ALARM1_BASE 0x11
136 #define MCP794XX_REG_ALARM1_CTRL 0x14
137 # define MCP794XX_BIT_ALMX_IF BIT(3)
138 # define MCP794XX_BIT_ALMX_C0 BIT(4)
139 # define MCP794XX_BIT_ALMX_C1 BIT(5)
140 # define MCP794XX_BIT_ALMX_C2 BIT(6)
141 # define MCP794XX_BIT_ALMX_POL BIT(7)
142 # define MCP794XX_MSK_ALMX_MATCH (MCP794XX_BIT_ALMX_C0 | \
143 MCP794XX_BIT_ALMX_C1 | \
144 MCP794XX_BIT_ALMX_C2)
146 #define M41TXX_REG_CONTROL 0x07
147 # define M41TXX_BIT_OUT BIT(7)
148 # define M41TXX_BIT_FT BIT(6)
149 # define M41TXX_BIT_CALIB_SIGN BIT(5)
150 # define M41TXX_M_CALIBRATION GENMASK(4, 0)
152 #define DS1388_REG_WDOG_HUN_SECS 0x08
153 #define DS1388_REG_WDOG_SECS 0x09
154 #define DS1388_REG_FLAG 0x0b
155 # define DS1388_BIT_WF BIT(6)
156 # define DS1388_BIT_OSF BIT(7)
157 #define DS1388_REG_CONTROL 0x0c
158 # define DS1388_BIT_RST BIT(0)
159 # define DS1388_BIT_WDE BIT(1)
160 # define DS1388_BIT_nEOSC BIT(7)
162 /* negative offset step is -2.034ppm */
163 #define M41TXX_NEG_OFFSET_STEP_PPB 2034
164 /* positive offset step is +4.068ppm */
165 #define M41TXX_POS_OFFSET_STEP_PPB 4068
166 /* Min and max values supported with 'offset' interface by M41TXX */
167 #define M41TXX_MIN_OFFSET ((-31) * M41TXX_NEG_OFFSET_STEP_PPB)
168 #define M41TXX_MAX_OFFSET ((31) * M41TXX_POS_OFFSET_STEP_PPB)
173 #define HAS_NVRAM 0 /* bit 0 == sysfs file active */
174 #define HAS_ALARM 1 /* bit 1 == irq claimed */
176 struct regmap
*regmap
;
178 struct rtc_device
*rtc
;
179 #ifdef CONFIG_COMMON_CLK
180 struct clk_hw clks
[2];
188 u8 offset
; /* register's offset */
190 u8 century_enable_bit
;
193 irq_handler_t irq_handler
;
194 const struct rtc_class_ops
*rtc_ops
;
195 u16 trickle_charger_reg
;
196 u8 (*do_trickle_setup
)(struct ds1307
*, u32
,
198 /* Does the RTC require trickle-resistor-ohms to select the value of
199 * the resistor between Vcc and Vbackup?
201 bool requires_trickle_resistor
;
202 /* Some RTC's batteries and supercaps were charged by default, others
203 * allow charging but were not configured previously to do so.
204 * Remember this behavior to stay backwards compatible.
209 static const struct chip_desc chips
[last_ds_type
];
211 static int ds1307_get_time(struct device
*dev
, struct rtc_time
*t
)
213 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
215 const struct chip_desc
*chip
= &chips
[ds1307
->type
];
218 if (ds1307
->type
== rx_8130
) {
219 unsigned int regflag
;
220 ret
= regmap_read(ds1307
->regmap
, RX8130_REG_FLAG
, ®flag
);
222 dev_err(dev
, "%s error %d\n", "read", ret
);
226 if (regflag
& RX8130_REG_FLAG_VLF
) {
227 dev_warn_once(dev
, "oscillator failed, set time!\n");
232 /* read the RTC date and time registers all at once */
233 ret
= regmap_bulk_read(ds1307
->regmap
, chip
->offset
, regs
,
236 dev_err(dev
, "%s error %d\n", "read", ret
);
240 dev_dbg(dev
, "%s: %7ph\n", "read", regs
);
242 /* if oscillator fail bit is set, no data can be trusted */
243 if (ds1307
->type
== m41t0
&&
244 regs
[DS1307_REG_MIN
] & M41T0_BIT_OF
) {
245 dev_warn_once(dev
, "oscillator failed, set time!\n");
249 tmp
= regs
[DS1307_REG_SECS
];
250 switch (ds1307
->type
) {
255 if (tmp
& DS1307_BIT_CH
)
260 if (tmp
& DS1307_BIT_CH
)
263 ret
= regmap_read(ds1307
->regmap
, DS1307_REG_CONTROL
, &tmp
);
266 if (tmp
& DS1338_BIT_OSF
)
270 if (tmp
& DS1340_BIT_nEOSC
)
273 ret
= regmap_read(ds1307
->regmap
, DS1340_REG_FLAG
, &tmp
);
276 if (tmp
& DS1340_BIT_OSF
)
280 ret
= regmap_read(ds1307
->regmap
, DS1388_REG_FLAG
, &tmp
);
283 if (tmp
& DS1388_BIT_OSF
)
287 if (!(tmp
& MCP794XX_BIT_ST
))
295 t
->tm_sec
= bcd2bin(regs
[DS1307_REG_SECS
] & 0x7f);
296 t
->tm_min
= bcd2bin(regs
[DS1307_REG_MIN
] & 0x7f);
297 tmp
= regs
[DS1307_REG_HOUR
] & 0x3f;
298 t
->tm_hour
= bcd2bin(tmp
);
299 t
->tm_wday
= bcd2bin(regs
[DS1307_REG_WDAY
] & 0x07) - 1;
300 t
->tm_mday
= bcd2bin(regs
[DS1307_REG_MDAY
] & 0x3f);
301 tmp
= regs
[DS1307_REG_MONTH
] & 0x1f;
302 t
->tm_mon
= bcd2bin(tmp
) - 1;
303 t
->tm_year
= bcd2bin(regs
[DS1307_REG_YEAR
]) + 100;
305 if (regs
[chip
->century_reg
] & chip
->century_bit
&&
306 IS_ENABLED(CONFIG_RTC_DRV_DS1307_CENTURY
))
309 dev_dbg(dev
, "%s secs=%d, mins=%d, "
310 "hours=%d, mday=%d, mon=%d, year=%d, wday=%d\n",
311 "read", t
->tm_sec
, t
->tm_min
,
312 t
->tm_hour
, t
->tm_mday
,
313 t
->tm_mon
, t
->tm_year
, t
->tm_wday
);
318 static int ds1307_set_time(struct device
*dev
, struct rtc_time
*t
)
320 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
321 const struct chip_desc
*chip
= &chips
[ds1307
->type
];
326 dev_dbg(dev
, "%s secs=%d, mins=%d, "
327 "hours=%d, mday=%d, mon=%d, year=%d, wday=%d\n",
328 "write", t
->tm_sec
, t
->tm_min
,
329 t
->tm_hour
, t
->tm_mday
,
330 t
->tm_mon
, t
->tm_year
, t
->tm_wday
);
332 if (t
->tm_year
< 100)
335 #ifdef CONFIG_RTC_DRV_DS1307_CENTURY
336 if (t
->tm_year
> (chip
->century_bit
? 299 : 199))
339 if (t
->tm_year
> 199)
343 regs
[DS1307_REG_SECS
] = bin2bcd(t
->tm_sec
);
344 regs
[DS1307_REG_MIN
] = bin2bcd(t
->tm_min
);
345 regs
[DS1307_REG_HOUR
] = bin2bcd(t
->tm_hour
);
346 regs
[DS1307_REG_WDAY
] = bin2bcd(t
->tm_wday
+ 1);
347 regs
[DS1307_REG_MDAY
] = bin2bcd(t
->tm_mday
);
348 regs
[DS1307_REG_MONTH
] = bin2bcd(t
->tm_mon
+ 1);
350 /* assume 20YY not 19YY */
351 tmp
= t
->tm_year
- 100;
352 regs
[DS1307_REG_YEAR
] = bin2bcd(tmp
);
354 if (chip
->century_enable_bit
)
355 regs
[chip
->century_reg
] |= chip
->century_enable_bit
;
356 if (t
->tm_year
> 199 && chip
->century_bit
)
357 regs
[chip
->century_reg
] |= chip
->century_bit
;
359 switch (ds1307
->type
) {
362 regmap_update_bits(ds1307
->regmap
, DS1307_REG_CONTROL
,
366 regmap_update_bits(ds1307
->regmap
, DS1340_REG_FLAG
,
370 regmap_update_bits(ds1307
->regmap
, DS1388_REG_FLAG
,
375 * these bits were cleared when preparing the date/time
376 * values and need to be set again before writing the
377 * regsfer out to the device.
379 regs
[DS1307_REG_SECS
] |= MCP794XX_BIT_ST
;
380 regs
[DS1307_REG_WDAY
] |= MCP794XX_BIT_VBATEN
;
386 dev_dbg(dev
, "%s: %7ph\n", "write", regs
);
388 result
= regmap_bulk_write(ds1307
->regmap
, chip
->offset
, regs
,
391 dev_err(dev
, "%s error %d\n", "write", result
);
395 if (ds1307
->type
== rx_8130
) {
396 /* clear Voltage Loss Flag as data is available now */
397 result
= regmap_write(ds1307
->regmap
, RX8130_REG_FLAG
,
398 ~(u8
)RX8130_REG_FLAG_VLF
);
400 dev_err(dev
, "%s error %d\n", "write", result
);
408 static int ds1337_read_alarm(struct device
*dev
, struct rtc_wkalrm
*t
)
410 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
414 if (!test_bit(HAS_ALARM
, &ds1307
->flags
))
417 /* read all ALARM1, ALARM2, and status registers at once */
418 ret
= regmap_bulk_read(ds1307
->regmap
, DS1339_REG_ALARM1_SECS
,
421 dev_err(dev
, "%s error %d\n", "alarm read", ret
);
425 dev_dbg(dev
, "%s: %4ph, %3ph, %2ph\n", "alarm read",
426 ®s
[0], ®s
[4], ®s
[7]);
429 * report alarm time (ALARM1); assume 24 hour and day-of-month modes,
430 * and that all four fields are checked matches
432 t
->time
.tm_sec
= bcd2bin(regs
[0] & 0x7f);
433 t
->time
.tm_min
= bcd2bin(regs
[1] & 0x7f);
434 t
->time
.tm_hour
= bcd2bin(regs
[2] & 0x3f);
435 t
->time
.tm_mday
= bcd2bin(regs
[3] & 0x3f);
438 t
->enabled
= !!(regs
[7] & DS1337_BIT_A1IE
);
439 t
->pending
= !!(regs
[8] & DS1337_BIT_A1I
);
441 dev_dbg(dev
, "%s secs=%d, mins=%d, "
442 "hours=%d, mday=%d, enabled=%d, pending=%d\n",
443 "alarm read", t
->time
.tm_sec
, t
->time
.tm_min
,
444 t
->time
.tm_hour
, t
->time
.tm_mday
,
445 t
->enabled
, t
->pending
);
450 static int ds1337_set_alarm(struct device
*dev
, struct rtc_wkalrm
*t
)
452 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
453 unsigned char regs
[9];
457 if (!test_bit(HAS_ALARM
, &ds1307
->flags
))
460 dev_dbg(dev
, "%s secs=%d, mins=%d, "
461 "hours=%d, mday=%d, enabled=%d, pending=%d\n",
462 "alarm set", t
->time
.tm_sec
, t
->time
.tm_min
,
463 t
->time
.tm_hour
, t
->time
.tm_mday
,
464 t
->enabled
, t
->pending
);
466 /* read current status of both alarms and the chip */
467 ret
= regmap_bulk_read(ds1307
->regmap
, DS1339_REG_ALARM1_SECS
, regs
,
470 dev_err(dev
, "%s error %d\n", "alarm write", ret
);
476 dev_dbg(dev
, "%s: %4ph, %3ph, %02x %02x\n", "alarm set (old status)",
477 ®s
[0], ®s
[4], control
, status
);
479 /* set ALARM1, using 24 hour and day-of-month modes */
480 regs
[0] = bin2bcd(t
->time
.tm_sec
);
481 regs
[1] = bin2bcd(t
->time
.tm_min
);
482 regs
[2] = bin2bcd(t
->time
.tm_hour
);
483 regs
[3] = bin2bcd(t
->time
.tm_mday
);
485 /* set ALARM2 to non-garbage */
491 regs
[7] = control
& ~(DS1337_BIT_A1IE
| DS1337_BIT_A2IE
);
492 regs
[8] = status
& ~(DS1337_BIT_A1I
| DS1337_BIT_A2I
);
494 ret
= regmap_bulk_write(ds1307
->regmap
, DS1339_REG_ALARM1_SECS
, regs
,
497 dev_err(dev
, "can't set alarm time\n");
501 /* optionally enable ALARM1 */
503 dev_dbg(dev
, "alarm IRQ armed\n");
504 regs
[7] |= DS1337_BIT_A1IE
; /* only ALARM1 is used */
505 regmap_write(ds1307
->regmap
, DS1337_REG_CONTROL
, regs
[7]);
511 static int ds1307_alarm_irq_enable(struct device
*dev
, unsigned int enabled
)
513 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
515 if (!test_bit(HAS_ALARM
, &ds1307
->flags
))
518 return regmap_update_bits(ds1307
->regmap
, DS1337_REG_CONTROL
,
520 enabled
? DS1337_BIT_A1IE
: 0);
523 static u8
do_trickle_setup_ds1339(struct ds1307
*ds1307
, u32 ohms
, bool diode
)
525 u8 setup
= (diode
) ? DS1307_TRICKLE_CHARGER_DIODE
:
526 DS1307_TRICKLE_CHARGER_NO_DIODE
;
528 setup
|= DS13XX_TRICKLE_CHARGER_MAGIC
;
532 setup
|= DS1307_TRICKLE_CHARGER_250_OHM
;
535 setup
|= DS1307_TRICKLE_CHARGER_2K_OHM
;
538 setup
|= DS1307_TRICKLE_CHARGER_4K_OHM
;
541 dev_warn(ds1307
->dev
,
542 "Unsupported ohm value %u in dt\n", ohms
);
548 static u8
do_trickle_setup_rx8130(struct ds1307
*ds1307
, u32 ohms
, bool diode
)
550 /* make sure that the backup battery is enabled */
551 u8 setup
= RX8130_REG_CONTROL1_INIEN
;
553 setup
|= RX8130_REG_CONTROL1_CHGEN
;
558 static irqreturn_t
rx8130_irq(int irq
, void *dev_id
)
560 struct ds1307
*ds1307
= dev_id
;
561 struct mutex
*lock
= &ds1307
->rtc
->ops_lock
;
567 /* Read control registers. */
568 ret
= regmap_bulk_read(ds1307
->regmap
, RX8130_REG_EXTENSION
, ctl
,
572 if (!(ctl
[1] & RX8130_REG_FLAG_AF
))
574 ctl
[1] &= ~RX8130_REG_FLAG_AF
;
575 ctl
[2] &= ~RX8130_REG_CONTROL0_AIE
;
577 ret
= regmap_bulk_write(ds1307
->regmap
, RX8130_REG_EXTENSION
, ctl
,
582 rtc_update_irq(ds1307
->rtc
, 1, RTC_AF
| RTC_IRQF
);
590 static int rx8130_read_alarm(struct device
*dev
, struct rtc_wkalrm
*t
)
592 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
596 if (!test_bit(HAS_ALARM
, &ds1307
->flags
))
599 /* Read alarm registers. */
600 ret
= regmap_bulk_read(ds1307
->regmap
, RX8130_REG_ALARM_MIN
, ald
,
605 /* Read control registers. */
606 ret
= regmap_bulk_read(ds1307
->regmap
, RX8130_REG_EXTENSION
, ctl
,
611 t
->enabled
= !!(ctl
[2] & RX8130_REG_CONTROL0_AIE
);
612 t
->pending
= !!(ctl
[1] & RX8130_REG_FLAG_AF
);
614 /* Report alarm 0 time assuming 24-hour and day-of-month modes. */
616 t
->time
.tm_min
= bcd2bin(ald
[0] & 0x7f);
617 t
->time
.tm_hour
= bcd2bin(ald
[1] & 0x7f);
618 t
->time
.tm_wday
= -1;
619 t
->time
.tm_mday
= bcd2bin(ald
[2] & 0x7f);
621 t
->time
.tm_year
= -1;
622 t
->time
.tm_yday
= -1;
623 t
->time
.tm_isdst
= -1;
625 dev_dbg(dev
, "%s, sec=%d min=%d hour=%d wday=%d mday=%d mon=%d enabled=%d\n",
626 __func__
, t
->time
.tm_sec
, t
->time
.tm_min
, t
->time
.tm_hour
,
627 t
->time
.tm_wday
, t
->time
.tm_mday
, t
->time
.tm_mon
, t
->enabled
);
632 static int rx8130_set_alarm(struct device
*dev
, struct rtc_wkalrm
*t
)
634 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
638 if (!test_bit(HAS_ALARM
, &ds1307
->flags
))
641 dev_dbg(dev
, "%s, sec=%d min=%d hour=%d wday=%d mday=%d mon=%d "
642 "enabled=%d pending=%d\n", __func__
,
643 t
->time
.tm_sec
, t
->time
.tm_min
, t
->time
.tm_hour
,
644 t
->time
.tm_wday
, t
->time
.tm_mday
, t
->time
.tm_mon
,
645 t
->enabled
, t
->pending
);
647 /* Read control registers. */
648 ret
= regmap_bulk_read(ds1307
->regmap
, RX8130_REG_EXTENSION
, ctl
,
653 ctl
[0] &= RX8130_REG_EXTENSION_WADA
;
654 ctl
[1] &= ~RX8130_REG_FLAG_AF
;
655 ctl
[2] &= ~RX8130_REG_CONTROL0_AIE
;
657 ret
= regmap_bulk_write(ds1307
->regmap
, RX8130_REG_EXTENSION
, ctl
,
662 /* Hardware alarm precision is 1 minute! */
663 ald
[0] = bin2bcd(t
->time
.tm_min
);
664 ald
[1] = bin2bcd(t
->time
.tm_hour
);
665 ald
[2] = bin2bcd(t
->time
.tm_mday
);
667 ret
= regmap_bulk_write(ds1307
->regmap
, RX8130_REG_ALARM_MIN
, ald
,
675 ctl
[2] |= RX8130_REG_CONTROL0_AIE
;
677 return regmap_write(ds1307
->regmap
, RX8130_REG_CONTROL0
, ctl
[2]);
680 static int rx8130_alarm_irq_enable(struct device
*dev
, unsigned int enabled
)
682 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
685 if (!test_bit(HAS_ALARM
, &ds1307
->flags
))
688 ret
= regmap_read(ds1307
->regmap
, RX8130_REG_CONTROL0
, ®
);
693 reg
|= RX8130_REG_CONTROL0_AIE
;
695 reg
&= ~RX8130_REG_CONTROL0_AIE
;
697 return regmap_write(ds1307
->regmap
, RX8130_REG_CONTROL0
, reg
);
700 static irqreturn_t
mcp794xx_irq(int irq
, void *dev_id
)
702 struct ds1307
*ds1307
= dev_id
;
703 struct mutex
*lock
= &ds1307
->rtc
->ops_lock
;
708 /* Check and clear alarm 0 interrupt flag. */
709 ret
= regmap_read(ds1307
->regmap
, MCP794XX_REG_ALARM0_CTRL
, ®
);
712 if (!(reg
& MCP794XX_BIT_ALMX_IF
))
714 reg
&= ~MCP794XX_BIT_ALMX_IF
;
715 ret
= regmap_write(ds1307
->regmap
, MCP794XX_REG_ALARM0_CTRL
, reg
);
719 /* Disable alarm 0. */
720 ret
= regmap_update_bits(ds1307
->regmap
, MCP794XX_REG_CONTROL
,
721 MCP794XX_BIT_ALM0_EN
, 0);
725 rtc_update_irq(ds1307
->rtc
, 1, RTC_AF
| RTC_IRQF
);
733 static int mcp794xx_read_alarm(struct device
*dev
, struct rtc_wkalrm
*t
)
735 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
739 if (!test_bit(HAS_ALARM
, &ds1307
->flags
))
742 /* Read control and alarm 0 registers. */
743 ret
= regmap_bulk_read(ds1307
->regmap
, MCP794XX_REG_CONTROL
, regs
,
748 t
->enabled
= !!(regs
[0] & MCP794XX_BIT_ALM0_EN
);
750 /* Report alarm 0 time assuming 24-hour and day-of-month modes. */
751 t
->time
.tm_sec
= bcd2bin(regs
[3] & 0x7f);
752 t
->time
.tm_min
= bcd2bin(regs
[4] & 0x7f);
753 t
->time
.tm_hour
= bcd2bin(regs
[5] & 0x3f);
754 t
->time
.tm_wday
= bcd2bin(regs
[6] & 0x7) - 1;
755 t
->time
.tm_mday
= bcd2bin(regs
[7] & 0x3f);
756 t
->time
.tm_mon
= bcd2bin(regs
[8] & 0x1f) - 1;
757 t
->time
.tm_year
= -1;
758 t
->time
.tm_yday
= -1;
759 t
->time
.tm_isdst
= -1;
761 dev_dbg(dev
, "%s, sec=%d min=%d hour=%d wday=%d mday=%d mon=%d "
762 "enabled=%d polarity=%d irq=%d match=%lu\n", __func__
,
763 t
->time
.tm_sec
, t
->time
.tm_min
, t
->time
.tm_hour
,
764 t
->time
.tm_wday
, t
->time
.tm_mday
, t
->time
.tm_mon
, t
->enabled
,
765 !!(regs
[6] & MCP794XX_BIT_ALMX_POL
),
766 !!(regs
[6] & MCP794XX_BIT_ALMX_IF
),
767 (regs
[6] & MCP794XX_MSK_ALMX_MATCH
) >> 4);
773 * We may have a random RTC weekday, therefore calculate alarm weekday based
774 * on current weekday we read from the RTC timekeeping regs
776 static int mcp794xx_alm_weekday(struct device
*dev
, struct rtc_time
*tm_alarm
)
778 struct rtc_time tm_now
;
779 int days_now
, days_alarm
, ret
;
781 ret
= ds1307_get_time(dev
, &tm_now
);
785 days_now
= div_s64(rtc_tm_to_time64(&tm_now
), 24 * 60 * 60);
786 days_alarm
= div_s64(rtc_tm_to_time64(tm_alarm
), 24 * 60 * 60);
788 return (tm_now
.tm_wday
+ days_alarm
- days_now
) % 7 + 1;
791 static int mcp794xx_set_alarm(struct device
*dev
, struct rtc_wkalrm
*t
)
793 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
794 unsigned char regs
[10];
797 if (!test_bit(HAS_ALARM
, &ds1307
->flags
))
800 wday
= mcp794xx_alm_weekday(dev
, &t
->time
);
804 dev_dbg(dev
, "%s, sec=%d min=%d hour=%d wday=%d mday=%d mon=%d "
805 "enabled=%d pending=%d\n", __func__
,
806 t
->time
.tm_sec
, t
->time
.tm_min
, t
->time
.tm_hour
,
807 t
->time
.tm_wday
, t
->time
.tm_mday
, t
->time
.tm_mon
,
808 t
->enabled
, t
->pending
);
810 /* Read control and alarm 0 registers. */
811 ret
= regmap_bulk_read(ds1307
->regmap
, MCP794XX_REG_CONTROL
, regs
,
816 /* Set alarm 0, using 24-hour and day-of-month modes. */
817 regs
[3] = bin2bcd(t
->time
.tm_sec
);
818 regs
[4] = bin2bcd(t
->time
.tm_min
);
819 regs
[5] = bin2bcd(t
->time
.tm_hour
);
821 regs
[7] = bin2bcd(t
->time
.tm_mday
);
822 regs
[8] = bin2bcd(t
->time
.tm_mon
+ 1);
824 /* Clear the alarm 0 interrupt flag. */
825 regs
[6] &= ~MCP794XX_BIT_ALMX_IF
;
826 /* Set alarm match: second, minute, hour, day, date, month. */
827 regs
[6] |= MCP794XX_MSK_ALMX_MATCH
;
828 /* Disable interrupt. We will not enable until completely programmed */
829 regs
[0] &= ~MCP794XX_BIT_ALM0_EN
;
831 ret
= regmap_bulk_write(ds1307
->regmap
, MCP794XX_REG_CONTROL
, regs
,
838 regs
[0] |= MCP794XX_BIT_ALM0_EN
;
839 return regmap_write(ds1307
->regmap
, MCP794XX_REG_CONTROL
, regs
[0]);
842 static int mcp794xx_alarm_irq_enable(struct device
*dev
, unsigned int enabled
)
844 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
846 if (!test_bit(HAS_ALARM
, &ds1307
->flags
))
849 return regmap_update_bits(ds1307
->regmap
, MCP794XX_REG_CONTROL
,
850 MCP794XX_BIT_ALM0_EN
,
851 enabled
? MCP794XX_BIT_ALM0_EN
: 0);
854 static int m41txx_rtc_read_offset(struct device
*dev
, long *offset
)
856 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
857 unsigned int ctrl_reg
;
860 regmap_read(ds1307
->regmap
, M41TXX_REG_CONTROL
, &ctrl_reg
);
862 val
= ctrl_reg
& M41TXX_M_CALIBRATION
;
864 /* check if positive */
865 if (ctrl_reg
& M41TXX_BIT_CALIB_SIGN
)
866 *offset
= (val
* M41TXX_POS_OFFSET_STEP_PPB
);
868 *offset
= -(val
* M41TXX_NEG_OFFSET_STEP_PPB
);
873 static int m41txx_rtc_set_offset(struct device
*dev
, long offset
)
875 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
876 unsigned int ctrl_reg
;
878 if ((offset
< M41TXX_MIN_OFFSET
) || (offset
> M41TXX_MAX_OFFSET
))
882 ctrl_reg
= DIV_ROUND_CLOSEST(offset
,
883 M41TXX_POS_OFFSET_STEP_PPB
);
884 ctrl_reg
|= M41TXX_BIT_CALIB_SIGN
;
886 ctrl_reg
= DIV_ROUND_CLOSEST(abs(offset
),
887 M41TXX_NEG_OFFSET_STEP_PPB
);
890 return regmap_update_bits(ds1307
->regmap
, M41TXX_REG_CONTROL
,
891 M41TXX_M_CALIBRATION
| M41TXX_BIT_CALIB_SIGN
,
895 #ifdef CONFIG_WATCHDOG_CORE
896 static int ds1388_wdt_start(struct watchdog_device
*wdt_dev
)
898 struct ds1307
*ds1307
= watchdog_get_drvdata(wdt_dev
);
902 ret
= regmap_update_bits(ds1307
->regmap
, DS1388_REG_FLAG
,
907 ret
= regmap_update_bits(ds1307
->regmap
, DS1388_REG_CONTROL
,
908 DS1388_BIT_WDE
| DS1388_BIT_RST
, 0);
913 * watchdog timeouts are measured in seconds. So ignore hundredths of
917 regs
[1] = bin2bcd(wdt_dev
->timeout
);
919 ret
= regmap_bulk_write(ds1307
->regmap
, DS1388_REG_WDOG_HUN_SECS
, regs
,
924 return regmap_update_bits(ds1307
->regmap
, DS1388_REG_CONTROL
,
925 DS1388_BIT_WDE
| DS1388_BIT_RST
,
926 DS1388_BIT_WDE
| DS1388_BIT_RST
);
929 static int ds1388_wdt_stop(struct watchdog_device
*wdt_dev
)
931 struct ds1307
*ds1307
= watchdog_get_drvdata(wdt_dev
);
933 return regmap_update_bits(ds1307
->regmap
, DS1388_REG_CONTROL
,
934 DS1388_BIT_WDE
| DS1388_BIT_RST
, 0);
937 static int ds1388_wdt_ping(struct watchdog_device
*wdt_dev
)
939 struct ds1307
*ds1307
= watchdog_get_drvdata(wdt_dev
);
942 return regmap_bulk_read(ds1307
->regmap
, DS1388_REG_WDOG_HUN_SECS
, regs
,
946 static int ds1388_wdt_set_timeout(struct watchdog_device
*wdt_dev
,
949 struct ds1307
*ds1307
= watchdog_get_drvdata(wdt_dev
);
952 wdt_dev
->timeout
= val
;
954 regs
[1] = bin2bcd(wdt_dev
->timeout
);
956 return regmap_bulk_write(ds1307
->regmap
, DS1388_REG_WDOG_HUN_SECS
, regs
,
961 static const struct rtc_class_ops rx8130_rtc_ops
= {
962 .read_time
= ds1307_get_time
,
963 .set_time
= ds1307_set_time
,
964 .read_alarm
= rx8130_read_alarm
,
965 .set_alarm
= rx8130_set_alarm
,
966 .alarm_irq_enable
= rx8130_alarm_irq_enable
,
969 static const struct rtc_class_ops mcp794xx_rtc_ops
= {
970 .read_time
= ds1307_get_time
,
971 .set_time
= ds1307_set_time
,
972 .read_alarm
= mcp794xx_read_alarm
,
973 .set_alarm
= mcp794xx_set_alarm
,
974 .alarm_irq_enable
= mcp794xx_alarm_irq_enable
,
977 static const struct rtc_class_ops m41txx_rtc_ops
= {
978 .read_time
= ds1307_get_time
,
979 .set_time
= ds1307_set_time
,
980 .read_alarm
= ds1337_read_alarm
,
981 .set_alarm
= ds1337_set_alarm
,
982 .alarm_irq_enable
= ds1307_alarm_irq_enable
,
983 .read_offset
= m41txx_rtc_read_offset
,
984 .set_offset
= m41txx_rtc_set_offset
,
987 static const struct chip_desc chips
[last_ds_type
] = {
998 .century_reg
= DS1307_REG_MONTH
,
999 .century_bit
= DS1337_BIT_CENTURY
,
1007 .century_reg
= DS1307_REG_MONTH
,
1008 .century_bit
= DS1337_BIT_CENTURY
,
1009 .bbsqi_bit
= DS1339_BIT_BBSQI
,
1010 .trickle_charger_reg
= 0x10,
1011 .do_trickle_setup
= &do_trickle_setup_ds1339
,
1012 .requires_trickle_resistor
= true,
1013 .charge_default
= true,
1016 .century_reg
= DS1307_REG_HOUR
,
1017 .century_enable_bit
= DS1340_BIT_CENTURY_EN
,
1018 .century_bit
= DS1340_BIT_CENTURY
,
1019 .do_trickle_setup
= &do_trickle_setup_ds1339
,
1020 .trickle_charger_reg
= 0x08,
1021 .requires_trickle_resistor
= true,
1022 .charge_default
= true,
1025 .century_reg
= DS1307_REG_MONTH
,
1026 .century_bit
= DS1337_BIT_CENTURY
,
1030 .trickle_charger_reg
= 0x0a,
1034 .century_reg
= DS1307_REG_MONTH
,
1035 .century_bit
= DS1337_BIT_CENTURY
,
1036 .bbsqi_bit
= DS3231_BIT_BBSQW
,
1040 /* this is battery backed SRAM */
1041 .nvram_offset
= 0x20,
1042 .nvram_size
= 4, /* 32bit (4 word x 8 bit) */
1044 .irq_handler
= rx8130_irq
,
1045 .rtc_ops
= &rx8130_rtc_ops
,
1046 .trickle_charger_reg
= RX8130_REG_CONTROL1
,
1047 .do_trickle_setup
= &do_trickle_setup_rx8130
,
1050 .rtc_ops
= &m41txx_rtc_ops
,
1053 .rtc_ops
= &m41txx_rtc_ops
,
1056 /* this is battery backed SRAM */
1059 .rtc_ops
= &m41txx_rtc_ops
,
1063 /* this is battery backed SRAM */
1064 .nvram_offset
= 0x20,
1066 .irq_handler
= mcp794xx_irq
,
1067 .rtc_ops
= &mcp794xx_rtc_ops
,
1071 static const struct i2c_device_id ds1307_id
[] = {
1072 { "ds1307", ds_1307
},
1073 { "ds1308", ds_1308
},
1074 { "ds1337", ds_1337
},
1075 { "ds1338", ds_1338
},
1076 { "ds1339", ds_1339
},
1077 { "ds1388", ds_1388
},
1078 { "ds1340", ds_1340
},
1079 { "ds1341", ds_1341
},
1080 { "ds3231", ds_3231
},
1082 { "m41t00", m41t00
},
1083 { "m41t11", m41t11
},
1084 { "mcp7940x", mcp794xx
},
1085 { "mcp7941x", mcp794xx
},
1086 { "pt7c4338", ds_1307
},
1087 { "rx8025", rx_8025
},
1088 { "isl12057", ds_1337
},
1089 { "rx8130", rx_8130
},
1092 MODULE_DEVICE_TABLE(i2c
, ds1307_id
);
1094 static const struct of_device_id ds1307_of_match
[] = {
1096 .compatible
= "dallas,ds1307",
1097 .data
= (void *)ds_1307
1100 .compatible
= "dallas,ds1308",
1101 .data
= (void *)ds_1308
1104 .compatible
= "dallas,ds1337",
1105 .data
= (void *)ds_1337
1108 .compatible
= "dallas,ds1338",
1109 .data
= (void *)ds_1338
1112 .compatible
= "dallas,ds1339",
1113 .data
= (void *)ds_1339
1116 .compatible
= "dallas,ds1388",
1117 .data
= (void *)ds_1388
1120 .compatible
= "dallas,ds1340",
1121 .data
= (void *)ds_1340
1124 .compatible
= "dallas,ds1341",
1125 .data
= (void *)ds_1341
1128 .compatible
= "maxim,ds3231",
1129 .data
= (void *)ds_3231
1132 .compatible
= "st,m41t0",
1133 .data
= (void *)m41t0
1136 .compatible
= "st,m41t00",
1137 .data
= (void *)m41t00
1140 .compatible
= "st,m41t11",
1141 .data
= (void *)m41t11
1144 .compatible
= "microchip,mcp7940x",
1145 .data
= (void *)mcp794xx
1148 .compatible
= "microchip,mcp7941x",
1149 .data
= (void *)mcp794xx
1152 .compatible
= "pericom,pt7c4338",
1153 .data
= (void *)ds_1307
1156 .compatible
= "epson,rx8025",
1157 .data
= (void *)rx_8025
1160 .compatible
= "isil,isl12057",
1161 .data
= (void *)ds_1337
1164 .compatible
= "epson,rx8130",
1165 .data
= (void *)rx_8130
1169 MODULE_DEVICE_TABLE(of
, ds1307_of_match
);
1172 * The ds1337 and ds1339 both have two alarms, but we only use the first
1173 * one (with a "seconds" field). For ds1337 we expect nINTA is our alarm
1174 * signal; ds1339 chips have only one alarm signal.
1176 static irqreturn_t
ds1307_irq(int irq
, void *dev_id
)
1178 struct ds1307
*ds1307
= dev_id
;
1179 struct mutex
*lock
= &ds1307
->rtc
->ops_lock
;
1183 ret
= regmap_read(ds1307
->regmap
, DS1337_REG_STATUS
, &stat
);
1187 if (stat
& DS1337_BIT_A1I
) {
1188 stat
&= ~DS1337_BIT_A1I
;
1189 regmap_write(ds1307
->regmap
, DS1337_REG_STATUS
, stat
);
1191 ret
= regmap_update_bits(ds1307
->regmap
, DS1337_REG_CONTROL
,
1192 DS1337_BIT_A1IE
, 0);
1196 rtc_update_irq(ds1307
->rtc
, 1, RTC_AF
| RTC_IRQF
);
1205 /*----------------------------------------------------------------------*/
1207 static const struct rtc_class_ops ds13xx_rtc_ops
= {
1208 .read_time
= ds1307_get_time
,
1209 .set_time
= ds1307_set_time
,
1210 .read_alarm
= ds1337_read_alarm
,
1211 .set_alarm
= ds1337_set_alarm
,
1212 .alarm_irq_enable
= ds1307_alarm_irq_enable
,
1215 static ssize_t
frequency_test_store(struct device
*dev
,
1216 struct device_attribute
*attr
,
1217 const char *buf
, size_t count
)
1219 struct ds1307
*ds1307
= dev_get_drvdata(dev
->parent
);
1223 ret
= kstrtobool(buf
, &freq_test_en
);
1225 dev_err(dev
, "Failed to store RTC Frequency Test attribute\n");
1229 regmap_update_bits(ds1307
->regmap
, M41TXX_REG_CONTROL
, M41TXX_BIT_FT
,
1230 freq_test_en
? M41TXX_BIT_FT
: 0);
1235 static ssize_t
frequency_test_show(struct device
*dev
,
1236 struct device_attribute
*attr
,
1239 struct ds1307
*ds1307
= dev_get_drvdata(dev
->parent
);
1240 unsigned int ctrl_reg
;
1242 regmap_read(ds1307
->regmap
, M41TXX_REG_CONTROL
, &ctrl_reg
);
1244 return scnprintf(buf
, PAGE_SIZE
, (ctrl_reg
& M41TXX_BIT_FT
) ? "on\n" :
1248 static DEVICE_ATTR_RW(frequency_test
);
1250 static struct attribute
*rtc_freq_test_attrs
[] = {
1251 &dev_attr_frequency_test
.attr
,
1255 static const struct attribute_group rtc_freq_test_attr_group
= {
1256 .attrs
= rtc_freq_test_attrs
,
1259 static int ds1307_add_frequency_test(struct ds1307
*ds1307
)
1263 switch (ds1307
->type
) {
1267 err
= rtc_add_group(ds1307
->rtc
, &rtc_freq_test_attr_group
);
1278 /*----------------------------------------------------------------------*/
1280 static int ds1307_nvram_read(void *priv
, unsigned int offset
, void *val
,
1283 struct ds1307
*ds1307
= priv
;
1284 const struct chip_desc
*chip
= &chips
[ds1307
->type
];
1286 return regmap_bulk_read(ds1307
->regmap
, chip
->nvram_offset
+ offset
,
1290 static int ds1307_nvram_write(void *priv
, unsigned int offset
, void *val
,
1293 struct ds1307
*ds1307
= priv
;
1294 const struct chip_desc
*chip
= &chips
[ds1307
->type
];
1296 return regmap_bulk_write(ds1307
->regmap
, chip
->nvram_offset
+ offset
,
1300 /*----------------------------------------------------------------------*/
1302 static u8
ds1307_trickle_init(struct ds1307
*ds1307
,
1303 const struct chip_desc
*chip
)
1305 u32 ohms
, chargeable
;
1306 bool diode
= chip
->charge_default
;
1308 if (!chip
->do_trickle_setup
)
1311 if (device_property_read_u32(ds1307
->dev
, "trickle-resistor-ohms",
1312 &ohms
) && chip
->requires_trickle_resistor
)
1315 /* aux-voltage-chargeable takes precedence over the deprecated
1316 * trickle-diode-disable
1318 if (!device_property_read_u32(ds1307
->dev
, "aux-voltage-chargeable",
1320 switch (chargeable
) {
1328 dev_warn(ds1307
->dev
,
1329 "unsupported aux-voltage-chargeable value\n");
1332 } else if (device_property_read_bool(ds1307
->dev
,
1333 "trickle-diode-disable")) {
1337 return chip
->do_trickle_setup(ds1307
, ohms
, diode
);
1340 /*----------------------------------------------------------------------*/
1342 #if IS_REACHABLE(CONFIG_HWMON)
1345 * Temperature sensor support for ds3231 devices.
1348 #define DS3231_REG_TEMPERATURE 0x11
1351 * A user-initiated temperature conversion is not started by this function,
1352 * so the temperature is updated once every 64 seconds.
1354 static int ds3231_hwmon_read_temp(struct device
*dev
, s32
*mC
)
1356 struct ds1307
*ds1307
= dev_get_drvdata(dev
);
1361 ret
= regmap_bulk_read(ds1307
->regmap
, DS3231_REG_TEMPERATURE
,
1362 temp_buf
, sizeof(temp_buf
));
1366 * Temperature is represented as a 10-bit code with a resolution of
1367 * 0.25 degree celsius and encoded in two's complement format.
1369 temp
= (temp_buf
[0] << 8) | temp_buf
[1];
1376 static ssize_t
ds3231_hwmon_show_temp(struct device
*dev
,
1377 struct device_attribute
*attr
, char *buf
)
1382 ret
= ds3231_hwmon_read_temp(dev
, &temp
);
1386 return sprintf(buf
, "%d\n", temp
);
1388 static SENSOR_DEVICE_ATTR(temp1_input
, 0444, ds3231_hwmon_show_temp
,
1391 static struct attribute
*ds3231_hwmon_attrs
[] = {
1392 &sensor_dev_attr_temp1_input
.dev_attr
.attr
,
1395 ATTRIBUTE_GROUPS(ds3231_hwmon
);
1397 static void ds1307_hwmon_register(struct ds1307
*ds1307
)
1401 if (ds1307
->type
!= ds_3231
)
1404 dev
= devm_hwmon_device_register_with_groups(ds1307
->dev
, ds1307
->name
,
1406 ds3231_hwmon_groups
);
1408 dev_warn(ds1307
->dev
, "unable to register hwmon device %ld\n",
1415 static void ds1307_hwmon_register(struct ds1307
*ds1307
)
1419 #endif /* CONFIG_RTC_DRV_DS1307_HWMON */
1421 /*----------------------------------------------------------------------*/
1424 * Square-wave output support for DS3231
1425 * Datasheet: https://datasheets.maximintegrated.com/en/ds/DS3231.pdf
1427 #ifdef CONFIG_COMMON_CLK
1434 #define clk_sqw_to_ds1307(clk) \
1435 container_of(clk, struct ds1307, clks[DS3231_CLK_SQW])
1436 #define clk_32khz_to_ds1307(clk) \
1437 container_of(clk, struct ds1307, clks[DS3231_CLK_32KHZ])
1439 static int ds3231_clk_sqw_rates
[] = {
1446 static int ds1337_write_control(struct ds1307
*ds1307
, u8 mask
, u8 value
)
1448 struct mutex
*lock
= &ds1307
->rtc
->ops_lock
;
1452 ret
= regmap_update_bits(ds1307
->regmap
, DS1337_REG_CONTROL
,
1459 static unsigned long ds3231_clk_sqw_recalc_rate(struct clk_hw
*hw
,
1460 unsigned long parent_rate
)
1462 struct ds1307
*ds1307
= clk_sqw_to_ds1307(hw
);
1466 ret
= regmap_read(ds1307
->regmap
, DS1337_REG_CONTROL
, &control
);
1469 if (control
& DS1337_BIT_RS1
)
1471 if (control
& DS1337_BIT_RS2
)
1474 return ds3231_clk_sqw_rates
[rate_sel
];
1477 static long ds3231_clk_sqw_round_rate(struct clk_hw
*hw
, unsigned long rate
,
1478 unsigned long *prate
)
1482 for (i
= ARRAY_SIZE(ds3231_clk_sqw_rates
) - 1; i
>= 0; i
--) {
1483 if (ds3231_clk_sqw_rates
[i
] <= rate
)
1484 return ds3231_clk_sqw_rates
[i
];
1490 static int ds3231_clk_sqw_set_rate(struct clk_hw
*hw
, unsigned long rate
,
1491 unsigned long parent_rate
)
1493 struct ds1307
*ds1307
= clk_sqw_to_ds1307(hw
);
1497 for (rate_sel
= 0; rate_sel
< ARRAY_SIZE(ds3231_clk_sqw_rates
);
1499 if (ds3231_clk_sqw_rates
[rate_sel
] == rate
)
1503 if (rate_sel
== ARRAY_SIZE(ds3231_clk_sqw_rates
))
1507 control
|= DS1337_BIT_RS1
;
1509 control
|= DS1337_BIT_RS2
;
1511 return ds1337_write_control(ds1307
, DS1337_BIT_RS1
| DS1337_BIT_RS2
,
1515 static int ds3231_clk_sqw_prepare(struct clk_hw
*hw
)
1517 struct ds1307
*ds1307
= clk_sqw_to_ds1307(hw
);
1519 return ds1337_write_control(ds1307
, DS1337_BIT_INTCN
, 0);
1522 static void ds3231_clk_sqw_unprepare(struct clk_hw
*hw
)
1524 struct ds1307
*ds1307
= clk_sqw_to_ds1307(hw
);
1526 ds1337_write_control(ds1307
, DS1337_BIT_INTCN
, DS1337_BIT_INTCN
);
1529 static int ds3231_clk_sqw_is_prepared(struct clk_hw
*hw
)
1531 struct ds1307
*ds1307
= clk_sqw_to_ds1307(hw
);
1534 ret
= regmap_read(ds1307
->regmap
, DS1337_REG_CONTROL
, &control
);
1538 return !(control
& DS1337_BIT_INTCN
);
1541 static const struct clk_ops ds3231_clk_sqw_ops
= {
1542 .prepare
= ds3231_clk_sqw_prepare
,
1543 .unprepare
= ds3231_clk_sqw_unprepare
,
1544 .is_prepared
= ds3231_clk_sqw_is_prepared
,
1545 .recalc_rate
= ds3231_clk_sqw_recalc_rate
,
1546 .round_rate
= ds3231_clk_sqw_round_rate
,
1547 .set_rate
= ds3231_clk_sqw_set_rate
,
1550 static unsigned long ds3231_clk_32khz_recalc_rate(struct clk_hw
*hw
,
1551 unsigned long parent_rate
)
1556 static int ds3231_clk_32khz_control(struct ds1307
*ds1307
, bool enable
)
1558 struct mutex
*lock
= &ds1307
->rtc
->ops_lock
;
1562 ret
= regmap_update_bits(ds1307
->regmap
, DS1337_REG_STATUS
,
1564 enable
? DS3231_BIT_EN32KHZ
: 0);
1570 static int ds3231_clk_32khz_prepare(struct clk_hw
*hw
)
1572 struct ds1307
*ds1307
= clk_32khz_to_ds1307(hw
);
1574 return ds3231_clk_32khz_control(ds1307
, true);
1577 static void ds3231_clk_32khz_unprepare(struct clk_hw
*hw
)
1579 struct ds1307
*ds1307
= clk_32khz_to_ds1307(hw
);
1581 ds3231_clk_32khz_control(ds1307
, false);
1584 static int ds3231_clk_32khz_is_prepared(struct clk_hw
*hw
)
1586 struct ds1307
*ds1307
= clk_32khz_to_ds1307(hw
);
1589 ret
= regmap_read(ds1307
->regmap
, DS1337_REG_STATUS
, &status
);
1593 return !!(status
& DS3231_BIT_EN32KHZ
);
1596 static const struct clk_ops ds3231_clk_32khz_ops
= {
1597 .prepare
= ds3231_clk_32khz_prepare
,
1598 .unprepare
= ds3231_clk_32khz_unprepare
,
1599 .is_prepared
= ds3231_clk_32khz_is_prepared
,
1600 .recalc_rate
= ds3231_clk_32khz_recalc_rate
,
1603 static const char *ds3231_clks_names
[] = {
1604 [DS3231_CLK_SQW
] = "ds3231_clk_sqw",
1605 [DS3231_CLK_32KHZ
] = "ds3231_clk_32khz",
1608 static struct clk_init_data ds3231_clks_init
[] = {
1609 [DS3231_CLK_SQW
] = {
1610 .ops
= &ds3231_clk_sqw_ops
,
1612 [DS3231_CLK_32KHZ
] = {
1613 .ops
= &ds3231_clk_32khz_ops
,
1617 static int ds3231_clks_register(struct ds1307
*ds1307
)
1619 struct device_node
*node
= ds1307
->dev
->of_node
;
1620 struct clk_onecell_data
*onecell
;
1623 onecell
= devm_kzalloc(ds1307
->dev
, sizeof(*onecell
), GFP_KERNEL
);
1627 onecell
->clk_num
= ARRAY_SIZE(ds3231_clks_init
);
1628 onecell
->clks
= devm_kcalloc(ds1307
->dev
, onecell
->clk_num
,
1629 sizeof(onecell
->clks
[0]), GFP_KERNEL
);
1633 /* optional override of the clockname */
1634 device_property_read_string_array(ds1307
->dev
, "clock-output-names",
1636 ARRAY_SIZE(ds3231_clks_names
));
1638 for (i
= 0; i
< ARRAY_SIZE(ds3231_clks_init
); i
++) {
1639 struct clk_init_data init
= ds3231_clks_init
[i
];
1642 * Interrupt signal due to alarm conditions and square-wave
1643 * output share same pin, so don't initialize both.
1645 if (i
== DS3231_CLK_SQW
&& test_bit(HAS_ALARM
, &ds1307
->flags
))
1648 init
.name
= ds3231_clks_names
[i
];
1649 ds1307
->clks
[i
].init
= &init
;
1651 onecell
->clks
[i
] = devm_clk_register(ds1307
->dev
,
1653 if (IS_ERR(onecell
->clks
[i
]))
1654 return PTR_ERR(onecell
->clks
[i
]);
1658 of_clk_add_provider(node
, of_clk_src_onecell_get
, onecell
);
1663 static void ds1307_clks_register(struct ds1307
*ds1307
)
1667 if (ds1307
->type
!= ds_3231
)
1670 ret
= ds3231_clks_register(ds1307
);
1672 dev_warn(ds1307
->dev
, "unable to register clock device %d\n",
1679 static void ds1307_clks_register(struct ds1307
*ds1307
)
1683 #endif /* CONFIG_COMMON_CLK */
1685 #ifdef CONFIG_WATCHDOG_CORE
1686 static const struct watchdog_info ds1388_wdt_info
= {
1687 .options
= WDIOF_SETTIMEOUT
| WDIOF_KEEPALIVEPING
| WDIOF_MAGICCLOSE
,
1688 .identity
= "DS1388 watchdog",
1691 static const struct watchdog_ops ds1388_wdt_ops
= {
1692 .owner
= THIS_MODULE
,
1693 .start
= ds1388_wdt_start
,
1694 .stop
= ds1388_wdt_stop
,
1695 .ping
= ds1388_wdt_ping
,
1696 .set_timeout
= ds1388_wdt_set_timeout
,
1700 static void ds1307_wdt_register(struct ds1307
*ds1307
)
1702 struct watchdog_device
*wdt
;
1706 if (ds1307
->type
!= ds_1388
)
1709 wdt
= devm_kzalloc(ds1307
->dev
, sizeof(*wdt
), GFP_KERNEL
);
1713 err
= regmap_read(ds1307
->regmap
, DS1388_REG_FLAG
, &val
);
1714 if (!err
&& val
& DS1388_BIT_WF
)
1715 wdt
->bootstatus
= WDIOF_CARDRESET
;
1717 wdt
->info
= &ds1388_wdt_info
;
1718 wdt
->ops
= &ds1388_wdt_ops
;
1720 wdt
->max_timeout
= 99;
1721 wdt
->min_timeout
= 1;
1723 watchdog_init_timeout(wdt
, 0, ds1307
->dev
);
1724 watchdog_set_drvdata(wdt
, ds1307
);
1725 devm_watchdog_register_device(ds1307
->dev
, wdt
);
1728 static void ds1307_wdt_register(struct ds1307
*ds1307
)
1731 #endif /* CONFIG_WATCHDOG_CORE */
1733 static const struct regmap_config regmap_config
= {
1738 static int ds1307_probe(struct i2c_client
*client
,
1739 const struct i2c_device_id
*id
)
1741 struct ds1307
*ds1307
;
1745 const struct chip_desc
*chip
;
1747 bool ds1307_can_wakeup_device
= false;
1748 unsigned char regs
[8];
1749 struct ds1307_platform_data
*pdata
= dev_get_platdata(&client
->dev
);
1750 u8 trickle_charger_setup
= 0;
1752 ds1307
= devm_kzalloc(&client
->dev
, sizeof(struct ds1307
), GFP_KERNEL
);
1756 dev_set_drvdata(&client
->dev
, ds1307
);
1757 ds1307
->dev
= &client
->dev
;
1758 ds1307
->name
= client
->name
;
1760 ds1307
->regmap
= devm_regmap_init_i2c(client
, ®map_config
);
1761 if (IS_ERR(ds1307
->regmap
)) {
1762 dev_err(ds1307
->dev
, "regmap allocation failed\n");
1763 return PTR_ERR(ds1307
->regmap
);
1766 i2c_set_clientdata(client
, ds1307
);
1768 match
= device_get_match_data(&client
->dev
);
1770 ds1307
->type
= (enum ds_type
)match
;
1771 chip
= &chips
[ds1307
->type
];
1773 chip
= &chips
[id
->driver_data
];
1774 ds1307
->type
= id
->driver_data
;
1779 want_irq
= client
->irq
> 0 && chip
->alarm
;
1782 trickle_charger_setup
= ds1307_trickle_init(ds1307
, chip
);
1783 else if (pdata
->trickle_charger_setup
)
1784 trickle_charger_setup
= pdata
->trickle_charger_setup
;
1786 if (trickle_charger_setup
&& chip
->trickle_charger_reg
) {
1787 dev_dbg(ds1307
->dev
,
1788 "writing trickle charger info 0x%x to 0x%x\n",
1789 trickle_charger_setup
, chip
->trickle_charger_reg
);
1790 regmap_write(ds1307
->regmap
, chip
->trickle_charger_reg
,
1791 trickle_charger_setup
);
1795 * For devices with no IRQ directly connected to the SoC, the RTC chip
1796 * can be forced as a wakeup source by stating that explicitly in
1797 * the device's .dts file using the "wakeup-source" boolean property.
1798 * If the "wakeup-source" property is set, don't request an IRQ.
1799 * This will guarantee the 'wakealarm' sysfs entry is available on the device,
1800 * if supported by the RTC.
1802 if (chip
->alarm
&& device_property_read_bool(&client
->dev
, "wakeup-source"))
1803 ds1307_can_wakeup_device
= true;
1805 switch (ds1307
->type
) {
1810 /* get registers that the "rtc" read below won't read... */
1811 err
= regmap_bulk_read(ds1307
->regmap
, DS1337_REG_CONTROL
,
1814 dev_dbg(ds1307
->dev
, "read error %d\n", err
);
1818 /* oscillator off? turn it on, so clock can tick. */
1819 if (regs
[0] & DS1337_BIT_nEOSC
)
1820 regs
[0] &= ~DS1337_BIT_nEOSC
;
1823 * Using IRQ or defined as wakeup-source?
1824 * Disable the square wave and both alarms.
1825 * For some variants, be sure alarms can trigger when we're
1826 * running on Vbackup (BBSQI/BBSQW)
1828 if (want_irq
|| ds1307_can_wakeup_device
) {
1829 regs
[0] |= DS1337_BIT_INTCN
| chip
->bbsqi_bit
;
1830 regs
[0] &= ~(DS1337_BIT_A2IE
| DS1337_BIT_A1IE
);
1833 regmap_write(ds1307
->regmap
, DS1337_REG_CONTROL
,
1836 /* oscillator fault? clear flag, and warn */
1837 if (regs
[1] & DS1337_BIT_OSF
) {
1838 regmap_write(ds1307
->regmap
, DS1337_REG_STATUS
,
1839 regs
[1] & ~DS1337_BIT_OSF
);
1840 dev_warn(ds1307
->dev
, "SET TIME!\n");
1845 err
= regmap_bulk_read(ds1307
->regmap
,
1846 RX8025_REG_CTRL1
<< 4 | 0x08, regs
, 2);
1848 dev_dbg(ds1307
->dev
, "read error %d\n", err
);
1852 /* oscillator off? turn it on, so clock can tick. */
1853 if (!(regs
[1] & RX8025_BIT_XST
)) {
1854 regs
[1] |= RX8025_BIT_XST
;
1855 regmap_write(ds1307
->regmap
,
1856 RX8025_REG_CTRL2
<< 4 | 0x08,
1858 dev_warn(ds1307
->dev
,
1859 "oscillator stop detected - SET TIME!\n");
1862 if (regs
[1] & RX8025_BIT_PON
) {
1863 regs
[1] &= ~RX8025_BIT_PON
;
1864 regmap_write(ds1307
->regmap
,
1865 RX8025_REG_CTRL2
<< 4 | 0x08,
1867 dev_warn(ds1307
->dev
, "power-on detected\n");
1870 if (regs
[1] & RX8025_BIT_VDET
) {
1871 regs
[1] &= ~RX8025_BIT_VDET
;
1872 regmap_write(ds1307
->regmap
,
1873 RX8025_REG_CTRL2
<< 4 | 0x08,
1875 dev_warn(ds1307
->dev
, "voltage drop detected\n");
1878 /* make sure we are running in 24hour mode */
1879 if (!(regs
[0] & RX8025_BIT_2412
)) {
1882 /* switch to 24 hour mode */
1883 regmap_write(ds1307
->regmap
,
1884 RX8025_REG_CTRL1
<< 4 | 0x08,
1885 regs
[0] | RX8025_BIT_2412
);
1887 err
= regmap_bulk_read(ds1307
->regmap
,
1888 RX8025_REG_CTRL1
<< 4 | 0x08,
1891 dev_dbg(ds1307
->dev
, "read error %d\n", err
);
1896 hour
= bcd2bin(regs
[DS1307_REG_HOUR
]);
1899 if (regs
[DS1307_REG_HOUR
] & DS1307_BIT_PM
)
1902 regmap_write(ds1307
->regmap
,
1903 DS1307_REG_HOUR
<< 4 | 0x08, hour
);
1907 err
= regmap_read(ds1307
->regmap
, DS1388_REG_CONTROL
, &tmp
);
1909 dev_dbg(ds1307
->dev
, "read error %d\n", err
);
1913 /* oscillator off? turn it on, so clock can tick. */
1914 if (tmp
& DS1388_BIT_nEOSC
) {
1915 tmp
&= ~DS1388_BIT_nEOSC
;
1916 regmap_write(ds1307
->regmap
, DS1388_REG_CONTROL
, tmp
);
1923 /* read RTC registers */
1924 err
= regmap_bulk_read(ds1307
->regmap
, chip
->offset
, regs
,
1927 dev_dbg(ds1307
->dev
, "read error %d\n", err
);
1931 if (ds1307
->type
== mcp794xx
&&
1932 !(regs
[DS1307_REG_WDAY
] & MCP794XX_BIT_VBATEN
)) {
1933 regmap_write(ds1307
->regmap
, DS1307_REG_WDAY
,
1934 regs
[DS1307_REG_WDAY
] |
1935 MCP794XX_BIT_VBATEN
);
1938 tmp
= regs
[DS1307_REG_HOUR
];
1939 switch (ds1307
->type
) {
1945 * NOTE: ignores century bits; fix before deploying
1946 * systems that will run through year 2100.
1952 if (!(tmp
& DS1307_BIT_12HR
))
1956 * Be sure we're in 24 hour mode. Multi-master systems
1959 tmp
= bcd2bin(tmp
& 0x1f);
1962 if (regs
[DS1307_REG_HOUR
] & DS1307_BIT_PM
)
1964 regmap_write(ds1307
->regmap
, chip
->offset
+ DS1307_REG_HOUR
,
1968 if (want_irq
|| ds1307_can_wakeup_device
) {
1969 device_set_wakeup_capable(ds1307
->dev
, true);
1970 set_bit(HAS_ALARM
, &ds1307
->flags
);
1973 ds1307
->rtc
= devm_rtc_allocate_device(ds1307
->dev
);
1974 if (IS_ERR(ds1307
->rtc
))
1975 return PTR_ERR(ds1307
->rtc
);
1977 if (ds1307_can_wakeup_device
&& !want_irq
) {
1978 dev_info(ds1307
->dev
,
1979 "'wakeup-source' is set, request for an IRQ is disabled!\n");
1980 /* We cannot support UIE mode if we do not have an IRQ line */
1981 ds1307
->rtc
->uie_unsupported
= 1;
1985 err
= devm_request_threaded_irq(ds1307
->dev
, client
->irq
, NULL
,
1986 chip
->irq_handler
?: ds1307_irq
,
1987 IRQF_SHARED
| IRQF_ONESHOT
,
1988 ds1307
->name
, ds1307
);
1991 device_set_wakeup_capable(ds1307
->dev
, false);
1992 clear_bit(HAS_ALARM
, &ds1307
->flags
);
1993 dev_err(ds1307
->dev
, "unable to request IRQ!\n");
1995 dev_dbg(ds1307
->dev
, "got IRQ %d\n", client
->irq
);
1999 ds1307
->rtc
->ops
= chip
->rtc_ops
?: &ds13xx_rtc_ops
;
2000 err
= ds1307_add_frequency_test(ds1307
);
2004 err
= devm_rtc_register_device(ds1307
->rtc
);
2008 if (chip
->nvram_size
) {
2009 struct nvmem_config nvmem_cfg
= {
2010 .name
= "ds1307_nvram",
2013 .size
= chip
->nvram_size
,
2014 .reg_read
= ds1307_nvram_read
,
2015 .reg_write
= ds1307_nvram_write
,
2019 devm_rtc_nvmem_register(ds1307
->rtc
, &nvmem_cfg
);
2022 ds1307_hwmon_register(ds1307
);
2023 ds1307_clks_register(ds1307
);
2024 ds1307_wdt_register(ds1307
);
2032 static struct i2c_driver ds1307_driver
= {
2034 .name
= "rtc-ds1307",
2035 .of_match_table
= ds1307_of_match
,
2037 .probe
= ds1307_probe
,
2038 .id_table
= ds1307_id
,
2041 module_i2c_driver(ds1307_driver
);
2043 MODULE_DESCRIPTION("RTC driver for DS1307 and similar chips");
2044 MODULE_LICENSE("GPL");