[net-next-2.6.git] / drivers / rtc / rtc-rs5c348.c

/*
 * A SPI driver for the Ricoh RS5C348 RTC
 *
 * Copyright (C) 2006 Atsushi Nemoto <anemo@mba.ocn.ne.jp>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
 *
 * The board specific init code should provide characteristics of this
 * device:
 *     Mode 1 (High-Active, Shift-Then-Sample), High Avtive CS
 */

#include <linux/bcd.h>
#include <linux/delay.h>
#include <linux/device.h>
#include <linux/errno.h>
#include <linux/init.h>
#include <linux/kernel.h>
#include <linux/string.h>
#include <linux/slab.h>
#include <linux/rtc.h>
#include <linux/workqueue.h>
#include <linux/spi/spi.h>

#define DRV_VERSION "0.2"

#define RS5C348_REG_SECS	0
#define RS5C348_REG_MINS	1
#define RS5C348_REG_HOURS	2
#define RS5C348_REG_WDAY	3
#define RS5C348_REG_DAY	4
#define RS5C348_REG_MONTH	5
#define RS5C348_REG_YEAR	6
#define RS5C348_REG_CTL1	14
#define RS5C348_REG_CTL2	15

#define RS5C348_SECS_MASK	0x7f
#define RS5C348_MINS_MASK	0x7f
#define RS5C348_HOURS_MASK	0x3f
#define RS5C348_WDAY_MASK	0x03
#define RS5C348_DAY_MASK	0x3f
#define RS5C348_MONTH_MASK	0x1f

#define RS5C348_BIT_PM	0x20	/* REG_HOURS */
#define RS5C348_BIT_Y2K	0x80	/* REG_MONTH */
#define RS5C348_BIT_24H	0x20	/* REG_CTL1 */
#define RS5C348_BIT_XSTP	0x10	/* REG_CTL2 */
#define RS5C348_BIT_VDET	0x40	/* REG_CTL2 */

#define RS5C348_CMD_W(addr)	(((addr) << 4) | 0x08)	/* single write */
#define RS5C348_CMD_R(addr)	(((addr) << 4) | 0x0c)	/* single read */
#define RS5C348_CMD_MW(addr)	(((addr) << 4) | 0x00)	/* burst write */
#define RS5C348_CMD_MR(addr)	(((addr) << 4) | 0x04)	/* burst read */

struct rs5c348_plat_data {
	struct rtc_device *rtc;
	int rtc_24h;
};

static int
rs5c348_rtc_set_time(struct device *dev, struct rtc_time *tm)
{
	struct spi_device *spi = to_spi_device(dev);
	struct rs5c348_plat_data *pdata = spi->dev.platform_data;
	u8 txbuf[5+7], *txp;
	int ret;

	/* Transfer 5 bytes before writing SEC.  This gives 31us for carry. */
	txp = txbuf;
	txbuf[0] = RS5C348_CMD_R(RS5C348_REG_CTL2); /* cmd, ctl2 */
	txbuf[1] = 0;	/* dummy */
	txbuf[2] = RS5C348_CMD_R(RS5C348_REG_CTL2); /* cmd, ctl2 */
	txbuf[3] = 0;	/* dummy */
	txbuf[4] = RS5C348_CMD_MW(RS5C348_REG_SECS); /* cmd, sec, ... */
	txp = &txbuf[5];
	txp[RS5C348_REG_SECS] = bin2bcd(tm->tm_sec);
	txp[RS5C348_REG_MINS] = bin2bcd(tm->tm_min);
	if (pdata->rtc_24h) {
		txp[RS5C348_REG_HOURS] = bin2bcd(tm->tm_hour);
	} else {
		/* hour 0 is AM12, noon is PM12 */
		txp[RS5C348_REG_HOURS] = bin2bcd((tm->tm_hour + 11) % 12 + 1) |
			(tm->tm_hour >= 12 ? RS5C348_BIT_PM : 0);
	}
	txp[RS5C348_REG_WDAY] = bin2bcd(tm->tm_wday);
	txp[RS5C348_REG_DAY] = bin2bcd(tm->tm_mday);
	txp[RS5C348_REG_MONTH] = bin2bcd(tm->tm_mon + 1) |
		(tm->tm_year >= 100 ? RS5C348_BIT_Y2K : 0);
	txp[RS5C348_REG_YEAR] = bin2bcd(tm->tm_year % 100);
	/* write in one transfer to avoid data inconsistency */
	ret = spi_write_then_read(spi, txbuf, sizeof(txbuf), NULL, 0);
	udelay(62);	/* Tcsr 62us */
	return ret;
}

