2 * Copyright 2008-2009 Freescale Semiconductor, Inc. All Rights Reserved.
3 * Copyright 2010 Orex Computed Radiography
7 * The code contained herein is licensed under the GNU General Public
8 * License. You may obtain a copy of the GNU General Public License
9 * Version 2 or later at the following locations:
11 * http://www.opensource.org/licenses/gpl-license.html
12 * http://www.gnu.org/copyleft/gpl.html
15 /* based on rtc-mc13892.c */
18 * This driver uses the 47-bit 32 kHz counter in the Freescale DryIce block
19 * to implement a Linux RTC. Times and alarms are truncated to seconds.
20 * Since the RTC framework performs API locking via rtc->ops_lock the
21 * only simultaneous accesses we need to deal with is updating DryIce
22 * registers while servicing an alarm.
24 * Note that reading the DSR (DryIce Status Register) automatically clears
25 * the WCF (Write Complete Flag). All DryIce writes are synchronized to the
26 * LP (Low Power) domain and set the WCF upon completion. Writes to the
27 * DIER (DryIce Interrupt Enable Register) are the only exception. These
28 * occur at normal bus speeds and do not set WCF. Periodic interrupts are
29 * not supported by the hardware.
33 #include <linux/clk.h>
34 #include <linux/delay.h>
35 #include <linux/module.h>
36 #include <linux/platform_device.h>
37 #include <linux/rtc.h>
38 #include <linux/sched.h>
39 #include <linux/workqueue.h>
41 /* DryIce Register Definitions */
43 #define DTCMR 0x00 /* Time Counter MSB Reg */
44 #define DTCLR 0x04 /* Time Counter LSB Reg */
46 #define DCAMR 0x08 /* Clock Alarm MSB Reg */
47 #define DCALR 0x0c /* Clock Alarm LSB Reg */
48 #define DCAMR_UNSET 0xFFFFFFFF /* doomsday - 1 sec */
50 #define DCR 0x10 /* Control Reg */
51 #define DCR_TCE (1 << 3) /* Time Counter Enable */
53 #define DSR 0x14 /* Status Reg */
54 #define DSR_WBF (1 << 10) /* Write Busy Flag */
55 #define DSR_WNF (1 << 9) /* Write Next Flag */
56 #define DSR_WCF (1 << 8) /* Write Complete Flag */
57 #define DSR_WEF (1 << 7) /* Write Error Flag */
58 #define DSR_CAF (1 << 4) /* Clock Alarm Flag */
59 #define DSR_NVF (1 << 1) /* Non-Valid Flag */
60 #define DSR_SVF (1 << 0) /* Security Violation Flag */
62 #define DIER 0x18 /* Interrupt Enable Reg */
63 #define DIER_WNIE (1 << 9) /* Write Next Interrupt Enable */
64 #define DIER_WCIE (1 << 8) /* Write Complete Interrupt Enable */
65 #define DIER_WEIE (1 << 7) /* Write Error Interrupt Enable */
66 #define DIER_CAIE (1 << 4) /* Clock Alarm Interrupt Enable */
69 * struct imxdi_dev - private imxdi rtc data
70 * @pdev: pionter to platform dev
71 * @rtc: pointer to rtc struct
72 * @ioaddr: IO registers pointer
73 * @irq: dryice normal interrupt
74 * @clk: input reference clock
75 * @dsr: copy of the DSR register
76 * @irq_lock: interrupt enable register (DIER) lock
77 * @write_wait: registers write complete queue
78 * @write_mutex: serialize registers write
79 * @work: schedule alarm work
82 struct platform_device
*pdev
;
83 struct rtc_device
*rtc
;
89 wait_queue_head_t write_wait
;
90 struct mutex write_mutex
;
91 struct work_struct work
;
95 * enable a dryice interrupt
97 static void di_int_enable(struct imxdi_dev
*imxdi
, u32 intr
)
101 spin_lock_irqsave(&imxdi
->irq_lock
, flags
);
102 __raw_writel(__raw_readl(imxdi
->ioaddr
+ DIER
) | intr
,
103 imxdi
->ioaddr
+ DIER
);
104 spin_unlock_irqrestore(&imxdi
->irq_lock
, flags
);
108 * disable a dryice interrupt
110 static void di_int_disable(struct imxdi_dev
*imxdi
, u32 intr
)
114 spin_lock_irqsave(&imxdi
->irq_lock
, flags
);
115 __raw_writel(__raw_readl(imxdi
->ioaddr
+ DIER
) & ~intr
,
116 imxdi
->ioaddr
+ DIER
);
117 spin_unlock_irqrestore(&imxdi
->irq_lock
, flags
);
121 * This function attempts to clear the dryice write-error flag.
123 * A dryice write error is similar to a bus fault and should not occur in
124 * normal operation. Clearing the flag requires another write, so the root
125 * cause of the problem may need to be fixed before the flag can be cleared.
127 static void clear_write_error(struct imxdi_dev
*imxdi
)
131 dev_warn(&imxdi
->pdev
->dev
, "WARNING: Register write error!\n");
133 /* clear the write error flag */
134 __raw_writel(DSR_WEF
, imxdi
->ioaddr
+ DSR
);
136 /* wait for it to take effect */
137 for (cnt
= 0; cnt
< 1000; cnt
++) {
138 if ((__raw_readl(imxdi
->ioaddr
+ DSR
) & DSR_WEF
) == 0)
142 dev_err(&imxdi
->pdev
->dev
,
143 "ERROR: Cannot clear write-error flag!\n");
147 * Write a dryice register and wait until it completes.
149 * This function uses interrupts to determine when the
150 * write has completed.
152 static int di_write_wait(struct imxdi_dev
*imxdi
, u32 val
, int reg
)
157 /* serialize register writes */
158 mutex_lock(&imxdi
->write_mutex
);
160 /* enable the write-complete interrupt */
161 di_int_enable(imxdi
, DIER_WCIE
);
165 /* do the register write */
166 __raw_writel(val
, imxdi
->ioaddr
+ reg
);
168 /* wait for the write to finish */
169 ret
= wait_event_interruptible_timeout(imxdi
->write_wait
,
170 imxdi
->dsr
& (DSR_WCF
| DSR_WEF
), msecs_to_jiffies(1));
174 } else if (ret
== 0) {
175 dev_warn(&imxdi
->pdev
->dev
,
176 "Write-wait timeout "
177 "val = 0x%08x reg = 0x%08x\n", val
, reg
);
180 /* check for write error */
181 if (imxdi
->dsr
& DSR_WEF
) {
182 clear_write_error(imxdi
);
187 mutex_unlock(&imxdi
->write_mutex
);
193 * read the seconds portion of the current time from the dryice time counter
195 static int dryice_rtc_read_time(struct device
*dev
, struct rtc_time
*tm
)
197 struct imxdi_dev
*imxdi
= dev_get_drvdata(dev
);
200 now
= __raw_readl(imxdi
->ioaddr
+ DTCMR
);
201 rtc_time_to_tm(now
, tm
);
207 * set the seconds portion of dryice time counter and clear the
210 static int dryice_rtc_set_mmss(struct device
*dev
, unsigned long secs
)
212 struct imxdi_dev
*imxdi
= dev_get_drvdata(dev
);
215 /* zero the fractional part first */
216 rc
= di_write_wait(imxdi
, 0, DTCLR
);
218 rc
= di_write_wait(imxdi
, secs
, DTCMR
);
223 static int dryice_rtc_alarm_irq_enable(struct device
*dev
,
224 unsigned int enabled
)
226 struct imxdi_dev
*imxdi
= dev_get_drvdata(dev
);
229 di_int_enable(imxdi
, DIER_CAIE
);
231 di_int_disable(imxdi
, DIER_CAIE
);
237 * read the seconds portion of the alarm register.
238 * the fractional part of the alarm register is always zero.
240 static int dryice_rtc_read_alarm(struct device
*dev
, struct rtc_wkalrm
*alarm
)
242 struct imxdi_dev
*imxdi
= dev_get_drvdata(dev
);
245 dcamr
= __raw_readl(imxdi
->ioaddr
+ DCAMR
);
246 rtc_time_to_tm(dcamr
, &alarm
->time
);
248 /* alarm is enabled if the interrupt is enabled */
249 alarm
->enabled
= (__raw_readl(imxdi
->ioaddr
+ DIER
) & DIER_CAIE
) != 0;
251 /* don't allow the DSR read to mess up DSR_WCF */
252 mutex_lock(&imxdi
->write_mutex
);
254 /* alarm is pending if the alarm flag is set */
255 alarm
->pending
= (__raw_readl(imxdi
->ioaddr
+ DSR
) & DSR_CAF
) != 0;
257 mutex_unlock(&imxdi
->write_mutex
);
263 * set the seconds portion of dryice alarm register
265 static int dryice_rtc_set_alarm(struct device
*dev
, struct rtc_wkalrm
*alarm
)
267 struct imxdi_dev
*imxdi
= dev_get_drvdata(dev
);
269 unsigned long alarm_time
;
272 rc
= rtc_tm_to_time(&alarm
->time
, &alarm_time
);
276 /* don't allow setting alarm in the past */
277 now
= __raw_readl(imxdi
->ioaddr
+ DTCMR
);
278 if (alarm_time
< now
)
281 /* write the new alarm time */
282 rc
= di_write_wait(imxdi
, (u32
)alarm_time
, DCAMR
);
287 di_int_enable(imxdi
, DIER_CAIE
); /* enable alarm intr */
289 di_int_disable(imxdi
, DIER_CAIE
); /* disable alarm intr */
294 static struct rtc_class_ops dryice_rtc_ops
= {
295 .read_time
= dryice_rtc_read_time
,
296 .set_mmss
= dryice_rtc_set_mmss
,
297 .alarm_irq_enable
= dryice_rtc_alarm_irq_enable
,
298 .read_alarm
= dryice_rtc_read_alarm
,
299 .set_alarm
= dryice_rtc_set_alarm
,
303 * dryice "normal" interrupt handler
305 static irqreturn_t
dryice_norm_irq(int irq
, void *dev_id
)
307 struct imxdi_dev
*imxdi
= dev_id
;
309 irqreturn_t rc
= IRQ_NONE
;
311 dier
= __raw_readl(imxdi
->ioaddr
+ DIER
);
313 /* handle write complete and write error cases */
314 if ((dier
& DIER_WCIE
)) {
315 /*If the write wait queue is empty then there is no pending
316 operations. It means the interrupt is for DryIce -Security.
317 IRQ must be returned as none.*/
318 if (list_empty_careful(&imxdi
->write_wait
.task_list
))
321 /* DSR_WCF clears itself on DSR read */
322 dsr
= __raw_readl(imxdi
->ioaddr
+ DSR
);
323 if ((dsr
& (DSR_WCF
| DSR_WEF
))) {
324 /* mask the interrupt */
325 di_int_disable(imxdi
, DIER_WCIE
);
327 /* save the dsr value for the wait queue */
330 wake_up_interruptible(&imxdi
->write_wait
);
335 /* handle the alarm case */
336 if ((dier
& DIER_CAIE
)) {
337 /* DSR_WCF clears itself on DSR read */
338 dsr
= __raw_readl(imxdi
->ioaddr
+ DSR
);
340 /* mask the interrupt */
341 di_int_disable(imxdi
, DIER_CAIE
);
343 /* finish alarm in user context */
344 schedule_work(&imxdi
->work
);
352 * post the alarm event from user context so it can sleep
353 * on the write completion.
355 static void dryice_work(struct work_struct
*work
)
357 struct imxdi_dev
*imxdi
= container_of(work
,
358 struct imxdi_dev
, work
);
360 /* dismiss the interrupt (ignore error) */
361 di_write_wait(imxdi
, DSR_CAF
, DSR
);
363 /* pass the alarm event to the rtc framework. */
364 rtc_update_irq(imxdi
->rtc
, 1, RTC_AF
| RTC_IRQF
);
368 * probe for dryice rtc device
370 static int dryice_rtc_probe(struct platform_device
*pdev
)
372 struct resource
*res
;
373 struct imxdi_dev
*imxdi
;
376 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
380 imxdi
= devm_kzalloc(&pdev
->dev
, sizeof(*imxdi
), GFP_KERNEL
);
386 if (!devm_request_mem_region(&pdev
->dev
, res
->start
, resource_size(res
),
390 imxdi
->ioaddr
= devm_ioremap(&pdev
->dev
, res
->start
,
392 if (imxdi
->ioaddr
== NULL
)
395 imxdi
->irq
= platform_get_irq(pdev
, 0);
399 init_waitqueue_head(&imxdi
->write_wait
);
401 INIT_WORK(&imxdi
->work
, dryice_work
);
403 mutex_init(&imxdi
->write_mutex
);
405 imxdi
->clk
= clk_get(&pdev
->dev
, NULL
);
406 if (IS_ERR(imxdi
->clk
))
407 return PTR_ERR(imxdi
->clk
);
408 clk_enable(imxdi
->clk
);
411 * Initialize dryice hardware
414 /* mask all interrupts */
415 __raw_writel(0, imxdi
->ioaddr
+ DIER
);
417 rc
= devm_request_irq(&pdev
->dev
, imxdi
->irq
, dryice_norm_irq
,
418 IRQF_SHARED
, pdev
->name
, imxdi
);
420 dev_warn(&pdev
->dev
, "interrupt not available.\n");
424 /* put dryice into valid state */
425 if (__raw_readl(imxdi
->ioaddr
+ DSR
) & DSR_NVF
) {
426 rc
= di_write_wait(imxdi
, DSR_NVF
| DSR_SVF
, DSR
);
431 /* initialize alarm */
432 rc
= di_write_wait(imxdi
, DCAMR_UNSET
, DCAMR
);
435 rc
= di_write_wait(imxdi
, 0, DCALR
);
439 /* clear alarm flag */
440 if (__raw_readl(imxdi
->ioaddr
+ DSR
) & DSR_CAF
) {
441 rc
= di_write_wait(imxdi
, DSR_CAF
, DSR
);
446 /* the timer won't count if it has never been written to */
447 if (__raw_readl(imxdi
->ioaddr
+ DTCMR
) == 0) {
448 rc
= di_write_wait(imxdi
, 0, DTCMR
);
453 /* start keeping time */
454 if (!(__raw_readl(imxdi
->ioaddr
+ DCR
) & DCR_TCE
)) {
455 rc
= di_write_wait(imxdi
,
456 __raw_readl(imxdi
->ioaddr
+ DCR
) | DCR_TCE
,
462 platform_set_drvdata(pdev
, imxdi
);
463 imxdi
->rtc
= rtc_device_register(pdev
->name
, &pdev
->dev
,
464 &dryice_rtc_ops
, THIS_MODULE
);
465 if (IS_ERR(imxdi
->rtc
)) {
466 rc
= PTR_ERR(imxdi
->rtc
);
473 clk_disable(imxdi
->clk
);
479 static int __devexit
dryice_rtc_remove(struct platform_device
*pdev
)
481 struct imxdi_dev
*imxdi
= platform_get_drvdata(pdev
);
483 flush_work(&imxdi
->work
);
485 /* mask all interrupts */
486 __raw_writel(0, imxdi
->ioaddr
+ DIER
);
488 rtc_device_unregister(imxdi
->rtc
);
490 clk_disable(imxdi
->clk
);
496 static struct platform_driver dryice_rtc_driver
= {
499 .owner
= THIS_MODULE
,
501 .remove
= __devexit_p(dryice_rtc_remove
),
504 static int __init
dryice_rtc_init(void)
506 return platform_driver_probe(&dryice_rtc_driver
, dryice_rtc_probe
);
509 static void __exit
dryice_rtc_exit(void)
511 platform_driver_unregister(&dryice_rtc_driver
);
514 module_init(dryice_rtc_init
);
515 module_exit(dryice_rtc_exit
);
517 MODULE_AUTHOR("Freescale Semiconductor, Inc.");
518 MODULE_AUTHOR("Baruch Siach <baruch@tkos.co.il>");
519 MODULE_DESCRIPTION("IMX DryIce Realtime Clock Driver (RTC)");
520 MODULE_LICENSE("GPL");