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/ds1wm.h>
27 #include "../w1_int.h"
30 #define DS1WM_CMD 0x00 /* R/W 4 bits command */
31 #define DS1WM_DATA 0x01 /* R/W 8 bits, transmit/receive buffer */
32 #define DS1WM_INT 0x02 /* R/W interrupt status */
33 #define DS1WM_INT_EN 0x03 /* R/W interrupt enable */
34 #define DS1WM_CLKDIV 0x04 /* R/W 5 bits of divisor and pre-scale */
36 #define DS1WM_CMD_1W_RESET (1 << 0) /* force reset on 1-wire bus */
37 #define DS1WM_CMD_SRA (1 << 1) /* enable Search ROM accelerator mode */
38 #define DS1WM_CMD_DQ_OUTPUT (1 << 2) /* write only - forces bus low */
39 #define DS1WM_CMD_DQ_INPUT (1 << 3) /* read only - reflects state of bus */
40 #define DS1WM_CMD_RST (1 << 5) /* software reset */
41 #define DS1WM_CMD_OD (1 << 7) /* overdrive */
43 #define DS1WM_INT_PD (1 << 0) /* presence detect */
44 #define DS1WM_INT_PDR (1 << 1) /* presence detect result */
45 #define DS1WM_INT_TBE (1 << 2) /* tx buffer empty */
46 #define DS1WM_INT_TSRE (1 << 3) /* tx shift register empty */
47 #define DS1WM_INT_RBF (1 << 4) /* rx buffer full */
48 #define DS1WM_INT_RSRF (1 << 5) /* rx shift register full */
50 #define DS1WM_INTEN_EPD (1 << 0) /* enable presence detect int */
51 #define DS1WM_INTEN_IAS (1 << 1) /* INTR active state */
52 #define DS1WM_INTEN_ETBE (1 << 2) /* enable tx buffer empty int */
53 #define DS1WM_INTEN_ETMT (1 << 3) /* enable tx shift register empty int */
54 #define DS1WM_INTEN_ERBF (1 << 4) /* enable rx buffer full int */
55 #define DS1WM_INTEN_ERSRF (1 << 5) /* enable rx shift register full int */
56 #define DS1WM_INTEN_DQO (1 << 6) /* enable direct bus driving ops */
59 #define DS1WM_TIMEOUT (HZ * 5)
63 unsigned long divisor
;
90 int bus_shift
; /* # of shifts to calc register offsets */
91 struct platform_device
*pdev
;
92 struct ds1wm_platform_data
*pdata
;
100 u8 read_byte
; /* last byte received */
103 static inline void ds1wm_write_register(struct ds1wm_data
*ds1wm_data
, u32 reg
,
106 __raw_writeb(val
, ds1wm_data
->map
+ (reg
<< ds1wm_data
->bus_shift
));
109 static inline u8
ds1wm_read_register(struct ds1wm_data
*ds1wm_data
, u32 reg
)
111 return __raw_readb(ds1wm_data
->map
+ (reg
<< ds1wm_data
->bus_shift
));
115 static irqreturn_t
ds1wm_isr(int isr
, void *data
)
117 struct ds1wm_data
*ds1wm_data
= data
;
118 u8 intr
= ds1wm_read_register(ds1wm_data
, DS1WM_INT
);
120 ds1wm_data
->slave_present
= (intr
& DS1WM_INT_PDR
) ? 0 : 1;
122 if ((intr
& DS1WM_INT_PD
) && ds1wm_data
->reset_complete
)
123 complete(ds1wm_data
->reset_complete
);
125 if ((intr
& DS1WM_INT_TSRE
) && ds1wm_data
->write_complete
)
126 complete(ds1wm_data
->write_complete
);
128 if (intr
& DS1WM_INT_RBF
) {
129 ds1wm_data
->read_byte
= ds1wm_read_register(ds1wm_data
,
131 if (ds1wm_data
->read_complete
)
132 complete(ds1wm_data
->read_complete
);
138 static int ds1wm_reset(struct ds1wm_data
*ds1wm_data
)
140 unsigned long timeleft
;
141 DECLARE_COMPLETION_ONSTACK(reset_done
);
143 ds1wm_data
->reset_complete
= &reset_done
;
145 ds1wm_write_register(ds1wm_data
, DS1WM_INT_EN
, DS1WM_INTEN_EPD
|
146 (ds1wm_data
->active_high
? DS1WM_INTEN_IAS
: 0));
148 ds1wm_write_register(ds1wm_data
, DS1WM_CMD
, DS1WM_CMD_1W_RESET
);
150 timeleft
= wait_for_completion_timeout(&reset_done
, DS1WM_TIMEOUT
);
151 ds1wm_data
->reset_complete
= NULL
;
153 dev_err(&ds1wm_data
->pdev
->dev
, "reset failed\n");
157 /* Wait for the end of the reset. According to the specs, the time
158 * from when the interrupt is asserted to the end of the reset is:
159 * tRSTH - tPDH - tPDL - tPDI
160 * 625 us - 60 us - 240 us - 100 ns = 324.9 us
162 * We'll wait a bit longer just to be sure.
166 ds1wm_write_register(ds1wm_data
, DS1WM_INT_EN
,
167 DS1WM_INTEN_ERBF
| DS1WM_INTEN_ETMT
| DS1WM_INTEN_EPD
|
168 (ds1wm_data
->active_high
? DS1WM_INTEN_IAS
: 0));
170 if (!ds1wm_data
->slave_present
) {
171 dev_dbg(&ds1wm_data
->pdev
->dev
, "reset: no devices found\n");
178 static int ds1wm_write(struct ds1wm_data
*ds1wm_data
, u8 data
)
180 DECLARE_COMPLETION_ONSTACK(write_done
);
181 ds1wm_data
->write_complete
= &write_done
;
183 ds1wm_write_register(ds1wm_data
, DS1WM_DATA
, data
);
185 wait_for_completion_timeout(&write_done
, DS1WM_TIMEOUT
);
186 ds1wm_data
->write_complete
= NULL
;
191 static int ds1wm_read(struct ds1wm_data
*ds1wm_data
, unsigned char write_data
)
193 DECLARE_COMPLETION_ONSTACK(read_done
);
194 ds1wm_data
->read_complete
= &read_done
;
196 ds1wm_write(ds1wm_data
, write_data
);
197 wait_for_completion_timeout(&read_done
, DS1WM_TIMEOUT
);
198 ds1wm_data
->read_complete
= NULL
;
200 return ds1wm_data
->read_byte
;
203 static int ds1wm_find_divisor(int gclk
)
207 for (i
= 0; i
< ARRAY_SIZE(freq
); i
++)
208 if (gclk
<= freq
[i
].freq
)
209 return freq
[i
].divisor
;
214 static void ds1wm_up(struct ds1wm_data
*ds1wm_data
)
218 if (ds1wm_data
->pdata
->enable
)
219 ds1wm_data
->pdata
->enable(ds1wm_data
->pdev
);
221 gclk
= clk_get_rate(ds1wm_data
->clk
);
222 clk_enable(ds1wm_data
->clk
);
223 divisor
= ds1wm_find_divisor(gclk
);
225 dev_err(&ds1wm_data
->pdev
->dev
,
226 "no suitable divisor for %dHz clock\n", gclk
);
229 ds1wm_write_register(ds1wm_data
, DS1WM_CLKDIV
, divisor
);
231 /* Let the w1 clock stabilize. */
234 ds1wm_reset(ds1wm_data
);
237 static void ds1wm_down(struct ds1wm_data
*ds1wm_data
)
239 ds1wm_reset(ds1wm_data
);
241 /* Disable interrupts. */
242 ds1wm_write_register(ds1wm_data
, DS1WM_INT_EN
,
243 ds1wm_data
->active_high
? DS1WM_INTEN_IAS
: 0);
245 if (ds1wm_data
->pdata
->disable
)
246 ds1wm_data
->pdata
->disable(ds1wm_data
->pdev
);
248 clk_disable(ds1wm_data
->clk
);
251 /* --------------------------------------------------------------------- */
254 static u8
ds1wm_read_byte(void *data
)
256 struct ds1wm_data
*ds1wm_data
= data
;
258 return ds1wm_read(ds1wm_data
, 0xff);
261 static void ds1wm_write_byte(void *data
, u8 byte
)
263 struct ds1wm_data
*ds1wm_data
= data
;
265 ds1wm_write(ds1wm_data
, byte
);
268 static u8
ds1wm_reset_bus(void *data
)
270 struct ds1wm_data
*ds1wm_data
= data
;
272 ds1wm_reset(ds1wm_data
);
277 static void ds1wm_search(void *data
, u8 search_type
,
278 w1_slave_found_callback slave_found
)
280 struct ds1wm_data
*ds1wm_data
= data
;
282 unsigned long long rom_id
;
284 /* XXX We need to iterate for multiple devices per the DS1WM docs.
285 * See http://www.maxim-ic.com/appnotes.cfm/appnote_number/120. */
286 if (ds1wm_reset(ds1wm_data
))
289 ds1wm_write(ds1wm_data
, search_type
);
290 ds1wm_write_register(ds1wm_data
, DS1WM_CMD
, DS1WM_CMD_SRA
);
292 for (rom_id
= 0, i
= 0; i
< 16; i
++) {
294 unsigned char resp
, r
, d
;
296 resp
= ds1wm_read(ds1wm_data
, 0x00);
298 r
= ((resp
& 0x02) >> 1) |
299 ((resp
& 0x08) >> 2) |
300 ((resp
& 0x20) >> 3) |
301 ((resp
& 0x80) >> 4);
303 d
= ((resp
& 0x01) >> 0) |
304 ((resp
& 0x04) >> 1) |
305 ((resp
& 0x10) >> 2) |
306 ((resp
& 0x40) >> 3);
308 rom_id
|= (unsigned long long) r
<< (i
* 4);
311 dev_dbg(&ds1wm_data
->pdev
->dev
, "found 0x%08llX\n", rom_id
);
313 ds1wm_write_register(ds1wm_data
, DS1WM_CMD
, ~DS1WM_CMD_SRA
);
314 ds1wm_reset(ds1wm_data
);
316 slave_found(ds1wm_data
, rom_id
);
319 /* --------------------------------------------------------------------- */
321 static struct w1_bus_master ds1wm_master
= {
322 .read_byte
= ds1wm_read_byte
,
323 .write_byte
= ds1wm_write_byte
,
324 .reset_bus
= ds1wm_reset_bus
,
325 .search
= ds1wm_search
,
328 static int ds1wm_probe(struct platform_device
*pdev
)
330 struct ds1wm_data
*ds1wm_data
;
331 struct ds1wm_platform_data
*plat
;
332 struct resource
*res
;
338 ds1wm_data
= kzalloc(sizeof(*ds1wm_data
), GFP_KERNEL
);
342 platform_set_drvdata(pdev
, ds1wm_data
);
344 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
349 ds1wm_data
->map
= ioremap(res
->start
, res
->end
- res
->start
+ 1);
350 if (!ds1wm_data
->map
) {
354 plat
= pdev
->dev
.platform_data
;
355 ds1wm_data
->bus_shift
= plat
->bus_shift
;
356 ds1wm_data
->pdev
= pdev
;
357 ds1wm_data
->pdata
= plat
;
359 res
= platform_get_resource(pdev
, IORESOURCE_IRQ
, 0);
364 ds1wm_data
->irq
= res
->start
;
365 ds1wm_data
->active_high
= plat
->active_high
;
367 if (res
->flags
& IORESOURCE_IRQ_HIGHEDGE
)
368 set_irq_type(ds1wm_data
->irq
, IRQ_TYPE_EDGE_RISING
);
369 if (res
->flags
& IORESOURCE_IRQ_LOWEDGE
)
370 set_irq_type(ds1wm_data
->irq
, IRQ_TYPE_EDGE_FALLING
);
372 ret
= request_irq(ds1wm_data
->irq
, ds1wm_isr
, IRQF_DISABLED
,
373 "ds1wm", ds1wm_data
);
377 ds1wm_data
->clk
= clk_get(&pdev
->dev
, "ds1wm");
378 if (IS_ERR(ds1wm_data
->clk
)) {
379 ret
= PTR_ERR(ds1wm_data
->clk
);
383 ds1wm_up(ds1wm_data
);
385 ds1wm_master
.data
= (void *)ds1wm_data
;
387 ret
= w1_add_master_device(&ds1wm_master
);
394 ds1wm_down(ds1wm_data
);
395 clk_put(ds1wm_data
->clk
);
397 free_irq(ds1wm_data
->irq
, ds1wm_data
);
399 iounmap(ds1wm_data
->map
);
407 static int ds1wm_suspend(struct platform_device
*pdev
, pm_message_t state
)
409 struct ds1wm_data
*ds1wm_data
= platform_get_drvdata(pdev
);
411 ds1wm_down(ds1wm_data
);
416 static int ds1wm_resume(struct platform_device
*pdev
)
418 struct ds1wm_data
*ds1wm_data
= platform_get_drvdata(pdev
);
420 ds1wm_up(ds1wm_data
);
425 #define ds1wm_suspend NULL
426 #define ds1wm_resume NULL
429 static int ds1wm_remove(struct platform_device
*pdev
)
431 struct ds1wm_data
*ds1wm_data
= platform_get_drvdata(pdev
);
433 w1_remove_master_device(&ds1wm_master
);
434 ds1wm_down(ds1wm_data
);
435 clk_put(ds1wm_data
->clk
);
436 free_irq(ds1wm_data
->irq
, ds1wm_data
);
437 iounmap(ds1wm_data
->map
);
443 static struct platform_driver ds1wm_driver
= {
447 .probe
= ds1wm_probe
,
448 .remove
= ds1wm_remove
,
449 .suspend
= ds1wm_suspend
,
450 .resume
= ds1wm_resume
453 static int __init
ds1wm_init(void)
455 printk("DS1WM w1 busmaster driver - (c) 2004 Szabolcs Gyurko\n");
456 return platform_driver_register(&ds1wm_driver
);
459 static void __exit
ds1wm_exit(void)
461 platform_driver_unregister(&ds1wm_driver
);
464 module_init(ds1wm_init
);
465 module_exit(ds1wm_exit
);
467 MODULE_LICENSE("GPL");
468 MODULE_AUTHOR("Szabolcs Gyurko <szabolcs.gyurko@tlt.hu>, "
469 "Matt Reimer <mreimer@vpop.net>");
470 MODULE_DESCRIPTION("DS1WM w1 busmaster driver");