static int
rs5c348_rtc_read_time(struct device *dev, struct rtc_time *tm)
{
	struct spi_device *spi = to_spi_device(dev);
	struct rs5c348_plat_data *pdata = spi->dev.platform_data;
	u8 txbuf[5], rxbuf[7];
	int ret;

	/* Transfer 5 byte befores reading SEC.  This gives 31us for carry. */
	txbuf[0] = RS5C348_CMD_R(RS5C348_REG_CTL2); /* cmd, ctl2 */
	txbuf[1] = 0;	/* dummy */
	txbuf[2] = RS5C348_CMD_R(RS5C348_REG_CTL2); /* cmd, ctl2 */
	txbuf[3] = 0;	/* dummy */
	txbuf[4] = RS5C348_CMD_MR(RS5C348_REG_SECS); /* cmd, sec, ... */

	/* read in one transfer to avoid data inconsistency */
	ret = spi_write_then_read(spi, txbuf, sizeof(txbuf),
				  rxbuf, sizeof(rxbuf));
	udelay(62);	/* Tcsr 62us */
	if (ret < 0)
		return ret;

	tm->tm_sec = bcd2bin(rxbuf[RS5C348_REG_SECS] & RS5C348_SECS_MASK);
	tm->tm_min = bcd2bin(rxbuf[RS5C348_REG_MINS] & RS5C348_MINS_MASK);
	tm->tm_hour = bcd2bin(rxbuf[RS5C348_REG_HOURS] & RS5C348_HOURS_MASK);
	if (!pdata->rtc_24h) {
		tm->tm_hour %= 12;
		if (rxbuf[RS5C348_REG_HOURS] & RS5C348_BIT_PM)
			tm->tm_hour += 12;
	}
	tm->tm_wday = bcd2bin(rxbuf[RS5C348_REG_WDAY] & RS5C348_WDAY_MASK);
	tm->tm_mday = bcd2bin(rxbuf[RS5C348_REG_DAY] & RS5C348_DAY_MASK);
	tm->tm_mon =
		bcd2bin(rxbuf[RS5C348_REG_MONTH] & RS5C348_MONTH_MASK) - 1;
	/* year is 1900 + tm->tm_year */
	tm->tm_year = bcd2bin(rxbuf[RS5C348_REG_YEAR]) +
		((rxbuf[RS5C348_REG_MONTH] & RS5C348_BIT_Y2K) ? 100 : 0);

	if (rtc_valid_tm(tm) < 0) {
		dev_err(&spi->dev, "retrieved date/time is not valid.\n");
		rtc_time_to_tm(0, tm);
	}

	return 0;
}

static const struct rtc_class_ops rs5c348_rtc_ops = {
	.read_time	= rs5c348_rtc_read_time,
	.set_time	= rs5c348_rtc_set_time,
};

static struct spi_driver rs5c348_driver;

