rtc-isl1208.c 13.3 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/*
 * Intersil ISL1208 rtc class driver
 *
 * Copyright 2005,2006 Hebert Valerio Riedel <hvr@gnu.org>
 *
 *  This program is free software; you can redistribute  it and/or modify it
 *  under  the terms of  the GNU General  Public License as published by the
 *  Free Software Foundation;  either version 2 of the  License, or (at your
 *  option) any later version.
 *
 */

#include <linux/module.h>
#include <linux/i2c.h>
#include <linux/bcd.h>
#include <linux/rtc.h>

18
#define DRV_VERSION "0.3"
19
20
21
22
23
24

/* Register map */
/* rtc section */
#define ISL1208_REG_SC  0x00
#define ISL1208_REG_MN  0x01
#define ISL1208_REG_HR  0x02
25
26
#define ISL1208_REG_HR_MIL     (1<<7)	/* 24h/12h mode */
#define ISL1208_REG_HR_PM      (1<<5)	/* PM/AM bit in 12h mode */
27
28
29
30
31
32
33
34
#define ISL1208_REG_DT  0x03
#define ISL1208_REG_MO  0x04
#define ISL1208_REG_YR  0x05
#define ISL1208_REG_DW  0x06
#define ISL1208_RTC_SECTION_LEN 7

/* control/status section */
#define ISL1208_REG_SR  0x07
35
36
37
38
39
40
#define ISL1208_REG_SR_ARST    (1<<7)	/* auto reset */
#define ISL1208_REG_SR_XTOSCB  (1<<6)	/* crystal oscillator */
#define ISL1208_REG_SR_WRTC    (1<<4)	/* write rtc */
#define ISL1208_REG_SR_ALM     (1<<2)	/* alarm */
#define ISL1208_REG_SR_BAT     (1<<1)	/* battery */
#define ISL1208_REG_SR_RTCF    (1<<0)	/* rtc fail */
41
#define ISL1208_REG_INT 0x08
42
#define ISL1208_REG_09  0x09	/* reserved */
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
#define ISL1208_REG_ATR 0x0a
#define ISL1208_REG_DTR 0x0b

/* alarm section */
#define ISL1208_REG_SCA 0x0c
#define ISL1208_REG_MNA 0x0d
#define ISL1208_REG_HRA 0x0e
#define ISL1208_REG_DTA 0x0f
#define ISL1208_REG_MOA 0x10
#define ISL1208_REG_DWA 0x11
#define ISL1208_ALARM_SECTION_LEN 6

/* user section */
#define ISL1208_REG_USR1 0x12
#define ISL1208_REG_USR2 0x13
#define ISL1208_USR_SECTION_LEN 2

60
static struct i2c_driver isl1208_driver;
61
62
63
64

/* block read */
static int
isl1208_i2c_read_regs(struct i2c_client *client, u8 reg, u8 buf[],
65
		      unsigned len)
66
67
68
{
	u8 reg_addr[1] = { reg };
	struct i2c_msg msgs[2] = {
69
70
71
		{client->addr, 0, sizeof(reg_addr), reg_addr}
		,
		{client->addr, I2C_M_RD, len, buf}
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
	};
	int ret;

	BUG_ON(reg > ISL1208_REG_USR2);
	BUG_ON(reg + len > ISL1208_REG_USR2 + 1);

	ret = i2c_transfer(client->adapter, msgs, 2);
	if (ret > 0)
		ret = 0;
	return ret;
}

/* block write */
static int
isl1208_i2c_set_regs(struct i2c_client *client, u8 reg, u8 const buf[],
87
		     unsigned len)
88
89
90
{
	u8 i2c_buf[ISL1208_REG_USR2 + 2];
	struct i2c_msg msgs[1] = {
91
		{client->addr, 0, len + 1, i2c_buf}
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
	};
	int ret;

	BUG_ON(reg > ISL1208_REG_USR2);
	BUG_ON(reg + len > ISL1208_REG_USR2 + 1);

	i2c_buf[0] = reg;
	memcpy(&i2c_buf[1], &buf[0], len);

	ret = i2c_transfer(client->adapter, msgs, 1);
	if (ret > 0)
		ret = 0;
	return ret;
}

