2 * Driver for MediaTek SoC based RTC
4 * Copyright (C) 2017 Sean Wang <sean.wang@mediatek.com>
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License as
8 * published by the Free Software Foundation; either version 2 of
9 * the License, or (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
17 #include <linux/clk.h>
18 #include <linux/interrupt.h>
19 #include <linux/module.h>
20 #include <linux/of_address.h>
21 #include <linux/of_device.h>
22 #include <linux/platform_device.h>
23 #include <linux/rtc.h>
25 #define MTK_RTC_DEV KBUILD_MODNAME
27 #define MTK_RTC_PWRCHK1 0x4
28 #define RTC_PWRCHK1_MAGIC 0xc6
30 #define MTK_RTC_PWRCHK2 0x8
31 #define RTC_PWRCHK2_MAGIC 0x9a
33 #define MTK_RTC_KEY 0xc
34 #define RTC_KEY_MAGIC 0x59
36 #define MTK_RTC_PROT1 0x10
37 #define RTC_PROT1_MAGIC 0xa3
39 #define MTK_RTC_PROT2 0x14
40 #define RTC_PROT2_MAGIC 0x57
42 #define MTK_RTC_PROT3 0x18
43 #define RTC_PROT3_MAGIC 0x67
45 #define MTK_RTC_PROT4 0x1c
46 #define RTC_PROT4_MAGIC 0xd2
48 #define MTK_RTC_CTL 0x20
49 #define RTC_RC_STOP BIT(0)
51 #define MTK_RTC_DEBNCE 0x2c
52 #define RTC_DEBNCE_MASK GENMASK(2, 0)
54 #define MTK_RTC_INT 0x30
55 #define RTC_INT_AL_STA BIT(4)
58 * Ranges from 0x40 to 0x78 provide RTC time setup for year, month,
59 * day of month, day of week, hour, minute and second.
61 #define MTK_RTC_TREG(_t, _f) (0x40 + (0x4 * (_f)) + ((_t) * 0x20))
63 #define MTK_RTC_AL_CTL 0x7c
64 #define RTC_AL_EN BIT(0)
65 #define RTC_AL_ALL GENMASK(7, 0)
68 * The offset is used in the translation for the year between in struct
69 * rtc_time and in hardware register MTK_RTC_TREG(x,MTK_YEA)
71 #define MTK_RTC_TM_YR_OFFSET 100
74 * The lowest value for the valid tm_year. RTC hardware would take incorrectly
75 * tm_year 100 as not a leap year and thus it is also required being excluded
76 * from the valid options.
78 #define MTK_RTC_TM_YR_L (MTK_RTC_TM_YR_OFFSET + 1)
81 * The most year the RTC can hold is 99 and the next to 99 in year register
82 * would be wraparound to 0, for MT7622.
84 #define MTK_RTC_HW_YR_LIMIT 99
86 /* The highest value for the valid tm_year */
87 #define MTK_RTC_TM_YR_H (MTK_RTC_TM_YR_OFFSET + MTK_RTC_HW_YR_LIMIT)
89 /* Simple macro helps to check whether the hardware supports the tm_year */
90 #define MTK_RTC_TM_YR_VALID(_y) ((_y) >= MTK_RTC_TM_YR_L && \
91 (_y) <= MTK_RTC_TM_YR_H)
93 /* Types of the function the RTC provides are time counter and alarm. */
99 /* Indexes are used for the pointer to relevant registers in MTK_RTC_TREG */
111 struct rtc_device
*rtc
;
117 static void mtk_w32(struct mtk_rtc
*rtc
, u32 reg
, u32 val
)
119 writel_relaxed(val
, rtc
->base
+ reg
);
122 static u32
mtk_r32(struct mtk_rtc
*rtc
, u32 reg
)
124 return readl_relaxed(rtc
->base
+ reg
);
127 static void mtk_rmw(struct mtk_rtc
*rtc
, u32 reg
, u32 mask
, u32 set
)
131 val
= mtk_r32(rtc
, reg
);
134 mtk_w32(rtc
, reg
, val
);
137 static void mtk_set(struct mtk_rtc
*rtc
, u32 reg
, u32 val
)
139 mtk_rmw(rtc
, reg
, 0, val
);
142 static void mtk_clr(struct mtk_rtc
*rtc
, u32 reg
, u32 val
)
144 mtk_rmw(rtc
, reg
, val
, 0);
147 static void mtk_rtc_hw_init(struct mtk_rtc
*hw
)
149 /* The setup of the init sequence is for allowing RTC got to work */
150 mtk_w32(hw
, MTK_RTC_PWRCHK1
, RTC_PWRCHK1_MAGIC
);
151 mtk_w32(hw
, MTK_RTC_PWRCHK2
, RTC_PWRCHK2_MAGIC
);
152 mtk_w32(hw
, MTK_RTC_KEY
, RTC_KEY_MAGIC
);
153 mtk_w32(hw
, MTK_RTC_PROT1
, RTC_PROT1_MAGIC
);
154 mtk_w32(hw
, MTK_RTC_PROT2
, RTC_PROT2_MAGIC
);
155 mtk_w32(hw
, MTK_RTC_PROT3
, RTC_PROT3_MAGIC
);
156 mtk_w32(hw
, MTK_RTC_PROT4
, RTC_PROT4_MAGIC
);
157 mtk_rmw(hw
, MTK_RTC_DEBNCE
, RTC_DEBNCE_MASK
, 0);
158 mtk_clr(hw
, MTK_RTC_CTL
, RTC_RC_STOP
);
161 static void mtk_rtc_get_alarm_or_time(struct mtk_rtc
*hw
, struct rtc_time
*tm
,
164 u32 year
, mon
, mday
, wday
, hour
, min
, sec
;
167 * Read again until the field of the second is not changed which
168 * ensures all fields in the consistent state. Note that MTK_SEC must
169 * be read first. In this way, it guarantees the others remain not
170 * changed when the results for two MTK_SEC consecutive reads are same.
173 sec
= mtk_r32(hw
, MTK_RTC_TREG(time_alarm
, MTK_SEC
));
174 min
= mtk_r32(hw
, MTK_RTC_TREG(time_alarm
, MTK_MIN
));
175 hour
= mtk_r32(hw
, MTK_RTC_TREG(time_alarm
, MTK_HOU
));
176 wday
= mtk_r32(hw
, MTK_RTC_TREG(time_alarm
, MTK_DOW
));
177 mday
= mtk_r32(hw
, MTK_RTC_TREG(time_alarm
, MTK_DOM
));
178 mon
= mtk_r32(hw
, MTK_RTC_TREG(time_alarm
, MTK_MON
));
179 year
= mtk_r32(hw
, MTK_RTC_TREG(time_alarm
, MTK_YEA
));
180 } while (sec
!= mtk_r32(hw
, MTK_RTC_TREG(time_alarm
, MTK_SEC
)));
187 tm
->tm_mon
= mon
- 1;
189 /* Rebase to the absolute year which userspace queries */
190 tm
->tm_year
= year
+ MTK_RTC_TM_YR_OFFSET
;
193 static void mtk_rtc_set_alarm_or_time(struct mtk_rtc
*hw
, struct rtc_time
*tm
,
198 /* Rebase to the relative year which RTC hardware requires */
199 year
= tm
->tm_year
- MTK_RTC_TM_YR_OFFSET
;
201 mtk_w32(hw
, MTK_RTC_TREG(time_alarm
, MTK_YEA
), year
);
202 mtk_w32(hw
, MTK_RTC_TREG(time_alarm
, MTK_MON
), tm
->tm_mon
+ 1);
203 mtk_w32(hw
, MTK_RTC_TREG(time_alarm
, MTK_DOW
), tm
->tm_wday
);
204 mtk_w32(hw
, MTK_RTC_TREG(time_alarm
, MTK_DOM
), tm
->tm_mday
);
205 mtk_w32(hw
, MTK_RTC_TREG(time_alarm
, MTK_HOU
), tm
->tm_hour
);
206 mtk_w32(hw
, MTK_RTC_TREG(time_alarm
, MTK_MIN
), tm
->tm_min
);
207 mtk_w32(hw
, MTK_RTC_TREG(time_alarm
, MTK_SEC
), tm
->tm_sec
);
210 static irqreturn_t
mtk_rtc_alarmirq(int irq
, void *id
)
212 struct mtk_rtc
*hw
= (struct mtk_rtc
*)id
;
215 irq_sta
= mtk_r32(hw
, MTK_RTC_INT
);
216 if (irq_sta
& RTC_INT_AL_STA
) {
217 /* Stop alarm also implicitly disables the alarm interrupt */
218 mtk_w32(hw
, MTK_RTC_AL_CTL
, 0);
219 rtc_update_irq(hw
->rtc
, 1, RTC_IRQF
| RTC_AF
);
221 /* Ack alarm interrupt status */
222 mtk_w32(hw
, MTK_RTC_INT
, RTC_INT_AL_STA
);
229 static int mtk_rtc_gettime(struct device
*dev
, struct rtc_time
*tm
)
231 struct mtk_rtc
*hw
= dev_get_drvdata(dev
);
233 mtk_rtc_get_alarm_or_time(hw
, tm
, MTK_TC
);
238 static int mtk_rtc_settime(struct device
*dev
, struct rtc_time
*tm
)
240 struct mtk_rtc
*hw
= dev_get_drvdata(dev
);
242 if (!MTK_RTC_TM_YR_VALID(tm
->tm_year
))
245 /* Stop time counter before setting a new one*/
246 mtk_set(hw
, MTK_RTC_CTL
, RTC_RC_STOP
);
248 mtk_rtc_set_alarm_or_time(hw
, tm
, MTK_TC
);
250 /* Restart the time counter */
251 mtk_clr(hw
, MTK_RTC_CTL
, RTC_RC_STOP
);
256 static int mtk_rtc_getalarm(struct device
*dev
, struct rtc_wkalrm
*wkalrm
)
258 struct mtk_rtc
*hw
= dev_get_drvdata(dev
);
259 struct rtc_time
*alrm_tm
= &wkalrm
->time
;
261 mtk_rtc_get_alarm_or_time(hw
, alrm_tm
, MTK_AL
);
263 wkalrm
->enabled
= !!(mtk_r32(hw
, MTK_RTC_AL_CTL
) & RTC_AL_EN
);
264 wkalrm
->pending
= !!(mtk_r32(hw
, MTK_RTC_INT
) & RTC_INT_AL_STA
);
269 static int mtk_rtc_setalarm(struct device
*dev
, struct rtc_wkalrm
*wkalrm
)
271 struct mtk_rtc
*hw
= dev_get_drvdata(dev
);
272 struct rtc_time
*alrm_tm
= &wkalrm
->time
;
274 if (!MTK_RTC_TM_YR_VALID(alrm_tm
->tm_year
))
278 * Stop the alarm also implicitly including disables interrupt before
281 mtk_clr(hw
, MTK_RTC_AL_CTL
, RTC_AL_EN
);
284 * Avoid contention between mtk_rtc_setalarm and IRQ handler so that
285 * disabling the interrupt and awaiting for pending IRQ handler to
288 synchronize_irq(hw
->irq
);
290 mtk_rtc_set_alarm_or_time(hw
, alrm_tm
, MTK_AL
);
292 /* Restart the alarm with the new setup */
293 mtk_w32(hw
, MTK_RTC_AL_CTL
, RTC_AL_ALL
);
298 static const struct rtc_class_ops mtk_rtc_ops
= {
299 .read_time
= mtk_rtc_gettime
,
300 .set_time
= mtk_rtc_settime
,
301 .read_alarm
= mtk_rtc_getalarm
,
302 .set_alarm
= mtk_rtc_setalarm
,
305 static const struct of_device_id mtk_rtc_match
[] = {
306 { .compatible
= "mediatek,mt7622-rtc" },
307 { .compatible
= "mediatek,soc-rtc" },
310 MODULE_DEVICE_TABLE(of
, mtk_rtc_match
);
312 static int mtk_rtc_probe(struct platform_device
*pdev
)
315 struct resource
*res
;
318 hw
= devm_kzalloc(&pdev
->dev
, sizeof(*hw
), GFP_KERNEL
);
322 platform_set_drvdata(pdev
, hw
);
324 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
325 hw
->base
= devm_ioremap_resource(&pdev
->dev
, res
);
326 if (IS_ERR(hw
->base
))
327 return PTR_ERR(hw
->base
);
329 hw
->clk
= devm_clk_get(&pdev
->dev
, "rtc");
330 if (IS_ERR(hw
->clk
)) {
331 dev_err(&pdev
->dev
, "No clock\n");
332 return PTR_ERR(hw
->clk
);
335 ret
= clk_prepare_enable(hw
->clk
);
339 hw
->irq
= platform_get_irq(pdev
, 0);
341 dev_err(&pdev
->dev
, "No IRQ resource\n");
346 ret
= devm_request_irq(&pdev
->dev
, hw
->irq
, mtk_rtc_alarmirq
,
347 0, dev_name(&pdev
->dev
), hw
);
349 dev_err(&pdev
->dev
, "Can't request IRQ\n");
355 device_init_wakeup(&pdev
->dev
, true);
357 hw
->rtc
= devm_rtc_device_register(&pdev
->dev
, pdev
->name
,
358 &mtk_rtc_ops
, THIS_MODULE
);
359 if (IS_ERR(hw
->rtc
)) {
360 ret
= PTR_ERR(hw
->rtc
);
361 dev_err(&pdev
->dev
, "Unable to register device\n");
367 clk_disable_unprepare(hw
->clk
);
372 static int mtk_rtc_remove(struct platform_device
*pdev
)
374 struct mtk_rtc
*hw
= platform_get_drvdata(pdev
);
376 clk_disable_unprepare(hw
->clk
);
381 #ifdef CONFIG_PM_SLEEP
382 static int mtk_rtc_suspend(struct device
*dev
)
384 struct mtk_rtc
*hw
= dev_get_drvdata(dev
);
386 if (device_may_wakeup(dev
))
387 enable_irq_wake(hw
->irq
);
392 static int mtk_rtc_resume(struct device
*dev
)
394 struct mtk_rtc
*hw
= dev_get_drvdata(dev
);
396 if (device_may_wakeup(dev
))
397 disable_irq_wake(hw
->irq
);
402 static SIMPLE_DEV_PM_OPS(mtk_rtc_pm_ops
, mtk_rtc_suspend
, mtk_rtc_resume
);
404 #define MTK_RTC_PM_OPS (&mtk_rtc_pm_ops)
405 #else /* CONFIG_PM */
406 #define MTK_RTC_PM_OPS NULL
407 #endif /* CONFIG_PM */
409 static struct platform_driver mtk_rtc_driver
= {
410 .probe
= mtk_rtc_probe
,
411 .remove
= mtk_rtc_remove
,
414 .of_match_table
= mtk_rtc_match
,
415 .pm
= MTK_RTC_PM_OPS
,
419 module_platform_driver(mtk_rtc_driver
);
421 MODULE_DESCRIPTION("MediaTek SoC based RTC Driver");
422 MODULE_AUTHOR("Sean Wang <sean.wang@mediatek.com>");
423 MODULE_LICENSE("GPL");