static int __devinit rs5c348_probe(struct spi_device *spi)
{
	int ret;
	struct rtc_device *rtc;
	struct rs5c348_plat_data *pdata;

	pdata = kzalloc(sizeof(struct rs5c348_plat_data), GFP_KERNEL);
	if (!pdata)
		return -ENOMEM;
	spi->dev.platform_data = pdata;

	/* Check D7 of SECOND register */
	ret = spi_w8r8(spi, RS5C348_CMD_R(RS5C348_REG_SECS));
	if (ret < 0 || (ret & 0x80)) {
		dev_err(&spi->dev, "not found.\n");
		goto kfree_exit;
	}

	dev_info(&spi->dev, "chip found, driver version " DRV_VERSION "\n");
	dev_info(&spi->dev, "spiclk %u KHz.\n",
		 (spi->max_speed_hz + 500) / 1000);

	/* turn RTC on if it was not on */
	ret = spi_w8r8(spi, RS5C348_CMD_R(RS5C348_REG_CTL2));
	if (ret < 0)
		goto kfree_exit;
	if (ret & (RS5C348_BIT_XSTP | RS5C348_BIT_VDET)) {
		u8 buf[2];
		struct rtc_time tm;
		if (ret & RS5C348_BIT_VDET)
			dev_warn(&spi->dev, "voltage-low detected.\n");
		if (ret & RS5C348_BIT_XSTP)
			dev_warn(&spi->dev, "oscillator-stop detected.\n");
		rtc_time_to_tm(0, &tm);	/* 1970/1/1 */
		ret = rs5c348_rtc_set_time(&spi->dev, &tm);
		if (ret < 0)
			goto kfree_exit;
		buf[0] = RS5C348_CMD_W(RS5C348_REG_CTL2);
		buf[1] = 0;
		ret = spi_write_then_read(spi, buf, sizeof(buf), NULL, 0);
		if (ret < 0)
			goto kfree_exit;
	}

	ret = spi_w8r8(spi, RS5C348_CMD_R(RS5C348_REG_CTL1));
	if (ret < 0)
		goto kfree_exit;
	if (ret & RS5C348_BIT_24H)
		pdata->rtc_24h = 1;

	rtc = rtc_device_register(rs5c348_driver.driver.name, &spi->dev,
				  &rs5c348_rtc_ops, THIS_MODULE);

	if (IS_ERR(rtc)) {
		ret = PTR_ERR(rtc);
		goto kfree_exit;
	}

	pdata->rtc = rtc;

	return 0;
 kfree_exit:
	kfree(pdata);
	return ret;
}

static int __devexit rs5c348_remove(struct spi_device *spi)
{
	struct rs5c348_plat_data *pdata = spi->dev.platform_data;
	struct rtc_device *rtc = pdata->rtc;

	if (rtc)
		rtc_device_unregister(rtc);
	kfree(pdata);
	return 0;
}

static struct spi_driver rs5c348_driver = {
	.driver = {
		.name	= "rtc-rs5c348",
		.bus	= &spi_bus_type,
		.owner	= THIS_MODULE,
	},
	.probe	= rs5c348_probe,
	.remove	= __devexit_p(rs5c348_remove),
};

static __init int rs5c348_init(void)
{
	return spi_register_driver(&rs5c348_driver);
}

static __exit void rs5c348_exit(void)
{
	spi_unregister_driver(&rs5c348_driver);
}

module_init(rs5c348_init);
module_exit(rs5c348_exit);

MODULE_AUTHOR("Atsushi Nemoto <anemo@mba.ocn.ne.jp>");
MODULE_DESCRIPTION("Ricoh RS5C348 RTC driver");
MODULE_LICENSE("GPL");
MODULE_VERSION(DRV_VERSION);
MODULE_ALIAS("spi:rtc-rs5c348");
Commit	Line	Data
e0ac4761 AN	1	/*
	2	* A SPI driver for the Ricoh RS5C348 RTC
	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	* The board specific init code should provide characteristics of this
	11	* device:
	12	* Mode 1 (High-Active, Shift-Then-Sample), High Avtive CS
	13	*/
	14
	15	#include <linux/bcd.h>
	16	#include <linux/delay.h>
	17	#include <linux/device.h>
	18	#include <linux/errno.h>
	19	#include <linux/init.h>
	20	#include <linux/kernel.h>
	21	#include <linux/string.h>
5a0e3ad6	22	#include <linux/slab.h>
e0ac4761 AN	23	#include <linux/rtc.h>
	24	#include <linux/workqueue.h>
	25	#include <linux/spi/spi.h>
	26