/* simple check to see wether we have a isl1208 */
108
109
static int
isl1208_i2c_validate_client(struct i2c_client *client)
110
111
112
113
114
115
116
117
118
119
120
121
122
{
	u8 regs[ISL1208_RTC_SECTION_LEN] = { 0, };
	u8 zero_mask[ISL1208_RTC_SECTION_LEN] = {
		0x80, 0x80, 0x40, 0xc0, 0xe0, 0x00, 0xf8
	};
	int i;
	int ret;

	ret = isl1208_i2c_read_regs(client, 0, regs, ISL1208_RTC_SECTION_LEN);
	if (ret < 0)
		return ret;

	for (i = 0; i < ISL1208_RTC_SECTION_LEN; ++i) {
123
		if (regs[i] & zero_mask[i])	/* check if bits are cleared */
124
125
126
127
128
129
			return -ENODEV;
	}

	return 0;
}

130
131
static int
isl1208_i2c_get_sr(struct i2c_client *client)
132
{
133
134
135
136
137
	int sr = i2c_smbus_read_byte_data(client, ISL1208_REG_SR);
	if (sr < 0)
		return -EIO;

	return sr;
138
139
}

140
141
static int
isl1208_i2c_get_atr(struct i2c_client *client)
142
143
144
{
	int atr = i2c_smbus_read_byte_data(client, ISL1208_REG_ATR);
	if (atr < 0)
145
		return atr;
146
147
148
149
150
151
152
153
154
155
156
157

	/* The 6bit value in the ATR register controls the load
	 * capacitance C_load * in steps of 0.25pF
	 *
	 * bit (1<<5) of the ATR register is inverted
	 *
	 * C_load(ATR=0x20) =  4.50pF
	 * C_load(ATR=0x00) = 12.50pF
	 * C_load(ATR=0x1f) = 20.25pF
	 *
	 */

158
159
160
	atr &= 0x3f;		/* mask out lsb */
	atr ^= 1 << 5;		/* invert 6th bit */
	atr += 2 * 9;		/* add offset of 4.5pF; unit[atr] = 0.25pF */
161
162
163
164

	return atr;
}

165
166
static int
isl1208_i2c_get_dtr(struct i2c_client *client)
167
168
169
170
171
172
{
	int dtr = i2c_smbus_read_byte_data(client, ISL1208_REG_DTR);
	if (dtr < 0)
		return -EIO;

	/* dtr encodes adjustments of {-60,-40,-20,0,20,40,60} ppm */
173
	dtr = ((dtr & 0x3) * 20) * (dtr & (1 << 2) ? -1 : 1);
174
175
176
177

	return dtr;
}

178
179
static int
isl1208_i2c_get_usr(struct i2c_client *client)
180
181
182
183
{
	u8 buf[ISL1208_USR_SECTION_LEN] = { 0, };
	int ret;

184
185
	ret = isl1208_i2c_read_regs(client, ISL1208_REG_USR1, buf,
				    ISL1208_USR_SECTION_LEN);
186
187
188
189
190
191
	if (ret < 0)
		return ret;

	return (buf[1] << 8) | buf[0];
}

192
193
static int
isl1208_i2c_set_usr(struct i2c_client *client, u16 usr)
194
195
196
197
198
199
{
	u8 buf[ISL1208_USR_SECTION_LEN];

	buf[0] = usr & 0xff;
	buf[1] = (usr >> 8) & 0xff;

200
201
	return isl1208_i2c_set_regs(client, ISL1208_REG_USR1, buf,
				    ISL1208_USR_SECTION_LEN);
202
203
}

204
205
static int
isl1208_rtc_proc(struct device *dev, struct seq_file *seq)
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
{
	struct i2c_client *const client = to_i2c_client(dev);
	int sr, dtr, atr, usr;

	sr = isl1208_i2c_get_sr(client);
	if (sr < 0) {
		dev_err(&client->dev, "%s: reading SR failed\n", __func__);
		return sr;
	}

	seq_printf(seq, "status_reg\t:%s%s%s%s%s%s (0x%.2x)\n",
		   (sr & ISL1208_REG_SR_RTCF) ? " RTCF" : "",
		   (sr & ISL1208_REG_SR_BAT) ? " BAT" : "",
		   (sr & ISL1208_REG_SR_ALM) ? " ALM" : "",
		   (sr & ISL1208_REG_SR_WRTC) ? " WRTC" : "",
		   (sr & ISL1208_REG_SR_XTOSCB) ? " XTOSCB" : "",
222
		   (sr & ISL1208_REG_SR_ARST) ? " ARST" : "", sr);
223
224
225
226
227

	seq_printf(seq, "batt_status\t: %s\n",
		   (sr & ISL1208_REG_SR_RTCF) ? "bad" : "okay");

	dtr = isl1208_i2c_get_dtr(client);
228
	if (dtr >= 0 - 1)
229
230
231
232
233
		seq_printf(seq, "digital_trim\t: %d ppm\n", dtr);

	atr = isl1208_i2c_get_atr(client);
	if (atr >= 0)
		seq_printf(seq, "analog_trim\t: %d.%.2d pF\n",
234
			   atr >> 2, (atr & 0x3) * 25);
235
236
237
238
239
240
241
242

	usr = isl1208_i2c_get_usr(client);
	if (usr >= 0)
		seq_printf(seq, "user_data\t: 0x%.4x\n", usr);

	return 0;
}

