Loading...
1/*
2 * Copyright (c) 2006 Ben Dooks
3 * Copyright 2006-2009 Simtec Electronics
4 * Ben Dooks <ben@simtec.co.uk>
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*/
11
12#include <linux/init.h>
13#include <linux/spinlock.h>
14#include <linux/workqueue.h>
15#include <linux/interrupt.h>
16#include <linux/delay.h>
17#include <linux/errno.h>
18#include <linux/err.h>
19#include <linux/clk.h>
20#include <linux/platform_device.h>
21#include <linux/gpio.h>
22#include <linux/io.h>
23#include <linux/slab.h>
24
25#include <linux/spi/spi.h>
26#include <linux/spi/spi_bitbang.h>
27
28#include <plat/regs-spi.h>
29#include <mach/spi.h>
30
31#include <plat/fiq.h>
32#include <asm/fiq.h>
33
34#include "spi-s3c24xx-fiq.h"
35
36/**
37 * s3c24xx_spi_devstate - per device data
38 * @hz: Last frequency calculated for @sppre field.
39 * @mode: Last mode setting for the @spcon field.
40 * @spcon: Value to write to the SPCON register.
41 * @sppre: Value to write to the SPPRE register.
42 */
43struct s3c24xx_spi_devstate {
44 unsigned int hz;
45 unsigned int mode;
46 u8 spcon;
47 u8 sppre;
48};
49
50enum spi_fiq_mode {
51 FIQ_MODE_NONE = 0,
52 FIQ_MODE_TX = 1,
53 FIQ_MODE_RX = 2,
54 FIQ_MODE_TXRX = 3,
55};
56
57struct s3c24xx_spi {
58 /* bitbang has to be first */
59 struct spi_bitbang bitbang;
60 struct completion done;
61
62 void __iomem *regs;
63 int irq;
64 int len;
65 int count;
66
67 struct fiq_handler fiq_handler;
68 enum spi_fiq_mode fiq_mode;
69 unsigned char fiq_inuse;
70 unsigned char fiq_claimed;
71
72 void (*set_cs)(struct s3c2410_spi_info *spi,
73 int cs, int pol);
74
75 /* data buffers */
76 const unsigned char *tx;
77 unsigned char *rx;
78
79 struct clk *clk;
80 struct resource *ioarea;
81 struct spi_master *master;
82 struct spi_device *curdev;
83 struct device *dev;
84 struct s3c2410_spi_info *pdata;
85};
86
87
88#define SPCON_DEFAULT (S3C2410_SPCON_MSTR | S3C2410_SPCON_SMOD_INT)
89#define SPPIN_DEFAULT (S3C2410_SPPIN_KEEP)
90
91static inline struct s3c24xx_spi *to_hw(struct spi_device *sdev)
92{
93 return spi_master_get_devdata(sdev->master);
94}
95
96static void s3c24xx_spi_gpiocs(struct s3c2410_spi_info *spi, int cs, int pol)
97{
98 gpio_set_value(spi->pin_cs, pol);
99}
100
101static void s3c24xx_spi_chipsel(struct spi_device *spi, int value)
102{
103 struct s3c24xx_spi_devstate *cs = spi->controller_state;
104 struct s3c24xx_spi *hw = to_hw(spi);
105 unsigned int cspol = spi->mode & SPI_CS_HIGH ? 1 : 0;
106
107 /* change the chipselect state and the state of the spi engine clock */
108
109 switch (value) {
110 case BITBANG_CS_INACTIVE:
111 hw->set_cs(hw->pdata, spi->chip_select, cspol^1);
112 writeb(cs->spcon, hw->regs + S3C2410_SPCON);
113 break;
114
115 case BITBANG_CS_ACTIVE:
116 writeb(cs->spcon | S3C2410_SPCON_ENSCK,
117 hw->regs + S3C2410_SPCON);
118 hw->set_cs(hw->pdata, spi->chip_select, cspol);
119 break;
120 }
121}
122
123static int s3c24xx_spi_update_state(struct spi_device *spi,
124 struct spi_transfer *t)
125{
126 struct s3c24xx_spi *hw = to_hw(spi);
127 struct s3c24xx_spi_devstate *cs = spi->controller_state;
128 unsigned int bpw;
129 unsigned int hz;
130 unsigned int div;
131 unsigned long clk;
132
133 bpw = t ? t->bits_per_word : spi->bits_per_word;
134 hz = t ? t->speed_hz : spi->max_speed_hz;
135
136 if (!bpw)
137 bpw = 8;
138
139 if (!hz)
140 hz = spi->max_speed_hz;
141
142 if (bpw != 8) {
143 dev_err(&spi->dev, "invalid bits-per-word (%d)\n", bpw);
144 return -EINVAL;
145 }
146
147 if (spi->mode != cs->mode) {
148 u8 spcon = SPCON_DEFAULT | S3C2410_SPCON_ENSCK;
149
150 if (spi->mode & SPI_CPHA)
151 spcon |= S3C2410_SPCON_CPHA_FMTB;
152
153 if (spi->mode & SPI_CPOL)
154 spcon |= S3C2410_SPCON_CPOL_HIGH;
155
156 cs->mode = spi->mode;
157 cs->spcon = spcon;
158 }
159
160 if (cs->hz != hz) {
161 clk = clk_get_rate(hw->clk);
162 div = DIV_ROUND_UP(clk, hz * 2) - 1;
163
164 if (div > 255)
165 div = 255;
166
167 dev_dbg(&spi->dev, "pre-scaler=%d (wanted %d, got %ld)\n",
168 div, hz, clk / (2 * (div + 1)));
169
170 cs->hz = hz;
171 cs->sppre = div;
172 }
173
174 return 0;
175}
176
177static int s3c24xx_spi_setupxfer(struct spi_device *spi,
178 struct spi_transfer *t)
179{
180 struct s3c24xx_spi_devstate *cs = spi->controller_state;
181 struct s3c24xx_spi *hw = to_hw(spi);
182 int ret;
183
184 ret = s3c24xx_spi_update_state(spi, t);
185 if (!ret)
186 writeb(cs->sppre, hw->regs + S3C2410_SPPRE);
187
188 return ret;
189}
190
191static int s3c24xx_spi_setup(struct spi_device *spi)
192{
193 struct s3c24xx_spi_devstate *cs = spi->controller_state;
194 struct s3c24xx_spi *hw = to_hw(spi);
195 int ret;
196
197 /* allocate settings on the first call */
198 if (!cs) {
199 cs = kzalloc(sizeof(struct s3c24xx_spi_devstate), GFP_KERNEL);
200 if (!cs) {
201 dev_err(&spi->dev, "no memory for controller state\n");
202 return -ENOMEM;
203 }
204
205 cs->spcon = SPCON_DEFAULT;
206 cs->hz = -1;
207 spi->controller_state = cs;
208 }
209
210 /* initialise the state from the device */
211 ret = s3c24xx_spi_update_state(spi, NULL);
212 if (ret)
213 return ret;
214
215 spin_lock(&hw->bitbang.lock);
216 if (!hw->bitbang.busy) {
217 hw->bitbang.chipselect(spi, BITBANG_CS_INACTIVE);
218 /* need to ndelay for 0.5 clocktick ? */
219 }
220 spin_unlock(&hw->bitbang.lock);
221
222 return 0;
223}
224
225static void s3c24xx_spi_cleanup(struct spi_device *spi)
226{
227 kfree(spi->controller_state);
228}
229
230static inline unsigned int hw_txbyte(struct s3c24xx_spi *hw, int count)
231{
232 return hw->tx ? hw->tx[count] : 0;
233}
234
235#ifdef CONFIG_SPI_S3C24XX_FIQ
236/* Support for FIQ based pseudo-DMA to improve the transfer speed.
237 *
238 * This code uses the assembly helper in spi_s3c24xx_spi.S which is
239 * used by the FIQ core to move data between main memory and the peripheral
240 * block. Since this is code running on the processor, there is no problem
241 * with cache coherency of the buffers, so we can use any buffer we like.
242 */
243
244/**
245 * struct spi_fiq_code - FIQ code and header
246 * @length: The length of the code fragment, excluding this header.
247 * @ack_offset: The offset from @data to the word to place the IRQ ACK bit at.
248 * @data: The code itself to install as a FIQ handler.
249 */
250struct spi_fiq_code {
251 u32 length;
252 u32 ack_offset;
253 u8 data[0];
254};
255
256extern struct spi_fiq_code s3c24xx_spi_fiq_txrx;
257extern struct spi_fiq_code s3c24xx_spi_fiq_tx;
258extern struct spi_fiq_code s3c24xx_spi_fiq_rx;
259
260/**
261 * ack_bit - turn IRQ into IRQ acknowledgement bit
262 * @irq: The interrupt number
263 *
264 * Returns the bit to write to the interrupt acknowledge register.
265 */
266static inline u32 ack_bit(unsigned int irq)
267{
268 return 1 << (irq - IRQ_EINT0);
269}
270
271/**
272 * s3c24xx_spi_tryfiq - attempt to claim and setup FIQ for transfer
273 * @hw: The hardware state.
274 *
275 * Claim the FIQ handler (only one can be active at any one time) and
276 * then setup the correct transfer code for this transfer.
277 *
278 * This call updates all the necessary state information if successful,
279 * so the caller does not need to do anything more than start the transfer
280 * as normal, since the IRQ will have been re-routed to the FIQ handler.
281*/
282void s3c24xx_spi_tryfiq(struct s3c24xx_spi *hw)
283{
284 struct pt_regs regs;
285 enum spi_fiq_mode mode;
286 struct spi_fiq_code *code;
287 int ret;
288
289 if (!hw->fiq_claimed) {
290 /* try and claim fiq if we haven't got it, and if not
291 * then return and simply use another transfer method */
292
293 ret = claim_fiq(&hw->fiq_handler);
294 if (ret)
295 return;
296 }
297
298 if (hw->tx && !hw->rx)
299 mode = FIQ_MODE_TX;
300 else if (hw->rx && !hw->tx)
301 mode = FIQ_MODE_RX;
302 else
303 mode = FIQ_MODE_TXRX;
304
305 regs.uregs[fiq_rspi] = (long)hw->regs;
306 regs.uregs[fiq_rrx] = (long)hw->rx;
307 regs.uregs[fiq_rtx] = (long)hw->tx + 1;
308 regs.uregs[fiq_rcount] = hw->len - 1;
309 regs.uregs[fiq_rirq] = (long)S3C24XX_VA_IRQ;
310
311 set_fiq_regs(®s);
312
313 if (hw->fiq_mode != mode) {
314 u32 *ack_ptr;
315
316 hw->fiq_mode = mode;
317
318 switch (mode) {
319 case FIQ_MODE_TX:
320 code = &s3c24xx_spi_fiq_tx;
321 break;
322 case FIQ_MODE_RX:
323 code = &s3c24xx_spi_fiq_rx;
324 break;
325 case FIQ_MODE_TXRX:
326 code = &s3c24xx_spi_fiq_txrx;
327 break;
328 default:
329 code = NULL;
330 }
331
332 BUG_ON(!code);
333
334 ack_ptr = (u32 *)&code->data[code->ack_offset];
335 *ack_ptr = ack_bit(hw->irq);
336
337 set_fiq_handler(&code->data, code->length);
338 }
339
340 s3c24xx_set_fiq(hw->irq, true);
341
342 hw->fiq_mode = mode;
343 hw->fiq_inuse = 1;
344}
345
346/**
347 * s3c24xx_spi_fiqop - FIQ core code callback
348 * @pw: Data registered with the handler
349 * @release: Whether this is a release or a return.
350 *
351 * Called by the FIQ code when another module wants to use the FIQ, so
352 * return whether we are currently using this or not and then update our
353 * internal state.
354 */
355static int s3c24xx_spi_fiqop(void *pw, int release)
356{
357 struct s3c24xx_spi *hw = pw;
358 int ret = 0;
359
360 if (release) {
361 if (hw->fiq_inuse)
362 ret = -EBUSY;
363
364 /* note, we do not need to unroute the FIQ, as the FIQ
365 * vector code de-routes it to signal the end of transfer */
366
367 hw->fiq_mode = FIQ_MODE_NONE;
368 hw->fiq_claimed = 0;
369 } else {
370 hw->fiq_claimed = 1;
371 }
372
373 return ret;
374}
375
376/**
377 * s3c24xx_spi_initfiq - setup the information for the FIQ core
378 * @hw: The hardware state.
379 *
380 * Setup the fiq_handler block to pass to the FIQ core.
381 */
382static inline void s3c24xx_spi_initfiq(struct s3c24xx_spi *hw)
383{
384 hw->fiq_handler.dev_id = hw;
385 hw->fiq_handler.name = dev_name(hw->dev);
386 hw->fiq_handler.fiq_op = s3c24xx_spi_fiqop;
387}
388
389/**
390 * s3c24xx_spi_usefiq - return if we should be using FIQ.
391 * @hw: The hardware state.
392 *
393 * Return true if the platform data specifies whether this channel is
394 * allowed to use the FIQ.
395 */
396static inline bool s3c24xx_spi_usefiq(struct s3c24xx_spi *hw)
397{
398 return hw->pdata->use_fiq;
399}
400
401/**
402 * s3c24xx_spi_usingfiq - return if channel is using FIQ
403 * @spi: The hardware state.
404 *
405 * Return whether the channel is currently using the FIQ (separate from
406 * whether the FIQ is claimed).
407 */
408static inline bool s3c24xx_spi_usingfiq(struct s3c24xx_spi *spi)
409{
410 return spi->fiq_inuse;
411}
412#else
413
414static inline void s3c24xx_spi_initfiq(struct s3c24xx_spi *s) { }
415static inline void s3c24xx_spi_tryfiq(struct s3c24xx_spi *s) { }
416static inline bool s3c24xx_spi_usefiq(struct s3c24xx_spi *s) { return false; }
417static inline bool s3c24xx_spi_usingfiq(struct s3c24xx_spi *s) { return false; }
418
419#endif /* CONFIG_SPI_S3C24XX_FIQ */
420
421static int s3c24xx_spi_txrx(struct spi_device *spi, struct spi_transfer *t)
422{
423 struct s3c24xx_spi *hw = to_hw(spi);
424
425 hw->tx = t->tx_buf;
426 hw->rx = t->rx_buf;
427 hw->len = t->len;
428 hw->count = 0;
429
430 init_completion(&hw->done);
431
432 hw->fiq_inuse = 0;
433 if (s3c24xx_spi_usefiq(hw) && t->len >= 3)
434 s3c24xx_spi_tryfiq(hw);
435
436 /* send the first byte */
437 writeb(hw_txbyte(hw, 0), hw->regs + S3C2410_SPTDAT);
438
439 wait_for_completion(&hw->done);
440 return hw->count;
441}
442
443static irqreturn_t s3c24xx_spi_irq(int irq, void *dev)
444{
445 struct s3c24xx_spi *hw = dev;
446 unsigned int spsta = readb(hw->regs + S3C2410_SPSTA);
447 unsigned int count = hw->count;
448
449 if (spsta & S3C2410_SPSTA_DCOL) {
450 dev_dbg(hw->dev, "data-collision\n");
451 complete(&hw->done);
452 goto irq_done;
453 }
454
455 if (!(spsta & S3C2410_SPSTA_READY)) {
456 dev_dbg(hw->dev, "spi not ready for tx?\n");
457 complete(&hw->done);
458 goto irq_done;
459 }
460
461 if (!s3c24xx_spi_usingfiq(hw)) {
462 hw->count++;
463
464 if (hw->rx)
465 hw->rx[count] = readb(hw->regs + S3C2410_SPRDAT);
466
467 count++;
468
469 if (count < hw->len)
470 writeb(hw_txbyte(hw, count), hw->regs + S3C2410_SPTDAT);
471 else
472 complete(&hw->done);
473 } else {
474 hw->count = hw->len;
475 hw->fiq_inuse = 0;
476
477 if (hw->rx)
478 hw->rx[hw->len-1] = readb(hw->regs + S3C2410_SPRDAT);
479
480 complete(&hw->done);
481 }
482
483 irq_done:
484 return IRQ_HANDLED;
485}
486
487static void s3c24xx_spi_initialsetup(struct s3c24xx_spi *hw)
488{
489 /* for the moment, permanently enable the clock */
490
491 clk_enable(hw->clk);
492
493 /* program defaults into the registers */
494
495 writeb(0xff, hw->regs + S3C2410_SPPRE);
496 writeb(SPPIN_DEFAULT, hw->regs + S3C2410_SPPIN);
497 writeb(SPCON_DEFAULT, hw->regs + S3C2410_SPCON);
498
499 if (hw->pdata) {
500 if (hw->set_cs == s3c24xx_spi_gpiocs)
501 gpio_direction_output(hw->pdata->pin_cs, 1);
502
503 if (hw->pdata->gpio_setup)
504 hw->pdata->gpio_setup(hw->pdata, 1);
505 }
506}
507
508static int __init s3c24xx_spi_probe(struct platform_device *pdev)
509{
510 struct s3c2410_spi_info *pdata;
511 struct s3c24xx_spi *hw;
512 struct spi_master *master;
513 struct resource *res;
514 int err = 0;
515
516 master = spi_alloc_master(&pdev->dev, sizeof(struct s3c24xx_spi));
517 if (master == NULL) {
518 dev_err(&pdev->dev, "No memory for spi_master\n");
519 err = -ENOMEM;
520 goto err_nomem;
521 }
522
523 hw = spi_master_get_devdata(master);
524 memset(hw, 0, sizeof(struct s3c24xx_spi));
525
526 hw->master = spi_master_get(master);
527 hw->pdata = pdata = pdev->dev.platform_data;
528 hw->dev = &pdev->dev;
529
530 if (pdata == NULL) {
531 dev_err(&pdev->dev, "No platform data supplied\n");
532 err = -ENOENT;
533 goto err_no_pdata;
534 }
535
536 platform_set_drvdata(pdev, hw);
537 init_completion(&hw->done);
538
539 /* initialise fiq handler */
540
541 s3c24xx_spi_initfiq(hw);
542
543 /* setup the master state. */
544
545 /* the spi->mode bits understood by this driver: */
546 master->mode_bits = SPI_CPOL | SPI_CPHA | SPI_CS_HIGH;
547
548 master->num_chipselect = hw->pdata->num_cs;
549 master->bus_num = pdata->bus_num;
550
551 /* setup the state for the bitbang driver */
552
553 hw->bitbang.master = hw->master;
554 hw->bitbang.setup_transfer = s3c24xx_spi_setupxfer;
555 hw->bitbang.chipselect = s3c24xx_spi_chipsel;
556 hw->bitbang.txrx_bufs = s3c24xx_spi_txrx;
557
558 hw->master->setup = s3c24xx_spi_setup;
559 hw->master->cleanup = s3c24xx_spi_cleanup;
560
561 dev_dbg(hw->dev, "bitbang at %p\n", &hw->bitbang);
562
563 /* find and map our resources */
564
565 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
566 if (res == NULL) {
567 dev_err(&pdev->dev, "Cannot get IORESOURCE_MEM\n");
568 err = -ENOENT;
569 goto err_no_iores;
570 }
571
572 hw->ioarea = request_mem_region(res->start, resource_size(res),
573 pdev->name);
574
575 if (hw->ioarea == NULL) {
576 dev_err(&pdev->dev, "Cannot reserve region\n");
577 err = -ENXIO;
578 goto err_no_iores;
579 }
580
581 hw->regs = ioremap(res->start, resource_size(res));
582 if (hw->regs == NULL) {
583 dev_err(&pdev->dev, "Cannot map IO\n");
584 err = -ENXIO;
585 goto err_no_iomap;
586 }
587
588 hw->irq = platform_get_irq(pdev, 0);
589 if (hw->irq < 0) {
590 dev_err(&pdev->dev, "No IRQ specified\n");
591 err = -ENOENT;
592 goto err_no_irq;
593 }
594
595 err = request_irq(hw->irq, s3c24xx_spi_irq, 0, pdev->name, hw);
596 if (err) {
597 dev_err(&pdev->dev, "Cannot claim IRQ\n");
598 goto err_no_irq;
599 }
600
601 hw->clk = clk_get(&pdev->dev, "spi");
602 if (IS_ERR(hw->clk)) {
603 dev_err(&pdev->dev, "No clock for device\n");
604 err = PTR_ERR(hw->clk);
605 goto err_no_clk;
606 }
607
608 /* setup any gpio we can */
609
610 if (!pdata->set_cs) {
611 if (pdata->pin_cs < 0) {
612 dev_err(&pdev->dev, "No chipselect pin\n");
613 goto err_register;
614 }
615
616 err = gpio_request(pdata->pin_cs, dev_name(&pdev->dev));
617 if (err) {
618 dev_err(&pdev->dev, "Failed to get gpio for cs\n");
619 goto err_register;
620 }
621
622 hw->set_cs = s3c24xx_spi_gpiocs;
623 gpio_direction_output(pdata->pin_cs, 1);
624 } else
625 hw->set_cs = pdata->set_cs;
626
627 s3c24xx_spi_initialsetup(hw);
628
629 /* register our spi controller */
630
631 err = spi_bitbang_start(&hw->bitbang);
632 if (err) {
633 dev_err(&pdev->dev, "Failed to register SPI master\n");
634 goto err_register;
635 }
636
637 return 0;
638
639 err_register:
640 if (hw->set_cs == s3c24xx_spi_gpiocs)
641 gpio_free(pdata->pin_cs);
642
643 clk_disable(hw->clk);
644 clk_put(hw->clk);
645
646 err_no_clk:
647 free_irq(hw->irq, hw);
648
649 err_no_irq:
650 iounmap(hw->regs);
651
652 err_no_iomap:
653 release_resource(hw->ioarea);
654 kfree(hw->ioarea);
655
656 err_no_iores:
657 err_no_pdata:
658 spi_master_put(hw->master);
659
660 err_nomem:
661 return err;
662}
663
664static int __exit s3c24xx_spi_remove(struct platform_device *dev)
665{
666 struct s3c24xx_spi *hw = platform_get_drvdata(dev);
667
668 platform_set_drvdata(dev, NULL);
669
670 spi_bitbang_stop(&hw->bitbang);
671
672 clk_disable(hw->clk);
673 clk_put(hw->clk);
674
675 free_irq(hw->irq, hw);
676 iounmap(hw->regs);
677
678 if (hw->set_cs == s3c24xx_spi_gpiocs)
679 gpio_free(hw->pdata->pin_cs);
680
681 release_resource(hw->ioarea);
682 kfree(hw->ioarea);
683
684 spi_master_put(hw->master);
685 return 0;
686}
687
688
689#ifdef CONFIG_PM
690
691static int s3c24xx_spi_suspend(struct device *dev)
692{
693 struct s3c24xx_spi *hw = platform_get_drvdata(to_platform_device(dev));
694
695 if (hw->pdata && hw->pdata->gpio_setup)
696 hw->pdata->gpio_setup(hw->pdata, 0);
697
698 clk_disable(hw->clk);
699 return 0;
700}
701
702static int s3c24xx_spi_resume(struct device *dev)
703{
704 struct s3c24xx_spi *hw = platform_get_drvdata(to_platform_device(dev));
705
706 s3c24xx_spi_initialsetup(hw);
707 return 0;
708}
709
710static const struct dev_pm_ops s3c24xx_spi_pmops = {
711 .suspend = s3c24xx_spi_suspend,
712 .resume = s3c24xx_spi_resume,
713};
714
715#define S3C24XX_SPI_PMOPS &s3c24xx_spi_pmops
716#else
717#define S3C24XX_SPI_PMOPS NULL
718#endif /* CONFIG_PM */
719
720MODULE_ALIAS("platform:s3c2410-spi");
721static struct platform_driver s3c24xx_spi_driver = {
722 .remove = __exit_p(s3c24xx_spi_remove),
723 .driver = {
724 .name = "s3c2410-spi",
725 .owner = THIS_MODULE,
726 .pm = S3C24XX_SPI_PMOPS,
727 },
728};
729
730static int __init s3c24xx_spi_init(void)
731{
732 return platform_driver_probe(&s3c24xx_spi_driver, s3c24xx_spi_probe);
733}
734
735static void __exit s3c24xx_spi_exit(void)
736{
737 platform_driver_unregister(&s3c24xx_spi_driver);
738}
739
740module_init(s3c24xx_spi_init);
741module_exit(s3c24xx_spi_exit);
742
743MODULE_DESCRIPTION("S3C24XX SPI Driver");
744MODULE_AUTHOR("Ben Dooks, <ben@simtec.co.uk>");
745MODULE_LICENSE("GPL");
1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * Copyright (c) 2006 Ben Dooks
4 * Copyright 2006-2009 Simtec Electronics
5 * Ben Dooks <ben@simtec.co.uk>
6*/
7
8#include <linux/spinlock.h>
9#include <linux/interrupt.h>
10#include <linux/delay.h>
11#include <linux/errno.h>
12#include <linux/err.h>
13#include <linux/clk.h>
14#include <linux/platform_device.h>
15#include <linux/gpio.h>
16#include <linux/io.h>
17#include <linux/slab.h>
18
19#include <linux/spi/spi.h>
20#include <linux/spi/spi_bitbang.h>
21#include <linux/spi/s3c24xx.h>
22#include <linux/module.h>
23
24#include <plat/regs-spi.h>
25
26#include <asm/fiq.h>
27
28#include "spi-s3c24xx-fiq.h"
29
30/**
31 * s3c24xx_spi_devstate - per device data
32 * @hz: Last frequency calculated for @sppre field.
33 * @mode: Last mode setting for the @spcon field.
34 * @spcon: Value to write to the SPCON register.
35 * @sppre: Value to write to the SPPRE register.
36 */
37struct s3c24xx_spi_devstate {
38 unsigned int hz;
39 unsigned int mode;
40 u8 spcon;
41 u8 sppre;
42};
43
44enum spi_fiq_mode {
45 FIQ_MODE_NONE = 0,
46 FIQ_MODE_TX = 1,
47 FIQ_MODE_RX = 2,
48 FIQ_MODE_TXRX = 3,
49};
50
51struct s3c24xx_spi {
52 /* bitbang has to be first */
53 struct spi_bitbang bitbang;
54 struct completion done;
55
56 void __iomem *regs;
57 int irq;
58 int len;
59 int count;
60
61 struct fiq_handler fiq_handler;
62 enum spi_fiq_mode fiq_mode;
63 unsigned char fiq_inuse;
64 unsigned char fiq_claimed;
65
66 void (*set_cs)(struct s3c2410_spi_info *spi,
67 int cs, int pol);
68
69 /* data buffers */
70 const unsigned char *tx;
71 unsigned char *rx;
72
73 struct clk *clk;
74 struct spi_master *master;
75 struct spi_device *curdev;
76 struct device *dev;
77 struct s3c2410_spi_info *pdata;
78};
79
80#define SPCON_DEFAULT (S3C2410_SPCON_MSTR | S3C2410_SPCON_SMOD_INT)
81#define SPPIN_DEFAULT (S3C2410_SPPIN_KEEP)
82
83static inline struct s3c24xx_spi *to_hw(struct spi_device *sdev)
84{
85 return spi_master_get_devdata(sdev->master);
86}
87
88static void s3c24xx_spi_gpiocs(struct s3c2410_spi_info *spi, int cs, int pol)
89{
90 gpio_set_value(spi->pin_cs, pol);
91}
92
93static void s3c24xx_spi_chipsel(struct spi_device *spi, int value)
94{
95 struct s3c24xx_spi_devstate *cs = spi->controller_state;
96 struct s3c24xx_spi *hw = to_hw(spi);
97 unsigned int cspol = spi->mode & SPI_CS_HIGH ? 1 : 0;
98
99 /* change the chipselect state and the state of the spi engine clock */
100
101 switch (value) {
102 case BITBANG_CS_INACTIVE:
103 hw->set_cs(hw->pdata, spi->chip_select, cspol^1);
104 writeb(cs->spcon, hw->regs + S3C2410_SPCON);
105 break;
106
107 case BITBANG_CS_ACTIVE:
108 writeb(cs->spcon | S3C2410_SPCON_ENSCK,
109 hw->regs + S3C2410_SPCON);
110 hw->set_cs(hw->pdata, spi->chip_select, cspol);
111 break;
112 }
113}
114
115static int s3c24xx_spi_update_state(struct spi_device *spi,
116 struct spi_transfer *t)
117{
118 struct s3c24xx_spi *hw = to_hw(spi);
119 struct s3c24xx_spi_devstate *cs = spi->controller_state;
120 unsigned int hz;
121 unsigned int div;
122 unsigned long clk;
123
124 hz = t ? t->speed_hz : spi->max_speed_hz;
125
126 if (!hz)
127 hz = spi->max_speed_hz;
128
129 if (spi->mode != cs->mode) {
130 u8 spcon = SPCON_DEFAULT | S3C2410_SPCON_ENSCK;
131
132 if (spi->mode & SPI_CPHA)
133 spcon |= S3C2410_SPCON_CPHA_FMTB;
134
135 if (spi->mode & SPI_CPOL)
136 spcon |= S3C2410_SPCON_CPOL_HIGH;
137
138 cs->mode = spi->mode;
139 cs->spcon = spcon;
140 }
141
142 if (cs->hz != hz) {
143 clk = clk_get_rate(hw->clk);
144 div = DIV_ROUND_UP(clk, hz * 2) - 1;
145
146 if (div > 255)
147 div = 255;
148
149 dev_dbg(&spi->dev, "pre-scaler=%d (wanted %d, got %ld)\n",
150 div, hz, clk / (2 * (div + 1)));
151
152 cs->hz = hz;
153 cs->sppre = div;
154 }
155
156 return 0;
157}
158
159static int s3c24xx_spi_setupxfer(struct spi_device *spi,
160 struct spi_transfer *t)
161{
162 struct s3c24xx_spi_devstate *cs = spi->controller_state;
163 struct s3c24xx_spi *hw = to_hw(spi);
164 int ret;
165
166 ret = s3c24xx_spi_update_state(spi, t);
167 if (!ret)
168 writeb(cs->sppre, hw->regs + S3C2410_SPPRE);
169
170 return ret;
171}
172
173static int s3c24xx_spi_setup(struct spi_device *spi)
174{
175 struct s3c24xx_spi_devstate *cs = spi->controller_state;
176 struct s3c24xx_spi *hw = to_hw(spi);
177 int ret;
178
179 /* allocate settings on the first call */
180 if (!cs) {
181 cs = devm_kzalloc(&spi->dev,
182 sizeof(struct s3c24xx_spi_devstate),
183 GFP_KERNEL);
184 if (!cs)
185 return -ENOMEM;
186
187 cs->spcon = SPCON_DEFAULT;
188 cs->hz = -1;
189 spi->controller_state = cs;
190 }
191
192 /* initialise the state from the device */
193 ret = s3c24xx_spi_update_state(spi, NULL);
194 if (ret)
195 return ret;
196
197 mutex_lock(&hw->bitbang.lock);
198 if (!hw->bitbang.busy) {
199 hw->bitbang.chipselect(spi, BITBANG_CS_INACTIVE);
200 /* need to ndelay for 0.5 clocktick ? */
201 }
202 mutex_unlock(&hw->bitbang.lock);
203
204 return 0;
205}
206
207static inline unsigned int hw_txbyte(struct s3c24xx_spi *hw, int count)
208{
209 return hw->tx ? hw->tx[count] : 0;
210}
211
212#ifdef CONFIG_SPI_S3C24XX_FIQ
213/* Support for FIQ based pseudo-DMA to improve the transfer speed.
214 *
215 * This code uses the assembly helper in spi_s3c24xx_spi.S which is
216 * used by the FIQ core to move data between main memory and the peripheral
217 * block. Since this is code running on the processor, there is no problem
218 * with cache coherency of the buffers, so we can use any buffer we like.
219 */
220
221/**
222 * struct spi_fiq_code - FIQ code and header
223 * @length: The length of the code fragment, excluding this header.
224 * @ack_offset: The offset from @data to the word to place the IRQ ACK bit at.
225 * @data: The code itself to install as a FIQ handler.
226 */
227struct spi_fiq_code {
228 u32 length;
229 u32 ack_offset;
230 u8 data[];
231};
232
233extern struct spi_fiq_code s3c24xx_spi_fiq_txrx;
234extern struct spi_fiq_code s3c24xx_spi_fiq_tx;
235extern struct spi_fiq_code s3c24xx_spi_fiq_rx;
236
237/**
238 * ack_bit - turn IRQ into IRQ acknowledgement bit
239 * @irq: The interrupt number
240 *
241 * Returns the bit to write to the interrupt acknowledge register.
242 */
243static inline u32 ack_bit(unsigned int irq)
244{
245 return 1 << (irq - IRQ_EINT0);
246}
247
248/**
249 * s3c24xx_spi_tryfiq - attempt to claim and setup FIQ for transfer
250 * @hw: The hardware state.
251 *
252 * Claim the FIQ handler (only one can be active at any one time) and
253 * then setup the correct transfer code for this transfer.
254 *
255 * This call updates all the necessary state information if successful,
256 * so the caller does not need to do anything more than start the transfer
257 * as normal, since the IRQ will have been re-routed to the FIQ handler.
258*/
259static void s3c24xx_spi_tryfiq(struct s3c24xx_spi *hw)
260{
261 struct pt_regs regs;
262 enum spi_fiq_mode mode;
263 struct spi_fiq_code *code;
264 int ret;
265
266 if (!hw->fiq_claimed) {
267 /* try and claim fiq if we haven't got it, and if not
268 * then return and simply use another transfer method */
269
270 ret = claim_fiq(&hw->fiq_handler);
271 if (ret)
272 return;
273 }
274
275 if (hw->tx && !hw->rx)
276 mode = FIQ_MODE_TX;
277 else if (hw->rx && !hw->tx)
278 mode = FIQ_MODE_RX;
279 else
280 mode = FIQ_MODE_TXRX;
281
282 regs.uregs[fiq_rspi] = (long)hw->regs;
283 regs.uregs[fiq_rrx] = (long)hw->rx;
284 regs.uregs[fiq_rtx] = (long)hw->tx + 1;
285 regs.uregs[fiq_rcount] = hw->len - 1;
286 regs.uregs[fiq_rirq] = (long)S3C24XX_VA_IRQ;
287
288 set_fiq_regs(®s);
289
290 if (hw->fiq_mode != mode) {
291 u32 *ack_ptr;
292
293 hw->fiq_mode = mode;
294
295 switch (mode) {
296 case FIQ_MODE_TX:
297 code = &s3c24xx_spi_fiq_tx;
298 break;
299 case FIQ_MODE_RX:
300 code = &s3c24xx_spi_fiq_rx;
301 break;
302 case FIQ_MODE_TXRX:
303 code = &s3c24xx_spi_fiq_txrx;
304 break;
305 default:
306 code = NULL;
307 }
308
309 BUG_ON(!code);
310
311 ack_ptr = (u32 *)&code->data[code->ack_offset];
312 *ack_ptr = ack_bit(hw->irq);
313
314 set_fiq_handler(&code->data, code->length);
315 }
316
317 s3c24xx_set_fiq(hw->irq, true);
318
319 hw->fiq_mode = mode;
320 hw->fiq_inuse = 1;
321}
322
323/**
324 * s3c24xx_spi_fiqop - FIQ core code callback
325 * @pw: Data registered with the handler
326 * @release: Whether this is a release or a return.
327 *
328 * Called by the FIQ code when another module wants to use the FIQ, so
329 * return whether we are currently using this or not and then update our
330 * internal state.
331 */
332static int s3c24xx_spi_fiqop(void *pw, int release)
333{
334 struct s3c24xx_spi *hw = pw;
335 int ret = 0;
336
337 if (release) {
338 if (hw->fiq_inuse)
339 ret = -EBUSY;
340
341 /* note, we do not need to unroute the FIQ, as the FIQ
342 * vector code de-routes it to signal the end of transfer */
343
344 hw->fiq_mode = FIQ_MODE_NONE;
345 hw->fiq_claimed = 0;
346 } else {
347 hw->fiq_claimed = 1;
348 }
349
350 return ret;
351}
352
353/**
354 * s3c24xx_spi_initfiq - setup the information for the FIQ core
355 * @hw: The hardware state.
356 *
357 * Setup the fiq_handler block to pass to the FIQ core.
358 */
359static inline void s3c24xx_spi_initfiq(struct s3c24xx_spi *hw)
360{
361 hw->fiq_handler.dev_id = hw;
362 hw->fiq_handler.name = dev_name(hw->dev);
363 hw->fiq_handler.fiq_op = s3c24xx_spi_fiqop;
364}
365
366/**
367 * s3c24xx_spi_usefiq - return if we should be using FIQ.
368 * @hw: The hardware state.
369 *
370 * Return true if the platform data specifies whether this channel is
371 * allowed to use the FIQ.
372 */
373static inline bool s3c24xx_spi_usefiq(struct s3c24xx_spi *hw)
374{
375 return hw->pdata->use_fiq;
376}
377
378/**
379 * s3c24xx_spi_usingfiq - return if channel is using FIQ
380 * @spi: The hardware state.
381 *
382 * Return whether the channel is currently using the FIQ (separate from
383 * whether the FIQ is claimed).
384 */
385static inline bool s3c24xx_spi_usingfiq(struct s3c24xx_spi *spi)
386{
387 return spi->fiq_inuse;
388}
389#else
390
391static inline void s3c24xx_spi_initfiq(struct s3c24xx_spi *s) { }
392static inline void s3c24xx_spi_tryfiq(struct s3c24xx_spi *s) { }
393static inline bool s3c24xx_spi_usefiq(struct s3c24xx_spi *s) { return false; }
394static inline bool s3c24xx_spi_usingfiq(struct s3c24xx_spi *s) { return false; }
395
396#endif /* CONFIG_SPI_S3C24XX_FIQ */
397
398static int s3c24xx_spi_txrx(struct spi_device *spi, struct spi_transfer *t)
399{
400 struct s3c24xx_spi *hw = to_hw(spi);
401
402 hw->tx = t->tx_buf;
403 hw->rx = t->rx_buf;
404 hw->len = t->len;
405 hw->count = 0;
406
407 init_completion(&hw->done);
408
409 hw->fiq_inuse = 0;
410 if (s3c24xx_spi_usefiq(hw) && t->len >= 3)
411 s3c24xx_spi_tryfiq(hw);
412
413 /* send the first byte */
414 writeb(hw_txbyte(hw, 0), hw->regs + S3C2410_SPTDAT);
415
416 wait_for_completion(&hw->done);
417 return hw->count;
418}
419
420static irqreturn_t s3c24xx_spi_irq(int irq, void *dev)
421{
422 struct s3c24xx_spi *hw = dev;
423 unsigned int spsta = readb(hw->regs + S3C2410_SPSTA);
424 unsigned int count = hw->count;
425
426 if (spsta & S3C2410_SPSTA_DCOL) {
427 dev_dbg(hw->dev, "data-collision\n");
428 complete(&hw->done);
429 goto irq_done;
430 }
431
432 if (!(spsta & S3C2410_SPSTA_READY)) {
433 dev_dbg(hw->dev, "spi not ready for tx?\n");
434 complete(&hw->done);
435 goto irq_done;
436 }
437
438 if (!s3c24xx_spi_usingfiq(hw)) {
439 hw->count++;
440
441 if (hw->rx)
442 hw->rx[count] = readb(hw->regs + S3C2410_SPRDAT);
443
444 count++;
445
446 if (count < hw->len)
447 writeb(hw_txbyte(hw, count), hw->regs + S3C2410_SPTDAT);
448 else
449 complete(&hw->done);
450 } else {
451 hw->count = hw->len;
452 hw->fiq_inuse = 0;
453
454 if (hw->rx)
455 hw->rx[hw->len-1] = readb(hw->regs + S3C2410_SPRDAT);
456
457 complete(&hw->done);
458 }
459
460 irq_done:
461 return IRQ_HANDLED;
462}
463
464static void s3c24xx_spi_initialsetup(struct s3c24xx_spi *hw)
465{
466 /* for the moment, permanently enable the clock */
467
468 clk_enable(hw->clk);
469
470 /* program defaults into the registers */
471
472 writeb(0xff, hw->regs + S3C2410_SPPRE);
473 writeb(SPPIN_DEFAULT, hw->regs + S3C2410_SPPIN);
474 writeb(SPCON_DEFAULT, hw->regs + S3C2410_SPCON);
475
476 if (hw->pdata) {
477 if (hw->set_cs == s3c24xx_spi_gpiocs)
478 gpio_direction_output(hw->pdata->pin_cs, 1);
479
480 if (hw->pdata->gpio_setup)
481 hw->pdata->gpio_setup(hw->pdata, 1);
482 }
483}
484
485static int s3c24xx_spi_probe(struct platform_device *pdev)
486{
487 struct s3c2410_spi_info *pdata;
488 struct s3c24xx_spi *hw;
489 struct spi_master *master;
490 int err = 0;
491
492 master = spi_alloc_master(&pdev->dev, sizeof(struct s3c24xx_spi));
493 if (master == NULL) {
494 dev_err(&pdev->dev, "No memory for spi_master\n");
495 return -ENOMEM;
496 }
497
498 hw = spi_master_get_devdata(master);
499
500 hw->master = master;
501 hw->pdata = pdata = dev_get_platdata(&pdev->dev);
502 hw->dev = &pdev->dev;
503
504 if (pdata == NULL) {
505 dev_err(&pdev->dev, "No platform data supplied\n");
506 err = -ENOENT;
507 goto err_no_pdata;
508 }
509
510 platform_set_drvdata(pdev, hw);
511 init_completion(&hw->done);
512
513 /* initialise fiq handler */
514
515 s3c24xx_spi_initfiq(hw);
516
517 /* setup the master state. */
518
519 /* the spi->mode bits understood by this driver: */
520 master->mode_bits = SPI_CPOL | SPI_CPHA | SPI_CS_HIGH;
521
522 master->num_chipselect = hw->pdata->num_cs;
523 master->bus_num = pdata->bus_num;
524 master->bits_per_word_mask = SPI_BPW_MASK(8);
525
526 /* setup the state for the bitbang driver */
527
528 hw->bitbang.master = hw->master;
529 hw->bitbang.setup_transfer = s3c24xx_spi_setupxfer;
530 hw->bitbang.chipselect = s3c24xx_spi_chipsel;
531 hw->bitbang.txrx_bufs = s3c24xx_spi_txrx;
532
533 hw->master->setup = s3c24xx_spi_setup;
534
535 dev_dbg(hw->dev, "bitbang at %p\n", &hw->bitbang);
536
537 /* find and map our resources */
538 hw->regs = devm_platform_ioremap_resource(pdev, 0);
539 if (IS_ERR(hw->regs)) {
540 err = PTR_ERR(hw->regs);
541 goto err_no_pdata;
542 }
543
544 hw->irq = platform_get_irq(pdev, 0);
545 if (hw->irq < 0) {
546 err = -ENOENT;
547 goto err_no_pdata;
548 }
549
550 err = devm_request_irq(&pdev->dev, hw->irq, s3c24xx_spi_irq, 0,
551 pdev->name, hw);
552 if (err) {
553 dev_err(&pdev->dev, "Cannot claim IRQ\n");
554 goto err_no_pdata;
555 }
556
557 hw->clk = devm_clk_get(&pdev->dev, "spi");
558 if (IS_ERR(hw->clk)) {
559 dev_err(&pdev->dev, "No clock for device\n");
560 err = PTR_ERR(hw->clk);
561 goto err_no_pdata;
562 }
563
564 /* setup any gpio we can */
565
566 if (!pdata->set_cs) {
567 if (pdata->pin_cs < 0) {
568 dev_err(&pdev->dev, "No chipselect pin\n");
569 err = -EINVAL;
570 goto err_register;
571 }
572
573 err = devm_gpio_request(&pdev->dev, pdata->pin_cs,
574 dev_name(&pdev->dev));
575 if (err) {
576 dev_err(&pdev->dev, "Failed to get gpio for cs\n");
577 goto err_register;
578 }
579
580 hw->set_cs = s3c24xx_spi_gpiocs;
581 gpio_direction_output(pdata->pin_cs, 1);
582 } else
583 hw->set_cs = pdata->set_cs;
584
585 s3c24xx_spi_initialsetup(hw);
586
587 /* register our spi controller */
588
589 err = spi_bitbang_start(&hw->bitbang);
590 if (err) {
591 dev_err(&pdev->dev, "Failed to register SPI master\n");
592 goto err_register;
593 }
594
595 return 0;
596
597 err_register:
598 clk_disable(hw->clk);
599
600 err_no_pdata:
601 spi_master_put(hw->master);
602 return err;
603}
604
605static int s3c24xx_spi_remove(struct platform_device *dev)
606{
607 struct s3c24xx_spi *hw = platform_get_drvdata(dev);
608
609 spi_bitbang_stop(&hw->bitbang);
610 clk_disable(hw->clk);
611 spi_master_put(hw->master);
612 return 0;
613}
614
615
616#ifdef CONFIG_PM
617
618static int s3c24xx_spi_suspend(struct device *dev)
619{
620 struct s3c24xx_spi *hw = dev_get_drvdata(dev);
621 int ret;
622
623 ret = spi_master_suspend(hw->master);
624 if (ret)
625 return ret;
626
627 if (hw->pdata && hw->pdata->gpio_setup)
628 hw->pdata->gpio_setup(hw->pdata, 0);
629
630 clk_disable(hw->clk);
631 return 0;
632}
633
634static int s3c24xx_spi_resume(struct device *dev)
635{
636 struct s3c24xx_spi *hw = dev_get_drvdata(dev);
637
638 s3c24xx_spi_initialsetup(hw);
639 return spi_master_resume(hw->master);
640}
641
642static const struct dev_pm_ops s3c24xx_spi_pmops = {
643 .suspend = s3c24xx_spi_suspend,
644 .resume = s3c24xx_spi_resume,
645};
646
647#define S3C24XX_SPI_PMOPS &s3c24xx_spi_pmops
648#else
649#define S3C24XX_SPI_PMOPS NULL
650#endif /* CONFIG_PM */
651
652MODULE_ALIAS("platform:s3c2410-spi");
653static struct platform_driver s3c24xx_spi_driver = {
654 .probe = s3c24xx_spi_probe,
655 .remove = s3c24xx_spi_remove,
656 .driver = {
657 .name = "s3c2410-spi",
658 .pm = S3C24XX_SPI_PMOPS,
659 },
660};
661module_platform_driver(s3c24xx_spi_driver);
662
663MODULE_DESCRIPTION("S3C24XX SPI Driver");
664MODULE_AUTHOR("Ben Dooks, <ben@simtec.co.uk>");
665MODULE_LICENSE("GPL");