13c73f04	27	#define DRV_VERSION "0.2"
e0ac4761 AN	28
	29	#define RS5C348_REG_SECS 0
	30	#define RS5C348_REG_MINS 1
	31	#define RS5C348_REG_HOURS 2
	32	#define RS5C348_REG_WDAY 3
	33	#define RS5C348_REG_DAY 4
	34	#define RS5C348_REG_MONTH 5
	35	#define RS5C348_REG_YEAR 6
	36	#define RS5C348_REG_CTL1 14
	37	#define RS5C348_REG_CTL2 15
	38
	39	#define RS5C348_SECS_MASK 0x7f
	40	#define RS5C348_MINS_MASK 0x7f
	41	#define RS5C348_HOURS_MASK 0x3f
	42	#define RS5C348_WDAY_MASK 0x03
	43	#define RS5C348_DAY_MASK 0x3f
	44	#define RS5C348_MONTH_MASK 0x1f
	45
	46	#define RS5C348_BIT_PM 0x20 /* REG_HOURS */
	47	#define RS5C348_BIT_Y2K 0x80 /* REG_MONTH */
	48	#define RS5C348_BIT_24H 0x20 /* REG_CTL1 */
	49	#define RS5C348_BIT_XSTP 0x10 /* REG_CTL2 */
	50	#define RS5C348_BIT_VDET 0x40 /* REG_CTL2 */
	51
	52	#define RS5C348_CMD_W(addr) (((addr) << 4) \| 0x08) /* single write */
	53	#define RS5C348_CMD_R(addr) (((addr) << 4) \| 0x0c) /* single read */
	54	#define RS5C348_CMD_MW(addr) (((addr) << 4) \| 0x00) /* burst write */
	55	#define RS5C348_CMD_MR(addr) (((addr) << 4) \| 0x04) /* burst read */
	56
	57	struct rs5c348_plat_data {
	58	struct rtc_device *rtc;
	59	int rtc_24h;
	60	};
	61
	62	static int
	63	rs5c348_rtc_set_time(struct device dev, struct rtc_time tm)
	64	{
	65	struct spi_device *spi = to_spi_device(dev);
	66	struct rs5c348_plat_data *pdata = spi->dev.platform_data;
	67	u8 txbuf[5+7], *txp;
	68	int ret;
	69
	70	/* Transfer 5 bytes before writing SEC. This gives 31us for carry. */
	71	txp = txbuf;
	72	txbuf[0] = RS5C348_CMD_R(RS5C348_REG_CTL2); /* cmd, ctl2 */
	73	txbuf[1] = 0; /* dummy */
	74	txbuf[2] = RS5C348_CMD_R(RS5C348_REG_CTL2); /* cmd, ctl2 */
	75	txbuf[3] = 0; /* dummy */
	76	txbuf[4] = RS5C348_CMD_MW(RS5C348_REG_SECS); /* cmd, sec, ... */
	77	txp = &txbuf[5];
fe20ba70 AB	78	txp[RS5C348_REG_SECS] = bin2bcd(tm->tm_sec);
fe20ba70 AB	79	txp[RS5C348_REG_MINS] = bin2bcd(tm->tm_min);
e0ac4761	80	if (pdata->rtc_24h) {
fe20ba70	81	txp[RS5C348_REG_HOURS] = bin2bcd(tm->tm_hour);
e0ac4761 AN	82	} else {
e0ac4761 AN	83	/* hour 0 is AM12, noon is PM12 */
fe20ba70	84	txp[RS5C348_REG_HOURS] = bin2bcd((tm->tm_hour + 11) % 12 + 1) \|
e0ac4761 AN	85	(tm->tm_hour >= 12 ? RS5C348_BIT_PM : 0);
e0ac4761 AN	86	}
fe20ba70 AB	87	txp[RS5C348_REG_WDAY] = bin2bcd(tm->tm_wday);
	88	txp[RS5C348_REG_DAY] = bin2bcd(tm->tm_mday);
	89	txp[RS5C348_REG_MONTH] = bin2bcd(tm->tm_mon + 1) \|
e0ac4761	90	(tm->tm_year >= 100 ? RS5C348_BIT_Y2K : 0);
fe20ba70	91	txp[RS5C348_REG_YEAR] = bin2bcd(tm->tm_year % 100);
e0ac4761 AN	92	/* write in one transfer to avoid data inconsistency */
	93	ret = spi_write_then_read(spi, txbuf, sizeof(txbuf), NULL, 0);
	94	udelay(62); /* Tcsr 62us */
	95	return ret;
	96	}
	97
	98	static int
	99	rs5c348_rtc_read_time(struct device dev, struct rtc_time tm)
	100	{
	101	struct spi_device *spi = to_spi_device(dev);
	102	struct rs5c348_plat_data *pdata = spi->dev.platform_data;
	103	u8 txbuf[5], rxbuf[7];
	104	int ret;
	105
	106	/* Transfer 5 byte befores reading SEC. This gives 31us for carry. */
	107	txbuf[0] = RS5C348_CMD_R(RS5C348_REG_CTL2); /* cmd, ctl2 */
	108	txbuf[1] = 0; /* dummy */
	109	txbuf[2] = RS5C348_CMD_R(RS5C348_REG_CTL2); /* cmd, ctl2 */
	110	txbuf[3] = 0; /* dummy */
	111	txbuf[4] = RS5C348_CMD_MR(RS5C348_REG_SECS); /* cmd, sec, ... */
	112
	113	/* read in one transfer to avoid data inconsistency */
	114	ret = spi_write_then_read(spi, txbuf, sizeof(txbuf),
	115	rxbuf, sizeof(rxbuf));
	116	udelay(62); /* Tcsr 62us */
	117	if (ret < 0)
	118	return ret;
	119
fe20ba70 AB	120	tm->tm_sec = bcd2bin(rxbuf[RS5C348_REG_SECS] & RS5C348_SECS_MASK);
	121	tm->tm_min = bcd2bin(rxbuf[RS5C348_REG_MINS] & RS5C348_MINS_MASK);
	122	tm->tm_hour = bcd2bin(rxbuf[RS5C348_REG_HOURS] & RS5C348_HOURS_MASK);
e0ac4761 AN	123	if (!pdata->rtc_24h) {
	124	tm->tm_hour %= 12;
	125	if (rxbuf[RS5C348_REG_HOURS] & RS5C348_BIT_PM)
	126	tm->tm_hour += 12;
	127	}
fe20ba70 AB	128	tm->tm_wday = bcd2bin(rxbuf[RS5C348_REG_WDAY] & RS5C348_WDAY_MASK);
fe20ba70 AB	129	tm->tm_mday = bcd2bin(rxbuf[RS5C348_REG_DAY] & RS5C348_DAY_MASK);
e0ac4761	130	tm->tm_mon =
fe20ba70	131	bcd2bin(rxbuf[RS5C348_REG_MONTH] & RS5C348_MONTH_MASK) - 1;
e0ac4761	132	/* year is 1900 + tm->tm_year */
fe20ba70	133	tm->tm_year = bcd2bin(rxbuf[RS5C348_REG_YEAR]) +
e0ac4761 AN	134	((rxbuf[RS5C348_REG_MONTH] & RS5C348_BIT_Y2K) ? 100 : 0);
	135
	136	if (rtc_valid_tm(tm) < 0) {
	137	dev_err(&spi->dev, "retrieved date/time is not valid.\n");
	138	rtc_time_to_tm(0, tm);
	139	}
	140
	141	return 0;
	142	}
	143
