2 * MicroWire interface driver for OMAP
4 * Copyright 2003 MontaVista Software Inc. <source@mvista.com>
6 * Ported to 2.6 OMAP uwire interface.
7 * Copyright (C) 2004 Texas Instruments.
9 * Generalization patches by Juha Yrjola <juha.yrjola@nokia.com>
11 * Copyright (C) 2005 David Brownell (ported to 2.6 SPI interface)
12 * Copyright (C) 2006 Nokia
14 * Many updates by Imre Deak <imre.deak@nokia.com>
16 * This program is free software; you can redistribute it and/or modify it
17 * under the terms of the GNU General Public License as published by the
18 * Free Software Foundation; either version 2 of the License, or (at your
19 * option) any later version.
21 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
22 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
23 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
27 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
28 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32 * You should have received a copy of the GNU General Public License along
33 * with this program; if not, write to the Free Software Foundation, Inc.,
34 * 675 Mass Ave, Cambridge, MA 02139, USA.
36 #include <linux/kernel.h>
37 #include <linux/init.h>
38 #include <linux/delay.h>
39 #include <linux/platform_device.h>
40 #include <linux/workqueue.h>
41 #include <linux/interrupt.h>
42 #include <linux/err.h>
43 #include <linux/clk.h>
44 #include <linux/slab.h>
46 #include <linux/spi/spi.h>
47 #include <linux/spi/spi_bitbang.h>
48 #include <linux/module.h>
51 #include <mach/hardware.h>
53 #include <asm/mach-types.h>
56 #include <plat/omap7xx.h> /* OMAP7XX_IO_CONF registers */
59 /* FIXME address is now a platform device resource,
60 * and irqs should show there too...
62 #define UWIRE_BASE_PHYS 0xFFFB3000
64 /* uWire Registers: */
65 #define UWIRE_IO_SIZE 0x20
66 #define UWIRE_TDR 0x00
67 #define UWIRE_RDR 0x00
68 #define UWIRE_CSR 0x01
69 #define UWIRE_SR1 0x02
70 #define UWIRE_SR2 0x03
71 #define UWIRE_SR3 0x04
72 #define UWIRE_SR4 0x05
73 #define UWIRE_SR5 0x06
76 #define RDRB (1 << 15)
77 #define CSRB (1 << 14)
78 #define START (1 << 13)
79 #define CS_CMD (1 << 12)
82 #define UWIRE_READ_FALLING_EDGE 0x0001
83 #define UWIRE_READ_RISING_EDGE 0x0000
84 #define UWIRE_WRITE_FALLING_EDGE 0x0000
85 #define UWIRE_WRITE_RISING_EDGE 0x0002
86 #define UWIRE_CS_ACTIVE_LOW 0x0000
87 #define UWIRE_CS_ACTIVE_HIGH 0x0004
88 #define UWIRE_FREQ_DIV_2 0x0000
89 #define UWIRE_FREQ_DIV_4 0x0008
90 #define UWIRE_FREQ_DIV_8 0x0010
91 #define UWIRE_CHK_READY 0x0020
92 #define UWIRE_CLK_INVERTED 0x0040
96 struct spi_bitbang bitbang
;
101 unsigned bits_per_word
;
105 /* REVISIT compile time constant for idx_shift? */
107 * Or, put it in a structure which is used throughout the driver;
108 * that avoids having to issue two loads for each bit of static data.
110 static unsigned int uwire_idx_shift
;
111 static void __iomem
*uwire_base
;
113 static inline void uwire_write_reg(int idx
, u16 val
)
115 __raw_writew(val
, uwire_base
+ (idx
<< uwire_idx_shift
));
118 static inline u16
uwire_read_reg(int idx
)
120 return __raw_readw(uwire_base
+ (idx
<< uwire_idx_shift
));
123 static inline void omap_uwire_configure_mode(u8 cs
, unsigned long flags
)
128 if (flags
& UWIRE_CLK_INVERTED
)
140 w
= uwire_read_reg(reg
);
141 w
&= ~(0x3f << shift
);
143 uwire_write_reg(reg
, w
);
146 static int wait_uwire_csr_flag(u16 mask
, u16 val
, int might_not_catch
)
150 unsigned long max_jiffies
= jiffies
+ HZ
;
153 w
= uwire_read_reg(UWIRE_CSR
);
154 if ((w
& mask
) == val
)
156 if (time_after(jiffies
, max_jiffies
)) {
157 printk(KERN_ERR
"%s: timeout. reg=%#06x "
158 "mask=%#06x val=%#06x\n",
159 __func__
, w
, mask
, val
);
163 if (might_not_catch
&& c
> 64)
169 static void uwire_set_clk1_div(int div1_idx
)
173 w
= uwire_read_reg(UWIRE_SR3
);
176 uwire_write_reg(UWIRE_SR3
, w
);
179 static void uwire_chipselect(struct spi_device
*spi
, int value
)
181 struct uwire_state
*ust
= spi
->controller_state
;
186 BUG_ON(wait_uwire_csr_flag(CSRB
, 0, 0));
188 w
= uwire_read_reg(UWIRE_CSR
);
189 old_cs
= (w
>> 10) & 0x03;
190 if (value
== BITBANG_CS_INACTIVE
|| old_cs
!= spi
->chip_select
) {
191 /* Deselect this CS, or the previous CS */
193 uwire_write_reg(UWIRE_CSR
, w
);
195 /* activate specfied chipselect */
196 if (value
== BITBANG_CS_ACTIVE
) {
197 uwire_set_clk1_div(ust
->div1_idx
);
199 if (spi
->mode
& SPI_CPOL
)
200 uwire_write_reg(UWIRE_SR4
, 1);
202 uwire_write_reg(UWIRE_SR4
, 0);
204 w
= spi
->chip_select
<< 10;
206 uwire_write_reg(UWIRE_CSR
, w
);
210 static int uwire_txrx(struct spi_device
*spi
, struct spi_transfer
*t
)
212 struct uwire_state
*ust
= spi
->controller_state
;
213 unsigned len
= t
->len
;
214 unsigned bits
= ust
->bits_per_word
;
219 if (!t
->tx_buf
&& !t
->rx_buf
)
222 /* Microwire doesn't read and write concurrently */
223 if (t
->tx_buf
&& t
->rx_buf
)
226 w
= spi
->chip_select
<< 10;
230 const u8
*buf
= t
->tx_buf
;
232 /* NOTE: DMA could be used for TX transfers */
234 /* write one or two bytes at a time */
236 /* tx bit 15 is first sent; we byteswap multibyte words
237 * (msb-first) on the way out from memory.
248 pr_debug("%s: write-%d =%04x\n",
249 dev_name(&spi
->dev
), bits
, val
);
251 if (wait_uwire_csr_flag(CSRB
, 0, 0))
254 uwire_write_reg(UWIRE_TDR
, val
);
257 val
= START
| w
| (bits
<< 5);
259 uwire_write_reg(UWIRE_CSR
, val
);
262 /* Wait till write actually starts.
263 * This is needed with MPU clock 60+ MHz.
264 * REVISIT: we may not have time to catch it...
266 if (wait_uwire_csr_flag(CSRB
, CSRB
, 1))
272 /* REVISIT: save this for later to get more i/o overlap */
273 if (wait_uwire_csr_flag(CSRB
, 0, 0))
276 } else if (t
->rx_buf
) {
279 /* read one or two bytes at a time */
287 val
= START
| w
| (bits
<< 0);
288 uwire_write_reg(UWIRE_CSR
, val
);
291 /* Wait till read actually starts */
292 (void) wait_uwire_csr_flag(CSRB
, CSRB
, 1);
294 if (wait_uwire_csr_flag(RDRB
| CSRB
,
298 /* rx bit 0 is last received; multibyte words will
299 * be properly byteswapped on the way to memory.
301 val
= uwire_read_reg(UWIRE_RDR
);
302 val
&= (1 << bits
) - 1;
308 pr_debug("%s: read-%d =%04x\n",
309 dev_name(&spi
->dev
), bits
, val
);
319 static int uwire_setup_transfer(struct spi_device
*spi
, struct spi_transfer
*t
)
321 struct uwire_state
*ust
= spi
->controller_state
;
322 struct uwire_spi
*uwire
;
332 uwire
= spi_master_get_devdata(spi
->master
);
334 if (spi
->chip_select
> 3) {
335 pr_debug("%s: cs%d?\n", dev_name(&spi
->dev
), spi
->chip_select
);
340 bits
= spi
->bits_per_word
;
341 if (t
!= NULL
&& t
->bits_per_word
)
342 bits
= t
->bits_per_word
;
345 pr_debug("%s: wordsize %d?\n", dev_name(&spi
->dev
), bits
);
349 ust
->bits_per_word
= bits
;
351 /* mode 0..3, clock inverted separately;
352 * standard nCS signaling;
353 * don't treat DI=high as "not ready"
355 if (spi
->mode
& SPI_CS_HIGH
)
356 flags
|= UWIRE_CS_ACTIVE_HIGH
;
358 if (spi
->mode
& SPI_CPOL
)
359 flags
|= UWIRE_CLK_INVERTED
;
361 switch (spi
->mode
& (SPI_CPOL
| SPI_CPHA
)) {
364 flags
|= UWIRE_WRITE_FALLING_EDGE
| UWIRE_READ_RISING_EDGE
;
368 flags
|= UWIRE_WRITE_RISING_EDGE
| UWIRE_READ_FALLING_EDGE
;
372 /* assume it's already enabled */
373 rate
= clk_get_rate(uwire
->ck
);
375 hz
= spi
->max_speed_hz
;
376 if (t
!= NULL
&& t
->speed_hz
)
380 pr_debug("%s: zero speed?\n", dev_name(&spi
->dev
));
385 /* F_INT = mpu_xor_clk / DIV1 */
386 for (div1_idx
= 0; div1_idx
< 4; div1_idx
++) {
402 div2
= (rate
/ div1
+ hz
- 1) / hz
;
407 pr_debug("%s: lowest clock %ld, need %d\n",
408 dev_name(&spi
->dev
), rate
/ 10 / 8, hz
);
413 /* we have to cache this and reset in uwire_chipselect as this is a
414 * global parameter and another uwire device can change it under
416 ust
->div1_idx
= div1_idx
;
417 uwire_set_clk1_div(div1_idx
);
425 flags
|= UWIRE_FREQ_DIV_2
;
430 flags
|= UWIRE_FREQ_DIV_4
;
437 flags
|= UWIRE_FREQ_DIV_8
;
441 omap_uwire_configure_mode(spi
->chip_select
, flags
);
442 pr_debug("%s: uwire flags %02x, armxor %lu KHz, SCK %lu KHz\n",
444 clk_get_rate(uwire
->ck
) / 1000,
451 static int uwire_setup(struct spi_device
*spi
)
453 struct uwire_state
*ust
= spi
->controller_state
;
456 ust
= kzalloc(sizeof(*ust
), GFP_KERNEL
);
459 spi
->controller_state
= ust
;
462 return uwire_setup_transfer(spi
, NULL
);
465 static void uwire_cleanup(struct spi_device
*spi
)
467 kfree(spi
->controller_state
);
470 static void uwire_off(struct uwire_spi
*uwire
)
472 uwire_write_reg(UWIRE_SR3
, 0);
473 clk_disable(uwire
->ck
);
475 spi_master_put(uwire
->bitbang
.master
);
478 static int __init
uwire_probe(struct platform_device
*pdev
)
480 struct spi_master
*master
;
481 struct uwire_spi
*uwire
;
484 master
= spi_alloc_master(&pdev
->dev
, sizeof *uwire
);
488 uwire
= spi_master_get_devdata(master
);
490 uwire_base
= ioremap(UWIRE_BASE_PHYS
, UWIRE_IO_SIZE
);
492 dev_dbg(&pdev
->dev
, "can't ioremap UWIRE\n");
493 spi_master_put(master
);
497 dev_set_drvdata(&pdev
->dev
, uwire
);
499 uwire
->ck
= clk_get(&pdev
->dev
, "fck");
500 if (IS_ERR(uwire
->ck
)) {
501 status
= PTR_ERR(uwire
->ck
);
502 dev_dbg(&pdev
->dev
, "no functional clock?\n");
503 spi_master_put(master
);
506 clk_enable(uwire
->ck
);
508 if (cpu_is_omap7xx())
513 uwire_write_reg(UWIRE_SR3
, 1);
515 /* the spi->mode bits understood by this driver: */
516 master
->mode_bits
= SPI_CPOL
| SPI_CPHA
| SPI_CS_HIGH
;
518 master
->flags
= SPI_MASTER_HALF_DUPLEX
;
520 master
->bus_num
= 2; /* "official" */
521 master
->num_chipselect
= 4;
522 master
->setup
= uwire_setup
;
523 master
->cleanup
= uwire_cleanup
;
525 uwire
->bitbang
.master
= master
;
526 uwire
->bitbang
.chipselect
= uwire_chipselect
;
527 uwire
->bitbang
.setup_transfer
= uwire_setup_transfer
;
528 uwire
->bitbang
.txrx_bufs
= uwire_txrx
;
530 status
= spi_bitbang_start(&uwire
->bitbang
);
538 static int __exit
uwire_remove(struct platform_device
*pdev
)
540 struct uwire_spi
*uwire
= dev_get_drvdata(&pdev
->dev
);
543 // FIXME remove all child devices, somewhere ...
545 status
= spi_bitbang_stop(&uwire
->bitbang
);
551 /* work with hotplug and coldplug */
552 MODULE_ALIAS("platform:omap_uwire");
554 static struct platform_driver uwire_driver
= {
556 .name
= "omap_uwire",
557 .owner
= THIS_MODULE
,
559 .remove
= __exit_p(uwire_remove
),
560 // suspend ... unuse ck
564 static int __init
omap_uwire_init(void)
566 /* FIXME move these into the relevant board init code. also, include
567 * H3 support; it uses tsc2101 like H2 (on a different chipselect).
570 if (machine_is_omap_h2()) {
571 /* defaults: W21 SDO, U18 SDI, V19 SCL */
572 omap_cfg_reg(N14_1610_UWIRE_CS0
);
573 omap_cfg_reg(N15_1610_UWIRE_CS1
);
575 if (machine_is_omap_perseus2()) {
576 /* configure pins: MPU_UW_nSCS1, MPU_UW_SDO, MPU_UW_SCLK */
577 int val
= omap_readl(OMAP7XX_IO_CONF_9
) & ~0x00EEE000;
578 omap_writel(val
| 0x00AAA000, OMAP7XX_IO_CONF_9
);
581 return platform_driver_probe(&uwire_driver
, uwire_probe
);
584 static void __exit
omap_uwire_exit(void)
586 platform_driver_unregister(&uwire_driver
);
589 subsys_initcall(omap_uwire_init
);
590 module_exit(omap_uwire_exit
);
592 MODULE_LICENSE("GPL");