2 * 1-wire busmaster driver for DS1WM and ASICs with embedded DS1WMs
3 * such as HP iPAQs (including h5xxx, h2200, and devices with ASIC3
6 * Copyright (c) 2004-2005, Szabolcs Gyurko <szabolcs.gyurko@tlt.hu>
7 * Copyright (c) 2004-2007, Matt Reimer <mreimer@vpop.net>
9 * Use consistent with the GNU GPL is permitted,
10 * provided that this copyright notice is
11 * preserved in its entirety in all copies and derived works.
14 #include <linux/module.h>
15 #include <linux/interrupt.h>
16 #include <linux/irq.h>
18 #include <linux/platform_device.h>
19 #include <linux/clk.h>
20 #include <linux/err.h>
21 #include <linux/delay.h>
22 #include <linux/mfd/core.h>
23 #include <linux/mfd/ds1wm.h>
28 #include "../w1_int.h"
31 #define DS1WM_CMD 0x00 /* R/W 4 bits command */
32 #define DS1WM_DATA 0x01 /* R/W 8 bits, transmit/receive buffer */
33 #define DS1WM_INT 0x02 /* R/W interrupt status */
34 #define DS1WM_INT_EN 0x03 /* R/W interrupt enable */
35 #define DS1WM_CLKDIV 0x04 /* R/W 5 bits of divisor and pre-scale */
37 #define DS1WM_CMD_1W_RESET (1 << 0) /* force reset on 1-wire bus */
38 #define DS1WM_CMD_SRA (1 << 1) /* enable Search ROM accelerator mode */
39 #define DS1WM_CMD_DQ_OUTPUT (1 << 2) /* write only - forces bus low */
40 #define DS1WM_CMD_DQ_INPUT (1 << 3) /* read only - reflects state of bus */
41 #define DS1WM_CMD_RST (1 << 5) /* software reset */
42 #define DS1WM_CMD_OD (1 << 7) /* overdrive */
44 #define DS1WM_INT_PD (1 << 0) /* presence detect */
45 #define DS1WM_INT_PDR (1 << 1) /* presence detect result */
46 #define DS1WM_INT_TBE (1 << 2) /* tx buffer empty */
47 #define DS1WM_INT_TSRE (1 << 3) /* tx shift register empty */
48 #define DS1WM_INT_RBF (1 << 4) /* rx buffer full */
49 #define DS1WM_INT_RSRF (1 << 5) /* rx shift register full */
51 #define DS1WM_INTEN_EPD (1 << 0) /* enable presence detect int */
52 #define DS1WM_INTEN_IAS (1 << 1) /* INTR active state */
53 #define DS1WM_INTEN_ETBE (1 << 2) /* enable tx buffer empty int */
54 #define DS1WM_INTEN_ETMT (1 << 3) /* enable tx shift register empty int */
55 #define DS1WM_INTEN_ERBF (1 << 4) /* enable rx buffer full int */
56 #define DS1WM_INTEN_ERSRF (1 << 5) /* enable rx shift register full int */
57 #define DS1WM_INTEN_DQO (1 << 6) /* enable direct bus driving ops */
60 #define DS1WM_TIMEOUT (HZ * 5)
64 unsigned long divisor;
91 int bus_shift; /* # of shifts to calc register offsets */
92 struct platform_device *pdev;
93 struct mfd_cell *cell;
100 void *write_complete;
101 u8 read_byte; /* last byte received */
104 static inline void ds1wm_write_register(struct ds1wm_data *ds1wm_data, u32 reg,
107 __raw_writeb(val, ds1wm_data->map + (reg << ds1wm_data->bus_shift));
110 static inline u8 ds1wm_read_register(struct ds1wm_data *ds1wm_data, u32 reg)
112 return __raw_readb(ds1wm_data->map + (reg << ds1wm_data->bus_shift));
116 static irqreturn_t ds1wm_isr(int isr, void *data)
118 struct ds1wm_data *ds1wm_data = data;
119 u8 intr = ds1wm_read_register(ds1wm_data, DS1WM_INT);
121 ds1wm_data->slave_present = (intr & DS1WM_INT_PDR) ? 0 : 1;
123 if ((intr & DS1WM_INT_PD) && ds1wm_data->reset_complete)
124 complete(ds1wm_data->reset_complete);
126 if ((intr & DS1WM_INT_TSRE) && ds1wm_data->write_complete)
127 complete(ds1wm_data->write_complete);
129 if (intr & DS1WM_INT_RBF) {
130 ds1wm_data->read_byte = ds1wm_read_register(ds1wm_data,
132 if (ds1wm_data->read_complete)
133 complete(ds1wm_data->read_complete);
139 static int ds1wm_reset(struct ds1wm_data *ds1wm_data)
141 unsigned long timeleft;
142 DECLARE_COMPLETION_ONSTACK(reset_done);
144 ds1wm_data->reset_complete = &reset_done;
146 ds1wm_write_register(ds1wm_data, DS1WM_INT_EN, DS1WM_INTEN_EPD |
147 (ds1wm_data->active_high ? DS1WM_INTEN_IAS : 0));
149 ds1wm_write_register(ds1wm_data, DS1WM_CMD, DS1WM_CMD_1W_RESET);
151 timeleft = wait_for_completion_timeout(&reset_done, DS1WM_TIMEOUT);
152 ds1wm_data->reset_complete = NULL;
154 dev_err(&ds1wm_data->pdev->dev, "reset failed\n");
158 /* Wait for the end of the reset. According to the specs, the time
159 * from when the interrupt is asserted to the end of the reset is:
160 * tRSTH - tPDH - tPDL - tPDI
161 * 625 us - 60 us - 240 us - 100 ns = 324.9 us
163 * We'll wait a bit longer just to be sure.
164 * Was udelay(500), but if it is going to busywait the cpu that long,
165 * might as well come back later.
169 ds1wm_write_register(ds1wm_data, DS1WM_INT_EN,
170 DS1WM_INTEN_ERBF | DS1WM_INTEN_ETMT | DS1WM_INTEN_EPD |
171 (ds1wm_data->active_high ? DS1WM_INTEN_IAS : 0));
173 if (!ds1wm_data->slave_present) {
174 dev_dbg(&ds1wm_data->pdev->dev, "reset: no devices found\n");
181 static int ds1wm_write(struct ds1wm_data *ds1wm_data, u8 data)
183 DECLARE_COMPLETION_ONSTACK(write_done);
184 ds1wm_data->write_complete = &write_done;
186 ds1wm_write_register(ds1wm_data, DS1WM_DATA, data);
188 wait_for_completion_timeout(&write_done, DS1WM_TIMEOUT);
189 ds1wm_data->write_complete = NULL;
194 static int ds1wm_read(struct ds1wm_data *ds1wm_data, unsigned char write_data)
196 DECLARE_COMPLETION_ONSTACK(read_done);
197 ds1wm_data->read_complete = &read_done;
199 ds1wm_write(ds1wm_data, write_data);
200 wait_for_completion_timeout(&read_done, DS1WM_TIMEOUT);
201 ds1wm_data->read_complete = NULL;
203 return ds1wm_data->read_byte;
206 static int ds1wm_find_divisor(int gclk)
210 for (i = 0; i < ARRAY_SIZE(freq); i++)
211 if (gclk <= freq[i].freq)
212 return freq[i].divisor;
217 static void ds1wm_up(struct ds1wm_data *ds1wm_data)
221 if (ds1wm_data->cell->enable)
222 ds1wm_data->cell->enable(ds1wm_data->pdev);
224 gclk = clk_get_rate(ds1wm_data->clk);
225 clk_enable(ds1wm_data->clk);
226 divisor = ds1wm_find_divisor(gclk);
228 dev_err(&ds1wm_data->pdev->dev,
229 "no suitable divisor for %dHz clock\n", gclk);
232 ds1wm_write_register(ds1wm_data, DS1WM_CLKDIV, divisor);
234 /* Let the w1 clock stabilize. */
237 ds1wm_reset(ds1wm_data);
240 static void ds1wm_down(struct ds1wm_data *ds1wm_data)
242 ds1wm_reset(ds1wm_data);
244 /* Disable interrupts. */
245 ds1wm_write_register(ds1wm_data, DS1WM_INT_EN,
246 ds1wm_data->active_high ? DS1WM_INTEN_IAS : 0);
248 if (ds1wm_data->cell->disable)
249 ds1wm_data->cell->disable(ds1wm_data->pdev);
251 clk_disable(ds1wm_data->clk);
254 /* --------------------------------------------------------------------- */
257 static u8 ds1wm_read_byte(void *data)
259 struct ds1wm_data *ds1wm_data = data;
261 return ds1wm_read(ds1wm_data, 0xff);
264 static void ds1wm_write_byte(void *data, u8 byte)
266 struct ds1wm_data *ds1wm_data = data;
268 ds1wm_write(ds1wm_data, byte);
271 static u8 ds1wm_reset_bus(void *data)
273 struct ds1wm_data *ds1wm_data = data;
275 ds1wm_reset(ds1wm_data);
280 static void ds1wm_search(void *data, struct w1_master *master_dev,
281 u8 search_type, w1_slave_found_callback slave_found)
283 struct ds1wm_data *ds1wm_data = data;
285 unsigned long long rom_id;
287 /* XXX We need to iterate for multiple devices per the DS1WM docs.
288 * See http://www.maxim-ic.com/appnotes.cfm/appnote_number/120. */
289 if (ds1wm_reset(ds1wm_data))
292 ds1wm_write(ds1wm_data, search_type);
293 ds1wm_write_register(ds1wm_data, DS1WM_CMD, DS1WM_CMD_SRA);
295 for (rom_id = 0, i = 0; i < 16; i++) {
297 unsigned char resp, r, d;
299 resp = ds1wm_read(ds1wm_data, 0x00);
301 r = ((resp & 0x02) >> 1) |
302 ((resp & 0x08) >> 2) |
303 ((resp & 0x20) >> 3) |
304 ((resp & 0x80) >> 4);
306 d = ((resp & 0x01) >> 0) |
307 ((resp & 0x04) >> 1) |
308 ((resp & 0x10) >> 2) |
309 ((resp & 0x40) >> 3);
311 rom_id |= (unsigned long long) r << (i * 4);
314 dev_dbg(&ds1wm_data->pdev->dev, "found 0x%08llX\n", rom_id);
316 ds1wm_write_register(ds1wm_data, DS1WM_CMD, ~DS1WM_CMD_SRA);
317 ds1wm_reset(ds1wm_data);
319 slave_found(master_dev, rom_id);
322 /* --------------------------------------------------------------------- */
324 static struct w1_bus_master ds1wm_master = {
325 .read_byte = ds1wm_read_byte,
326 .write_byte = ds1wm_write_byte,
327 .reset_bus = ds1wm_reset_bus,
328 .search = ds1wm_search,
331 static int ds1wm_probe(struct platform_device *pdev)
333 struct ds1wm_data *ds1wm_data;
334 struct ds1wm_driver_data *plat;
335 struct resource *res;
336 struct mfd_cell *cell;
342 cell = pdev->dev.platform_data;
346 ds1wm_data = kzalloc(sizeof(*ds1wm_data), GFP_KERNEL);
350 platform_set_drvdata(pdev, ds1wm_data);
352 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
357 ds1wm_data->map = ioremap(res->start, resource_size(res));
358 if (!ds1wm_data->map) {
362 plat = cell->driver_data;
364 /* calculate bus shift from mem resource */
365 ds1wm_data->bus_shift = resource_size(res) >> 3;
367 ds1wm_data->pdev = pdev;
368 ds1wm_data->cell = cell;
370 res = platform_get_resource(pdev, IORESOURCE_IRQ, 0);
375 ds1wm_data->irq = res->start;
376 ds1wm_data->active_high = plat->active_high;
378 if (res->flags & IORESOURCE_IRQ_HIGHEDGE)
379 set_irq_type(ds1wm_data->irq, IRQ_TYPE_EDGE_RISING);
380 if (res->flags & IORESOURCE_IRQ_LOWEDGE)
381 set_irq_type(ds1wm_data->irq, IRQ_TYPE_EDGE_FALLING);
383 ret = request_irq(ds1wm_data->irq, ds1wm_isr, IRQF_DISABLED,
384 "ds1wm", ds1wm_data);
388 ds1wm_data->clk = clk_get(&pdev->dev, "ds1wm");
389 if (IS_ERR(ds1wm_data->clk)) {
390 ret = PTR_ERR(ds1wm_data->clk);
394 ds1wm_up(ds1wm_data);
396 ds1wm_master.data = (void *)ds1wm_data;
398 ret = w1_add_master_device(&ds1wm_master);
405 ds1wm_down(ds1wm_data);
406 clk_put(ds1wm_data->clk);
408 free_irq(ds1wm_data->irq, ds1wm_data);
410 iounmap(ds1wm_data->map);
418 static int ds1wm_suspend(struct platform_device *pdev, pm_message_t state)
420 struct ds1wm_data *ds1wm_data = platform_get_drvdata(pdev);
422 ds1wm_down(ds1wm_data);
427 static int ds1wm_resume(struct platform_device *pdev)
429 struct ds1wm_data *ds1wm_data = platform_get_drvdata(pdev);
431 ds1wm_up(ds1wm_data);
436 #define ds1wm_suspend NULL
437 #define ds1wm_resume NULL
440 static int ds1wm_remove(struct platform_device *pdev)
442 struct ds1wm_data *ds1wm_data = platform_get_drvdata(pdev);
444 w1_remove_master_device(&ds1wm_master);
445 ds1wm_down(ds1wm_data);
446 clk_put(ds1wm_data->clk);
447 free_irq(ds1wm_data->irq, ds1wm_data);
448 iounmap(ds1wm_data->map);
454 static struct platform_driver ds1wm_driver = {
458 .probe = ds1wm_probe,
459 .remove = ds1wm_remove,
460 .suspend = ds1wm_suspend,
461 .resume = ds1wm_resume
464 static int __init ds1wm_init(void)
466 printk("DS1WM w1 busmaster driver - (c) 2004 Szabolcs Gyurko\n");
467 return platform_driver_register(&ds1wm_driver);
470 static void __exit ds1wm_exit(void)
472 platform_driver_unregister(&ds1wm_driver);
475 module_init(ds1wm_init);
476 module_exit(ds1wm_exit);
478 MODULE_LICENSE("GPL");
479 MODULE_AUTHOR("Szabolcs Gyurko <szabolcs.gyurko@tlt.hu>, "
480 "Matt Reimer <mreimer@vpop.net>");
481 MODULE_DESCRIPTION("DS1WM w1 busmaster driver");