ff8371ac	144	static const struct rtc_class_ops rs5c348_rtc_ops = {
e0ac4761 AN	145	.read_time = rs5c348_rtc_read_time,
	146	.set_time = rs5c348_rtc_set_time,
	147	};
	148
	149	static struct spi_driver rs5c348_driver;
	150
	151	static int __devinit rs5c348_probe(struct spi_device *spi)
	152	{
	153	int ret;
	154	struct rtc_device *rtc;
	155	struct rs5c348_plat_data *pdata;
	156
	157	pdata = kzalloc(sizeof(struct rs5c348_plat_data), GFP_KERNEL);
	158	if (!pdata)
	159	return -ENOMEM;
	160	spi->dev.platform_data = pdata;
	161
	162	/* Check D7 of SECOND register */
	163	ret = spi_w8r8(spi, RS5C348_CMD_R(RS5C348_REG_SECS));
	164	if (ret < 0 \|\| (ret & 0x80)) {
	165	dev_err(&spi->dev, "not found.\n");
	166	goto kfree_exit;
	167	}
	168
	169	dev_info(&spi->dev, "chip found, driver version " DRV_VERSION "\n");
	170	dev_info(&spi->dev, "spiclk %u KHz.\n",
	171	(spi->max_speed_hz + 500) / 1000);
	172
	173	/* turn RTC on if it was not on */
	174	ret = spi_w8r8(spi, RS5C348_CMD_R(RS5C348_REG_CTL2));
	175	if (ret < 0)
	176	goto kfree_exit;
	177	if (ret & (RS5C348_BIT_XSTP \| RS5C348_BIT_VDET)) {
	178	u8 buf[2];
13c73f04	179	struct rtc_time tm;
e0ac4761 AN	180	if (ret & RS5C348_BIT_VDET)
e0ac4761 AN	181	dev_warn(&spi->dev, "voltage-low detected.\n");
13c73f04 AN	182	if (ret & RS5C348_BIT_XSTP)
	183	dev_warn(&spi->dev, "oscillator-stop detected.\n");
	184	rtc_time_to_tm(0, &tm); /* 1970/1/1 */
	185	ret = rs5c348_rtc_set_time(&spi->dev, &tm);
	186	if (ret < 0)
	187	goto kfree_exit;
e0ac4761 AN	188	buf[0] = RS5C348_CMD_W(RS5C348_REG_CTL2);
	189	buf[1] = 0;
	190	ret = spi_write_then_read(spi, buf, sizeof(buf), NULL, 0);
	191	if (ret < 0)
	192	goto kfree_exit;
	193	}
	194
	195	ret = spi_w8r8(spi, RS5C348_CMD_R(RS5C348_REG_CTL1));
	196	if (ret < 0)
	197	goto kfree_exit;
	198	if (ret & RS5C348_BIT_24H)
	199	pdata->rtc_24h = 1;
	200
	201	rtc = rtc_device_register(rs5c348_driver.driver.name, &spi->dev,
	202	&rs5c348_rtc_ops, THIS_MODULE);
	203
	204	if (IS_ERR(rtc)) {
	205	ret = PTR_ERR(rtc);
	206	goto kfree_exit;
	207	}
	208
	209	pdata->rtc = rtc;
	210
	211	return 0;
	212	kfree_exit:
	213	kfree(pdata);
	214	return ret;
	215	}
	216
	217	static int __devexit rs5c348_remove(struct spi_device *spi)
	218	{
	219	struct rs5c348_plat_data *pdata = spi->dev.platform_data;
	220	struct rtc_device *rtc = pdata->rtc;
	221
	222	if (rtc)
	223	rtc_device_unregister(rtc);
	224	kfree(pdata);
	225	return 0;
	226	}
	227
	228	static struct spi_driver rs5c348_driver = {
	229	.driver = {
9f90a03a	230	.name = "rtc-rs5c348",
e0ac4761 AN	231	.bus = &spi_bus_type,
	232	.owner = THIS_MODULE,
	233	},
	234	.probe = rs5c348_probe,
	235	.remove = __devexit_p(rs5c348_remove),
	236	};
	237
	238	static __init int rs5c348_init(void)
	239	{
	240	return spi_register_driver(&rs5c348_driver);
	241	}
	242
	243	static __exit void rs5c348_exit(void)
	244	{
	245	spi_unregister_driver(&rs5c348_driver);
	246	}
	247
	248	module_init(rs5c348_init);
	249	module_exit(rs5c348_exit);
	250
	251	MODULE_AUTHOR("Atsushi Nemoto <anemo@mba.ocn.ne.jp>");
	252	MODULE_DESCRIPTION("Ricoh RS5C348 RTC driver");
	253	MODULE_LICENSE("GPL");
	254	MODULE_VERSION(DRV_VERSION);
e0626e38	255	MODULE_ALIAS("spi:rtc-rs5c348");