xref: /openbmc/linux/drivers/rtc/rtc-ds1553.c (revision 93dc544c)
1 /*
2  * An rtc driver for the Dallas DS1553
3  *
4  * Copyright (C) 2006 Atsushi Nemoto <anemo@mba.ocn.ne.jp>
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 as
8  * published by the Free Software Foundation.
9  */
10 
11 #include <linux/bcd.h>
12 #include <linux/init.h>
13 #include <linux/kernel.h>
14 #include <linux/delay.h>
15 #include <linux/jiffies.h>
16 #include <linux/interrupt.h>
17 #include <linux/rtc.h>
18 #include <linux/platform_device.h>
19 #include <linux/io.h>
20 
21 #define DRV_VERSION "0.2"
22 
23 #define RTC_REG_SIZE		0x2000
24 #define RTC_OFFSET		0x1ff0
25 
26 #define RTC_FLAGS		(RTC_OFFSET + 0)
27 #define RTC_SECONDS_ALARM	(RTC_OFFSET + 2)
28 #define RTC_MINUTES_ALARM	(RTC_OFFSET + 3)
29 #define RTC_HOURS_ALARM		(RTC_OFFSET + 4)
30 #define RTC_DATE_ALARM		(RTC_OFFSET + 5)
31 #define RTC_INTERRUPTS		(RTC_OFFSET + 6)
32 #define RTC_WATCHDOG		(RTC_OFFSET + 7)
33 #define RTC_CONTROL		(RTC_OFFSET + 8)
34 #define RTC_CENTURY		(RTC_OFFSET + 8)
35 #define RTC_SECONDS		(RTC_OFFSET + 9)
36 #define RTC_MINUTES		(RTC_OFFSET + 10)
37 #define RTC_HOURS		(RTC_OFFSET + 11)
38 #define RTC_DAY			(RTC_OFFSET + 12)
39 #define RTC_DATE		(RTC_OFFSET + 13)
40 #define RTC_MONTH		(RTC_OFFSET + 14)
41 #define RTC_YEAR		(RTC_OFFSET + 15)
42 
43 #define RTC_CENTURY_MASK	0x3f
44 #define RTC_SECONDS_MASK	0x7f
45 #define RTC_DAY_MASK		0x07
46 
47 /* Bits in the Control/Century register */
48 #define RTC_WRITE		0x80
49 #define RTC_READ		0x40
50 
51 /* Bits in the Seconds register */
52 #define RTC_STOP		0x80
53 
54 /* Bits in the Flags register */
55 #define RTC_FLAGS_AF		0x40
56 #define RTC_FLAGS_BLF		0x10
57 
58 /* Bits in the Interrupts register */
59 #define RTC_INTS_AE		0x80
60 
61 struct rtc_plat_data {
62 	struct rtc_device *rtc;
63 	void __iomem *ioaddr;
64 	resource_size_t baseaddr;
65 	unsigned long last_jiffies;
66 	int irq;
67 	unsigned int irqen;
68 	int alrm_sec;
69 	int alrm_min;
70 	int alrm_hour;
71 	int alrm_mday;
72 };
73 
74 static int ds1553_rtc_set_time(struct device *dev, struct rtc_time *tm)
75 {
76 	struct platform_device *pdev = to_platform_device(dev);
77 	struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
78 	void __iomem *ioaddr = pdata->ioaddr;
79 	u8 century;
80 
81 	century = BIN2BCD((tm->tm_year + 1900) / 100);
82 
83 	writeb(RTC_WRITE, pdata->ioaddr + RTC_CONTROL);
84 
85 	writeb(BIN2BCD(tm->tm_year % 100), ioaddr + RTC_YEAR);
86 	writeb(BIN2BCD(tm->tm_mon + 1), ioaddr + RTC_MONTH);
87 	writeb(BIN2BCD(tm->tm_wday) & RTC_DAY_MASK, ioaddr + RTC_DAY);
88 	writeb(BIN2BCD(tm->tm_mday), ioaddr + RTC_DATE);
89 	writeb(BIN2BCD(tm->tm_hour), ioaddr + RTC_HOURS);
90 	writeb(BIN2BCD(tm->tm_min), ioaddr + RTC_MINUTES);
91 	writeb(BIN2BCD(tm->tm_sec) & RTC_SECONDS_MASK, ioaddr + RTC_SECONDS);
92 
93 	/* RTC_CENTURY and RTC_CONTROL share same register */
94 	writeb(RTC_WRITE | (century & RTC_CENTURY_MASK), ioaddr + RTC_CENTURY);
95 	writeb(century & RTC_CENTURY_MASK, ioaddr + RTC_CONTROL);
96 	return 0;
97 }
98 
99 static int ds1553_rtc_read_time(struct device *dev, struct rtc_time *tm)
100 {
101 	struct platform_device *pdev = to_platform_device(dev);
102 	struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
103 	void __iomem *ioaddr = pdata->ioaddr;
104 	unsigned int year, month, day, hour, minute, second, week;
105 	unsigned int century;
106 
107 	/* give enough time to update RTC in case of continuous read */
108 	if (pdata->last_jiffies == jiffies)
109 		msleep(1);
110 	pdata->last_jiffies = jiffies;
111 	writeb(RTC_READ, ioaddr + RTC_CONTROL);
112 	second = readb(ioaddr + RTC_SECONDS) & RTC_SECONDS_MASK;
113 	minute = readb(ioaddr + RTC_MINUTES);
114 	hour = readb(ioaddr + RTC_HOURS);
115 	day = readb(ioaddr + RTC_DATE);
116 	week = readb(ioaddr + RTC_DAY) & RTC_DAY_MASK;
117 	month = readb(ioaddr + RTC_MONTH);
118 	year = readb(ioaddr + RTC_YEAR);
119 	century = readb(ioaddr + RTC_CENTURY) & RTC_CENTURY_MASK;
120 	writeb(0, ioaddr + RTC_CONTROL);
121 	tm->tm_sec = BCD2BIN(second);
122 	tm->tm_min = BCD2BIN(minute);
123 	tm->tm_hour = BCD2BIN(hour);
124 	tm->tm_mday = BCD2BIN(day);
125 	tm->tm_wday = BCD2BIN(week);
126 	tm->tm_mon = BCD2BIN(month) - 1;
127 	/* year is 1900 + tm->tm_year */
128 	tm->tm_year = BCD2BIN(year) + BCD2BIN(century) * 100 - 1900;
129 
130 	if (rtc_valid_tm(tm) < 0) {
131 		dev_err(dev, "retrieved date/time is not valid.\n");
132 		rtc_time_to_tm(0, tm);
133 	}
134 	return 0;
135 }
136 
137 static void ds1553_rtc_update_alarm(struct rtc_plat_data *pdata)
138 {
139 	void __iomem *ioaddr = pdata->ioaddr;
140 	unsigned long flags;
141 
142 	spin_lock_irqsave(&pdata->rtc->irq_lock, flags);
143 	writeb(pdata->alrm_mday < 0 || (pdata->irqen & RTC_UF) ?
144 	       0x80 : BIN2BCD(pdata->alrm_mday),
145 	       ioaddr + RTC_DATE_ALARM);
146 	writeb(pdata->alrm_hour < 0 || (pdata->irqen & RTC_UF) ?
147 	       0x80 : BIN2BCD(pdata->alrm_hour),
148 	       ioaddr + RTC_HOURS_ALARM);
149 	writeb(pdata->alrm_min < 0 || (pdata->irqen & RTC_UF) ?
150 	       0x80 : BIN2BCD(pdata->alrm_min),
151 	       ioaddr + RTC_MINUTES_ALARM);
152 	writeb(pdata->alrm_sec < 0 || (pdata->irqen & RTC_UF) ?
153 	       0x80 : BIN2BCD(pdata->alrm_sec),
154 	       ioaddr + RTC_SECONDS_ALARM);
155 	writeb(pdata->irqen ? RTC_INTS_AE : 0, ioaddr + RTC_INTERRUPTS);
156 	readb(ioaddr + RTC_FLAGS);	/* clear interrupts */
157 	spin_unlock_irqrestore(&pdata->rtc->irq_lock, flags);
158 }
159 
160 static int ds1553_rtc_set_alarm(struct device *dev, struct rtc_wkalrm *alrm)
161 {
162 	struct platform_device *pdev = to_platform_device(dev);
163 	struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
164 
165 	if (pdata->irq < 0)
166 		return -EINVAL;
167 	pdata->alrm_mday = alrm->time.tm_mday;
168 	pdata->alrm_hour = alrm->time.tm_hour;
169 	pdata->alrm_min = alrm->time.tm_min;
170 	pdata->alrm_sec = alrm->time.tm_sec;
171 	if (alrm->enabled)
172 		pdata->irqen |= RTC_AF;
173 	ds1553_rtc_update_alarm(pdata);
174 	return 0;
175 }
176 
177 static int ds1553_rtc_read_alarm(struct device *dev, struct rtc_wkalrm *alrm)
178 {
179 	struct platform_device *pdev = to_platform_device(dev);
180 	struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
181 
182 	if (pdata->irq < 0)
183 		return -EINVAL;
184 	alrm->time.tm_mday = pdata->alrm_mday < 0 ? 0 : pdata->alrm_mday;
185 	alrm->time.tm_hour = pdata->alrm_hour < 0 ? 0 : pdata->alrm_hour;
186 	alrm->time.tm_min = pdata->alrm_min < 0 ? 0 : pdata->alrm_min;
187 	alrm->time.tm_sec = pdata->alrm_sec < 0 ? 0 : pdata->alrm_sec;
188 	alrm->enabled = (pdata->irqen & RTC_AF) ? 1 : 0;
189 	return 0;
190 }
191 
192 static irqreturn_t ds1553_rtc_interrupt(int irq, void *dev_id)
193 {
194 	struct platform_device *pdev = dev_id;
195 	struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
196 	void __iomem *ioaddr = pdata->ioaddr;
197 	unsigned long events = RTC_IRQF;
198 
199 	/* read and clear interrupt */
200 	if (!(readb(ioaddr + RTC_FLAGS) & RTC_FLAGS_AF))
201 		return IRQ_NONE;
202 	if (readb(ioaddr + RTC_SECONDS_ALARM) & 0x80)
203 		events |= RTC_UF;
204 	else
205 		events |= RTC_AF;
206 	rtc_update_irq(pdata->rtc, 1, events);
207 	return IRQ_HANDLED;
208 }
209 
210 static void ds1553_rtc_release(struct device *dev)
211 {
212 	struct platform_device *pdev = to_platform_device(dev);
213 	struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
214 
215 	if (pdata->irq >= 0) {
216 		pdata->irqen = 0;
217 		ds1553_rtc_update_alarm(pdata);
218 	}
219 }
220 
221 static int ds1553_rtc_ioctl(struct device *dev, unsigned int cmd,
222 			    unsigned long arg)
223 {
224 	struct platform_device *pdev = to_platform_device(dev);
225 	struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
226 
227 	if (pdata->irq < 0)
228 		return -ENOIOCTLCMD; /* fall back into rtc-dev's emulation */
229 	switch (cmd) {
230 	case RTC_AIE_OFF:
231 		pdata->irqen &= ~RTC_AF;
232 		ds1553_rtc_update_alarm(pdata);
233 		break;
234 	case RTC_AIE_ON:
235 		pdata->irqen |= RTC_AF;
236 		ds1553_rtc_update_alarm(pdata);
237 		break;
238 	case RTC_UIE_OFF:
239 		pdata->irqen &= ~RTC_UF;
240 		ds1553_rtc_update_alarm(pdata);
241 		break;
242 	case RTC_UIE_ON:
243 		pdata->irqen |= RTC_UF;
244 		ds1553_rtc_update_alarm(pdata);
245 		break;
246 	default:
247 		return -ENOIOCTLCMD;
248 	}
249 	return 0;
250 }
251 
252 static const struct rtc_class_ops ds1553_rtc_ops = {
253 	.read_time	= ds1553_rtc_read_time,
254 	.set_time	= ds1553_rtc_set_time,
255 	.read_alarm	= ds1553_rtc_read_alarm,
256 	.set_alarm	= ds1553_rtc_set_alarm,
257 	.release	= ds1553_rtc_release,
258 	.ioctl		= ds1553_rtc_ioctl,
259 };
260 
261 static ssize_t ds1553_nvram_read(struct kobject *kobj,
262 				 struct bin_attribute *bin_attr,
263 				 char *buf, loff_t pos, size_t size)
264 {
265 	struct platform_device *pdev =
266 		to_platform_device(container_of(kobj, struct device, kobj));
267 	struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
268 	void __iomem *ioaddr = pdata->ioaddr;
269 	ssize_t count;
270 
271 	for (count = 0; size > 0 && pos < RTC_OFFSET; count++, size--)
272 		*buf++ = readb(ioaddr + pos++);
273 	return count;
274 }
275 
276 static ssize_t ds1553_nvram_write(struct kobject *kobj,
277 				  struct bin_attribute *bin_attr,
278 				  char *buf, loff_t pos, size_t size)
279 {
280 	struct platform_device *pdev =
281 		to_platform_device(container_of(kobj, struct device, kobj));
282 	struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
283 	void __iomem *ioaddr = pdata->ioaddr;
284 	ssize_t count;
285 
286 	for (count = 0; size > 0 && pos < RTC_OFFSET; count++, size--)
287 		writeb(*buf++, ioaddr + pos++);
288 	return count;
289 }
290 
291 static struct bin_attribute ds1553_nvram_attr = {
292 	.attr = {
293 		.name = "nvram",
294 		.mode = S_IRUGO | S_IWUSR,
295 	},
296 	.size = RTC_OFFSET,
297 	.read = ds1553_nvram_read,
298 	.write = ds1553_nvram_write,
299 };
300 
301 static int __devinit ds1553_rtc_probe(struct platform_device *pdev)
302 {
303 	struct rtc_device *rtc;
304 	struct resource *res;
305 	unsigned int cen, sec;
306 	struct rtc_plat_data *pdata = NULL;
307 	void __iomem *ioaddr = NULL;
308 	int ret = 0;
309 
310 	res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
311 	if (!res)
312 		return -ENODEV;
313 	pdata = kzalloc(sizeof(*pdata), GFP_KERNEL);
314 	if (!pdata)
315 		return -ENOMEM;
316 	pdata->irq = -1;
317 	if (!request_mem_region(res->start, RTC_REG_SIZE, pdev->name)) {
318 		ret = -EBUSY;
319 		goto out;
320 	}
321 	pdata->baseaddr = res->start;
322 	ioaddr = ioremap(pdata->baseaddr, RTC_REG_SIZE);
323 	if (!ioaddr) {
324 		ret = -ENOMEM;
325 		goto out;
326 	}
327 	pdata->ioaddr = ioaddr;
328 	pdata->irq = platform_get_irq(pdev, 0);
329 
330 	/* turn RTC on if it was not on */
331 	sec = readb(ioaddr + RTC_SECONDS);
332 	if (sec & RTC_STOP) {
333 		sec &= RTC_SECONDS_MASK;
334 		cen = readb(ioaddr + RTC_CENTURY) & RTC_CENTURY_MASK;
335 		writeb(RTC_WRITE, ioaddr + RTC_CONTROL);
336 		writeb(sec, ioaddr + RTC_SECONDS);
337 		writeb(cen & RTC_CENTURY_MASK, ioaddr + RTC_CONTROL);
338 	}
339 	if (readb(ioaddr + RTC_FLAGS) & RTC_FLAGS_BLF)
340 		dev_warn(&pdev->dev, "voltage-low detected.\n");
341 
342 	if (pdata->irq >= 0) {
343 		writeb(0, ioaddr + RTC_INTERRUPTS);
344 		if (request_irq(pdata->irq, ds1553_rtc_interrupt,
345 				IRQF_DISABLED | IRQF_SHARED,
346 				pdev->name, pdev) < 0) {
347 			dev_warn(&pdev->dev, "interrupt not available.\n");
348 			pdata->irq = -1;
349 		}
350 	}
351 
352 	rtc = rtc_device_register(pdev->name, &pdev->dev,
353 				  &ds1553_rtc_ops, THIS_MODULE);
354 	if (IS_ERR(rtc)) {
355 		ret = PTR_ERR(rtc);
356 		goto out;
357 	}
358 	pdata->rtc = rtc;
359 	pdata->last_jiffies = jiffies;
360 	platform_set_drvdata(pdev, pdata);
361 	ret = sysfs_create_bin_file(&pdev->dev.kobj, &ds1553_nvram_attr);
362 	if (ret)
363 		goto out;
364 	return 0;
365  out:
366 	if (pdata->rtc)
367 		rtc_device_unregister(pdata->rtc);
368 	if (pdata->irq >= 0)
369 		free_irq(pdata->irq, pdev);
370 	if (ioaddr)
371 		iounmap(ioaddr);
372 	if (pdata->baseaddr)
373 		release_mem_region(pdata->baseaddr, RTC_REG_SIZE);
374 	kfree(pdata);
375 	return ret;
376 }
377 
378 static int __devexit ds1553_rtc_remove(struct platform_device *pdev)
379 {
380 	struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
381 
382 	sysfs_remove_bin_file(&pdev->dev.kobj, &ds1553_nvram_attr);
383 	rtc_device_unregister(pdata->rtc);
384 	if (pdata->irq >= 0) {
385 		writeb(0, pdata->ioaddr + RTC_INTERRUPTS);
386 		free_irq(pdata->irq, pdev);
387 	}
388 	iounmap(pdata->ioaddr);
389 	release_mem_region(pdata->baseaddr, RTC_REG_SIZE);
390 	kfree(pdata);
391 	return 0;
392 }
393 
394 /* work with hotplug and coldplug */
395 MODULE_ALIAS("platform:rtc-ds1553");
396 
397 static struct platform_driver ds1553_rtc_driver = {
398 	.probe		= ds1553_rtc_probe,
399 	.remove		= __devexit_p(ds1553_rtc_remove),
400 	.driver		= {
401 		.name	= "rtc-ds1553",
402 		.owner	= THIS_MODULE,
403 	},
404 };
405 
406 static __init int ds1553_init(void)
407 {
408 	return platform_driver_register(&ds1553_rtc_driver);
409 }
410 
411 static __exit void ds1553_exit(void)
412 {
413 	platform_driver_unregister(&ds1553_rtc_driver);
414 }
415 
416 module_init(ds1553_init);
417 module_exit(ds1553_exit);
418 
419 MODULE_AUTHOR("Atsushi Nemoto <anemo@mba.ocn.ne.jp>");
420 MODULE_DESCRIPTION("Dallas DS1553 RTC driver");
421 MODULE_LICENSE("GPL");
422 MODULE_VERSION(DRV_VERSION);
423