243
244
static int
isl1208_i2c_read_time(struct i2c_client *client, struct rtc_time *tm)
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
{
	int sr;
	u8 regs[ISL1208_RTC_SECTION_LEN] = { 0, };

	sr = isl1208_i2c_get_sr(client);
	if (sr < 0) {
		dev_err(&client->dev, "%s: reading SR failed\n", __func__);
		return -EIO;
	}

	sr = isl1208_i2c_read_regs(client, 0, regs, ISL1208_RTC_SECTION_LEN);
	if (sr < 0) {
		dev_err(&client->dev, "%s: reading RTC section failed\n",
			__func__);
		return sr;
	}

262
263
	tm->tm_sec = bcd2bin(regs[ISL1208_REG_SC]);
	tm->tm_min = bcd2bin(regs[ISL1208_REG_MN]);
264
265
266

	/* HR field has a more complex interpretation */
	{
267
		const u8 _hr = regs[ISL1208_REG_HR];
268
		if (_hr & ISL1208_REG_HR_MIL)	/* 24h format */
269
			tm->tm_hour = bcd2bin(_hr & 0x3f);
270
271
		else {
			/* 12h format */
272
			tm->tm_hour = bcd2bin(_hr & 0x1f);
273
			if (_hr & ISL1208_REG_HR_PM)	/* PM flag set */
274
275
276
277
				tm->tm_hour += 12;
		}
	}

278
279
280
281
	tm->tm_mday = bcd2bin(regs[ISL1208_REG_DT]);
	tm->tm_mon = bcd2bin(regs[ISL1208_REG_MO]) - 1;	/* rtc starts at 1 */
	tm->tm_year = bcd2bin(regs[ISL1208_REG_YR]) + 100;
	tm->tm_wday = bcd2bin(regs[ISL1208_REG_DW]);
282
283
284
285

	return 0;
}

286
287
static int
isl1208_i2c_read_alarm(struct i2c_client *client, struct rtc_wkalrm *alarm)
288
289
290
291
292
293
294
295
296
297
298
299
{
	struct rtc_time *const tm = &alarm->time;
	u8 regs[ISL1208_ALARM_SECTION_LEN] = { 0, };
	int sr;

	sr = isl1208_i2c_get_sr(client);
	if (sr < 0) {
		dev_err(&client->dev, "%s: reading SR failed\n", __func__);
		return sr;
	}

	sr = isl1208_i2c_read_regs(client, ISL1208_REG_SCA, regs,
300
				   ISL1208_ALARM_SECTION_LEN);
301
302
303
304
305
306
307
	if (sr < 0) {
		dev_err(&client->dev, "%s: reading alarm section failed\n",
			__func__);
		return sr;
	}

	/* MSB of each alarm register is an enable bit */
308
309
310
311
	tm->tm_sec = bcd2bin(regs[ISL1208_REG_SCA - ISL1208_REG_SCA] & 0x7f);
	tm->tm_min = bcd2bin(regs[ISL1208_REG_MNA - ISL1208_REG_SCA] & 0x7f);
	tm->tm_hour = bcd2bin(regs[ISL1208_REG_HRA - ISL1208_REG_SCA] & 0x3f);
	tm->tm_mday = bcd2bin(regs[ISL1208_REG_DTA - ISL1208_REG_SCA] & 0x3f);
312
	tm->tm_mon =
313
314
		bcd2bin(regs[ISL1208_REG_MOA - ISL1208_REG_SCA] & 0x1f) - 1;
	tm->tm_wday = bcd2bin(regs[ISL1208_REG_DWA - ISL1208_REG_SCA] & 0x03);
315
316
317
318

	return 0;
}

319
320
static int
isl1208_rtc_read_time(struct device *dev, struct rtc_time *tm)
321
322
323
324
{
	return isl1208_i2c_read_time(to_i2c_client(dev), tm);
}

325
326
static int
isl1208_i2c_set_time(struct i2c_client *client, struct rtc_time const *tm)
327
328
329
330
{
	int sr;
	u8 regs[ISL1208_RTC_SECTION_LEN] = { 0, };

331
332
333
334
335
336
337
	/* The clock has an 8 bit wide bcd-coded register (they never learn)
	 * for the year. tm_year is an offset from 1900 and we are interested
	 * in the 2000-2099 range, so any value less than 100 is invalid.
	 */
	if (tm->tm_year < 100)
		return -EINVAL;

338
339
340
	regs[ISL1208_REG_SC] = bin2bcd(tm->tm_sec);
	regs[ISL1208_REG_MN] = bin2bcd(tm->tm_min);
	regs[ISL1208_REG_HR] = bin2bcd(tm->tm_hour) | ISL1208_REG_HR_MIL;
341

342
343
344
	regs[ISL1208_REG_DT] = bin2bcd(tm->tm_mday);
	regs[ISL1208_REG_MO] = bin2bcd(tm->tm_mon + 1);
	regs[ISL1208_REG_YR] = bin2bcd(tm->tm_year - 100);
345

346
	regs[ISL1208_REG_DW] = bin2bcd(tm->tm_wday & 7);
347
348
349
350
351
352
353
354

	sr = isl1208_i2c_get_sr(client);
	if (sr < 0) {
		dev_err(&client->dev, "%s: reading SR failed\n", __func__);
		return sr;
	}

	/* set WRTC */
355
	sr = i2c_smbus_write_byte_data(client, ISL1208_REG_SR,
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
				       sr | ISL1208_REG_SR_WRTC);
	if (sr < 0) {
		dev_err(&client->dev, "%s: writing SR failed\n", __func__);
		return sr;
	}

	/* write RTC registers */
	sr = isl1208_i2c_set_regs(client, 0, regs, ISL1208_RTC_SECTION_LEN);
	if (sr < 0) {
		dev_err(&client->dev, "%s: writing RTC section failed\n",
			__func__);
		return sr;
	}

	/* clear WRTC again */
371
	sr = i2c_smbus_write_byte_data(client, ISL1208_REG_SR,
372
373
374
375
376
377
378
379
380
381
				       sr & ~ISL1208_REG_SR_WRTC);
	if (sr < 0) {
		dev_err(&client->dev, "%s: writing SR failed\n", __func__);
		return sr;
	}

	return 0;
}


382
383
static int
isl1208_rtc_set_time(struct device *dev, struct rtc_time *tm)
384
385
386
387
{
	return isl1208_i2c_set_time(to_i2c_client(dev), tm);
}

388
389
static int
isl1208_rtc_read_alarm(struct device *dev, struct rtc_wkalrm *alarm)
390
391
392
393
{
	return isl1208_i2c_read_alarm(to_i2c_client(dev), alarm);
}

394
static const struct rtc_class_ops isl1208_rtc_ops = {
395
396
397
398
399
	.proc = isl1208_rtc_proc,
	.read_time = isl1208_rtc_read_time,
	.set_time = isl1208_rtc_set_time,
	.read_alarm = isl1208_rtc_read_alarm,
	/*.set_alarm    = isl1208_rtc_set_alarm, */
400
401
402
403
};

/* sysfs interface */

404
405
406
static ssize_t
isl1208_sysfs_show_atrim(struct device *dev,
			 struct device_attribute *attr, char *buf)
407
{
408
	int atr = isl1208_i2c_get_atr(to_i2c_client(dev));
409
410
411
	if (atr < 0)
		return atr;

412
	return sprintf(buf, "%d.%.2d pF\n", atr >> 2, (atr & 0x3) * 25);
413
}
414

415
416
static DEVICE_ATTR(atrim, S_IRUGO, isl1208_sysfs_show_atrim, NULL);

417
418
419
static ssize_t
isl1208_sysfs_show_dtrim(struct device *dev,
			 struct device_attribute *attr, char *buf)
420
{
421
	int dtr = isl1208_i2c_get_dtr(to_i2c_client(dev));
422
423
424
425
426
	if (dtr < 0)
		return dtr;

	return sprintf(buf, "%d ppm\n", dtr);
}
427

428
429
static DEVICE_ATTR(dtrim, S_IRUGO, isl1208_sysfs_show_dtrim, NULL);

430
431
432
static ssize_t
isl1208_sysfs_show_usr(struct device *dev,
		       struct device_attribute *attr, char *buf)
433
{
434
	int usr = isl1208_i2c_get_usr(to_i2c_client(dev));
435
436
437
438
439
440
	if (usr < 0)
		return usr;

	return sprintf(buf, "0x%.4x\n", usr);
}

441
442
443
444
static ssize_t
isl1208_sysfs_store_usr(struct device *dev,
			struct device_attribute *attr,
			const char *buf, size_t count)
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
{
	int usr = -1;

	if (buf[0] == '0' && (buf[1] == 'x' || buf[1] == 'X')) {
		if (sscanf(buf, "%x", &usr) != 1)
			return -EINVAL;
	} else {
		if (sscanf(buf, "%d", &usr) != 1)
			return -EINVAL;
	}

	if (usr < 0 || usr > 0xffff)
		return -EINVAL;

	return isl1208_i2c_set_usr(to_i2c_client(dev), usr) ? -EIO : count;
}
461

462
463
464
static DEVICE_ATTR(usr, S_IRUGO | S_IWUSR, isl1208_sysfs_show_usr,
		   isl1208_sysfs_store_usr);

465
466
467
468
469
470
static struct attribute *isl1208_rtc_attrs[] = {
	&dev_attr_atrim.attr,
	&dev_attr_dtrim.attr,
	&dev_attr_usr.attr,
	NULL
};
471

472
473
474
static const struct attribute_group isl1208_rtc_sysfs_files = {
	.attrs	= isl1208_rtc_attrs,
};
475
476

static int
477
isl1208_probe(struct i2c_client *client, const struct i2c_device_id *id)
478
479
480
{
	int rc = 0;
	struct rtc_device *rtc;
481

482
483
	if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C))
		return -ENODEV;
484

485
486
487
488
	if (isl1208_i2c_validate_client(client) < 0)
		return -ENODEV;

	dev_info(&client->dev,
489
490
491
		 "chip found, driver version " DRV_VERSION "\n");

	rtc = rtc_device_register(isl1208_driver.driver.name,
492
493
494
495
				  &client->dev, &isl1208_rtc_ops,
				  THIS_MODULE);
	if (IS_ERR(rtc))
		return PTR_ERR(rtc);
496

497
	i2c_set_clientdata(client, rtc);
498

499
	rc = isl1208_i2c_get_sr(client);
500
	if (rc < 0) {
501
502
		dev_err(&client->dev, "reading status failed\n");
		goto exit_unregister;
503
504
505
	}

	if (rc & ISL1208_REG_SR_RTCF)
506
		dev_warn(&client->dev, "rtc power failure detected, "
507
508
			 "please set clock.\n");

509
	rc = sysfs_create_group(&client->dev.kobj, &isl1208_rtc_sysfs_files);
510
511
	if (rc)
		goto exit_unregister;
512
513
514

	return 0;

515
exit_unregister:
516
517
	rtc_device_unregister(rtc);

518
	return rc;
519
520
521
}

static int
522
isl1208_remove(struct i2c_client *client)
523
{
524
	struct rtc_device *rtc = i2c_get_clientdata(client);
525

526
	sysfs_remove_group(&client->dev.kobj, &isl1208_rtc_sysfs_files);
527
	rtc_device_unregister(rtc);
528
529
530
531

	return 0;
}

532
533
534
535
536
537
static const struct i2c_device_id isl1208_id[] = {
	{ "isl1208", 0 },
	{ }
};
MODULE_DEVICE_TABLE(i2c, isl1208_id);

538
539
540
541
542
543
static struct i2c_driver isl1208_driver = {
	.driver = {
		   .name = "rtc-isl1208",
		   },
	.probe = isl1208_probe,
	.remove = isl1208_remove,
544
	.id_table = isl1208_id,
545
};
546

547
548
static int __init
isl1208_init(void)
549
550
551
552
{
	return i2c_add_driver(&isl1208_driver);
}

553
554
static void __exit
isl1208_exit(void)
555
556
557
558
559
560
561
562
563
564
565
{
	i2c_del_driver(&isl1208_driver);
}

MODULE_AUTHOR("Herbert Valerio Riedel <hvr@gnu.org>");
MODULE_DESCRIPTION("Intersil ISL1208 RTC driver");
MODULE_LICENSE("GPL");
MODULE_VERSION(DRV_VERSION);

module_init(isl1208_init);
module_exit(isl1208_exit);