2 * Designware SPI core controller driver (refer pxa2xx_spi.c)
4 * Copyright (c) 2009, Intel Corporation.
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms and conditions of the GNU General Public License,
8 * version 2, as published by the Free Software Foundation.
10 * This program is distributed in the hope it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
16 #include <linux/dma-mapping.h>
17 #include <linux/interrupt.h>
18 #include <linux/module.h>
19 #include <linux/highmem.h>
20 #include <linux/delay.h>
21 #include <linux/slab.h>
22 #include <linux/spi/spi.h>
23 #include <linux/gpio.h>
27 #ifdef CONFIG_DEBUG_FS
28 #include <linux/debugfs.h>
31 /* Slave spi_dev related */
33 u8 tmode; /* TR/TO/RO/EEPROM */
34 u8 type; /* SPI/SSP/MicroWire */
36 u8 poll_mode; /* 1 means use poll mode */
38 u16 clk_div; /* baud rate divider */
39 u32 speed_hz; /* baud rate */
40 void (*cs_control)(u32 command);
43 #ifdef CONFIG_DEBUG_FS
44 #define SPI_REGS_BUFSIZE 1024
45 static ssize_t dw_spi_show_regs(struct file *file, char __user *user_buf,
46 size_t count, loff_t *ppos)
48 struct dw_spi *dws = file->private_data;
53 buf = kzalloc(SPI_REGS_BUFSIZE, GFP_KERNEL);
57 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
58 "%s registers:\n", dev_name(&dws->master->dev));
59 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
60 "=================================\n");
61 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
62 "CTRL0: \t\t0x%08x\n", dw_readl(dws, DW_SPI_CTRL0));
63 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
64 "CTRL1: \t\t0x%08x\n", dw_readl(dws, DW_SPI_CTRL1));
65 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
66 "SSIENR: \t0x%08x\n", dw_readl(dws, DW_SPI_SSIENR));
67 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
68 "SER: \t\t0x%08x\n", dw_readl(dws, DW_SPI_SER));
69 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
70 "BAUDR: \t\t0x%08x\n", dw_readl(dws, DW_SPI_BAUDR));
71 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
72 "TXFTLR: \t0x%08x\n", dw_readl(dws, DW_SPI_TXFLTR));
73 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
74 "RXFTLR: \t0x%08x\n", dw_readl(dws, DW_SPI_RXFLTR));
75 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
76 "TXFLR: \t\t0x%08x\n", dw_readl(dws, DW_SPI_TXFLR));
77 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
78 "RXFLR: \t\t0x%08x\n", dw_readl(dws, DW_SPI_RXFLR));
79 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
80 "SR: \t\t0x%08x\n", dw_readl(dws, DW_SPI_SR));
81 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
82 "IMR: \t\t0x%08x\n", dw_readl(dws, DW_SPI_IMR));
83 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
84 "ISR: \t\t0x%08x\n", dw_readl(dws, DW_SPI_ISR));
85 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
86 "DMACR: \t\t0x%08x\n", dw_readl(dws, DW_SPI_DMACR));
87 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
88 "DMATDLR: \t0x%08x\n", dw_readl(dws, DW_SPI_DMATDLR));
89 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
90 "DMARDLR: \t0x%08x\n", dw_readl(dws, DW_SPI_DMARDLR));
91 len += snprintf(buf + len, SPI_REGS_BUFSIZE - len,
92 "=================================\n");
94 ret = simple_read_from_buffer(user_buf, count, ppos, buf, len);
99 static const struct file_operations dw_spi_regs_ops = {
100 .owner = THIS_MODULE,
102 .read = dw_spi_show_regs,
103 .llseek = default_llseek,
106 static int dw_spi_debugfs_init(struct dw_spi *dws)
110 snprintf(name, 32, "dw_spi%d", dws->master->bus_num);
111 dws->debugfs = debugfs_create_dir(name, NULL);
115 debugfs_create_file("registers", S_IFREG | S_IRUGO,
116 dws->debugfs, (void *)dws, &dw_spi_regs_ops);
120 static void dw_spi_debugfs_remove(struct dw_spi *dws)
122 debugfs_remove_recursive(dws->debugfs);
126 static inline int dw_spi_debugfs_init(struct dw_spi *dws)
131 static inline void dw_spi_debugfs_remove(struct dw_spi *dws)
134 #endif /* CONFIG_DEBUG_FS */
136 void dw_spi_set_cs(struct spi_device *spi, bool enable)
138 struct dw_spi *dws = spi_controller_get_devdata(spi->controller);
139 struct chip_data *chip = spi_get_ctldata(spi);
141 /* Chip select logic is inverted from spi_set_cs() */
142 if (chip && chip->cs_control)
143 chip->cs_control(!enable);
146 dw_writel(dws, DW_SPI_SER, BIT(spi->chip_select));
148 EXPORT_SYMBOL_GPL(dw_spi_set_cs);
150 /* Return the max entries we can fill into tx fifo */
151 static inline u32 tx_max(struct dw_spi *dws)
153 u32 tx_left, tx_room, rxtx_gap;
155 tx_left = (dws->tx_end - dws->tx) / dws->n_bytes;
156 tx_room = dws->fifo_len - dw_readl(dws, DW_SPI_TXFLR);
159 * Another concern is about the tx/rx mismatch, we
160 * though to use (dws->fifo_len - rxflr - txflr) as
161 * one maximum value for tx, but it doesn't cover the
162 * data which is out of tx/rx fifo and inside the
163 * shift registers. So a control from sw point of
166 rxtx_gap = ((dws->rx_end - dws->rx) - (dws->tx_end - dws->tx))
169 return min3(tx_left, tx_room, (u32) (dws->fifo_len - rxtx_gap));
172 /* Return the max entries we should read out of rx fifo */
173 static inline u32 rx_max(struct dw_spi *dws)
175 u32 rx_left = (dws->rx_end - dws->rx) / dws->n_bytes;
177 return min_t(u32, rx_left, dw_readl(dws, DW_SPI_RXFLR));
180 static void dw_writer(struct dw_spi *dws)
185 spin_lock(&dws->buf_lock);
188 /* Set the tx word if the transfer's original "tx" is not null */
189 if (dws->tx_end - dws->len) {
190 if (dws->n_bytes == 1)
191 txw = *(u8 *)(dws->tx);
193 txw = *(u16 *)(dws->tx);
195 dw_write_io_reg(dws, DW_SPI_DR, txw);
196 dws->tx += dws->n_bytes;
198 spin_unlock(&dws->buf_lock);
201 static void dw_reader(struct dw_spi *dws)
206 spin_lock(&dws->buf_lock);
209 rxw = dw_read_io_reg(dws, DW_SPI_DR);
210 /* Care rx only if the transfer's original "rx" is not null */
211 if (dws->rx_end - dws->len) {
212 if (dws->n_bytes == 1)
213 *(u8 *)(dws->rx) = rxw;
215 *(u16 *)(dws->rx) = rxw;
217 dws->rx += dws->n_bytes;
219 spin_unlock(&dws->buf_lock);
222 static void int_error_stop(struct dw_spi *dws, const char *msg)
226 dev_err(&dws->master->dev, "%s\n", msg);
227 dws->master->cur_msg->status = -EIO;
228 spi_finalize_current_transfer(dws->master);
231 static irqreturn_t interrupt_transfer(struct dw_spi *dws)
233 u16 irq_status = dw_readl(dws, DW_SPI_ISR);
236 if (irq_status & (SPI_INT_TXOI | SPI_INT_RXOI | SPI_INT_RXUI)) {
237 dw_readl(dws, DW_SPI_ICR);
238 int_error_stop(dws, "interrupt_transfer: fifo overrun/underrun");
243 if (dws->rx_end == dws->rx) {
244 spi_mask_intr(dws, SPI_INT_TXEI);
245 spi_finalize_current_transfer(dws->master);
248 if (irq_status & SPI_INT_TXEI) {
249 spi_mask_intr(dws, SPI_INT_TXEI);
251 /* Enable TX irq always, it will be disabled when RX finished */
252 spi_umask_intr(dws, SPI_INT_TXEI);
258 static irqreturn_t dw_spi_irq(int irq, void *dev_id)
260 struct spi_controller *master = dev_id;
261 struct dw_spi *dws = spi_controller_get_devdata(master);
262 u16 irq_status = dw_readl(dws, DW_SPI_ISR) & 0x3f;
267 if (!master->cur_msg) {
268 spi_mask_intr(dws, SPI_INT_TXEI);
272 return dws->transfer_handler(dws);
275 /* Must be called inside pump_transfers() */
276 static int poll_transfer(struct dw_spi *dws)
282 } while (dws->rx_end > dws->rx);
287 static int dw_spi_transfer_one(struct spi_controller *master,
288 struct spi_device *spi, struct spi_transfer *transfer)
290 struct dw_spi *dws = spi_controller_get_devdata(master);
291 struct chip_data *chip = spi_get_ctldata(spi);
299 spin_lock_irqsave(&dws->buf_lock, flags);
300 dws->tx = (void *)transfer->tx_buf;
301 dws->tx_end = dws->tx + transfer->len;
302 dws->rx = transfer->rx_buf;
303 dws->rx_end = dws->rx + transfer->len;
304 dws->len = transfer->len;
305 spin_unlock_irqrestore(&dws->buf_lock, flags);
307 /* Ensure dw->rx and dw->rx_end are visible */
310 spi_enable_chip(dws, 0);
312 /* Handle per transfer options for bpw and speed */
313 if (transfer->speed_hz != dws->current_freq) {
314 if (transfer->speed_hz != chip->speed_hz) {
315 /* clk_div doesn't support odd number */
316 chip->clk_div = (DIV_ROUND_UP(dws->max_freq, transfer->speed_hz) + 1) & 0xfffe;
317 chip->speed_hz = transfer->speed_hz;
319 dws->current_freq = transfer->speed_hz;
320 spi_set_clk(dws, chip->clk_div);
322 if (transfer->bits_per_word == 8) {
325 } else if (transfer->bits_per_word == 16) {
331 /* Default SPI mode is SCPOL = 0, SCPH = 0 */
332 cr0 = (transfer->bits_per_word - 1)
333 | (chip->type << SPI_FRF_OFFSET)
334 | (spi->mode << SPI_MODE_OFFSET)
335 | (chip->tmode << SPI_TMOD_OFFSET);
338 * Adjust transfer mode if necessary. Requires platform dependent
339 * chipselect mechanism.
341 if (chip->cs_control) {
342 if (dws->rx && dws->tx)
343 chip->tmode = SPI_TMOD_TR;
345 chip->tmode = SPI_TMOD_RO;
347 chip->tmode = SPI_TMOD_TO;
349 cr0 &= ~SPI_TMOD_MASK;
350 cr0 |= (chip->tmode << SPI_TMOD_OFFSET);
353 dw_writel(dws, DW_SPI_CTRL0, cr0);
355 /* Check if current transfer is a DMA transaction */
356 if (master->can_dma && master->can_dma(master, spi, transfer))
357 dws->dma_mapped = master->cur_msg_mapped;
359 /* For poll mode just disable all interrupts */
360 spi_mask_intr(dws, 0xff);
364 * we only need set the TXEI IRQ, as TX/RX always happen syncronizely
366 if (dws->dma_mapped) {
367 ret = dws->dma_ops->dma_setup(dws, transfer);
369 spi_enable_chip(dws, 1);
372 } else if (!chip->poll_mode) {
373 txlevel = min_t(u16, dws->fifo_len / 2, dws->len / dws->n_bytes);
374 dw_writel(dws, DW_SPI_TXFLTR, txlevel);
376 /* Set the interrupt mask */
377 imask |= SPI_INT_TXEI | SPI_INT_TXOI |
378 SPI_INT_RXUI | SPI_INT_RXOI;
379 spi_umask_intr(dws, imask);
381 dws->transfer_handler = interrupt_transfer;
384 spi_enable_chip(dws, 1);
387 return dws->dma_ops->dma_transfer(dws, transfer);
390 return poll_transfer(dws);
395 static void dw_spi_handle_err(struct spi_controller *master,
396 struct spi_message *msg)
398 struct dw_spi *dws = spi_controller_get_devdata(master);
401 dws->dma_ops->dma_stop(dws);
406 /* This may be called twice for each spi dev */
407 static int dw_spi_setup(struct spi_device *spi)
409 struct dw_spi_chip *chip_info = NULL;
410 struct chip_data *chip;
413 /* Only alloc on first setup */
414 chip = spi_get_ctldata(spi);
416 chip = kzalloc(sizeof(struct chip_data), GFP_KERNEL);
419 spi_set_ctldata(spi, chip);
423 * Protocol drivers may change the chip settings, so...
424 * if chip_info exists, use it
426 chip_info = spi->controller_data;
428 /* chip_info doesn't always exist */
430 if (chip_info->cs_control)
431 chip->cs_control = chip_info->cs_control;
433 chip->poll_mode = chip_info->poll_mode;
434 chip->type = chip_info->type;
437 chip->tmode = SPI_TMOD_TR;
439 if (gpio_is_valid(spi->cs_gpio)) {
440 ret = gpio_direction_output(spi->cs_gpio,
441 !(spi->mode & SPI_CS_HIGH));
449 static void dw_spi_cleanup(struct spi_device *spi)
451 struct chip_data *chip = spi_get_ctldata(spi);
454 spi_set_ctldata(spi, NULL);
457 /* Restart the controller, disable all interrupts, clean rx fifo */
458 static void spi_hw_init(struct device *dev, struct dw_spi *dws)
463 * Try to detect the FIFO depth if not set by interface driver,
464 * the depth could be from 2 to 256 from HW spec
466 if (!dws->fifo_len) {
469 for (fifo = 1; fifo < 256; fifo++) {
470 dw_writel(dws, DW_SPI_TXFLTR, fifo);
471 if (fifo != dw_readl(dws, DW_SPI_TXFLTR))
474 dw_writel(dws, DW_SPI_TXFLTR, 0);
476 dws->fifo_len = (fifo == 1) ? 0 : fifo;
477 dev_dbg(dev, "Detected FIFO size: %u bytes\n", dws->fifo_len);
481 int dw_spi_add_host(struct device *dev, struct dw_spi *dws)
483 struct spi_controller *master;
488 master = spi_alloc_master(dev, 0);
492 dws->master = master;
493 dws->type = SSI_MOTO_SPI;
495 dws->dma_addr = (dma_addr_t)(dws->paddr + DW_SPI_DR);
496 spin_lock_init(&dws->buf_lock);
498 spi_controller_set_devdata(master, dws);
500 ret = request_irq(dws->irq, dw_spi_irq, IRQF_SHARED, dev_name(dev),
503 dev_err(dev, "can not get IRQ\n");
504 goto err_free_master;
507 master->mode_bits = SPI_CPOL | SPI_CPHA | SPI_LOOP;
508 master->bits_per_word_mask = SPI_BPW_MASK(8) | SPI_BPW_MASK(16);
509 master->bus_num = dws->bus_num;
510 master->num_chipselect = dws->num_cs;
511 master->setup = dw_spi_setup;
512 master->cleanup = dw_spi_cleanup;
513 master->set_cs = dw_spi_set_cs;
514 master->transfer_one = dw_spi_transfer_one;
515 master->handle_err = dw_spi_handle_err;
516 master->max_speed_hz = dws->max_freq;
517 master->dev.of_node = dev->of_node;
518 master->flags = SPI_MASTER_GPIO_SS;
521 master->set_cs = dws->set_cs;
524 spi_hw_init(dev, dws);
526 if (dws->dma_ops && dws->dma_ops->dma_init) {
527 ret = dws->dma_ops->dma_init(dws);
529 dev_warn(dev, "DMA init failed\n");
532 master->can_dma = dws->dma_ops->can_dma;
533 master->flags |= SPI_CONTROLLER_MUST_TX;
537 ret = spi_register_controller(master);
539 dev_err(&master->dev, "problem registering spi master\n");
543 dw_spi_debugfs_init(dws);
547 if (dws->dma_ops && dws->dma_ops->dma_exit)
548 dws->dma_ops->dma_exit(dws);
549 spi_enable_chip(dws, 0);
550 free_irq(dws->irq, master);
552 spi_controller_put(master);
555 EXPORT_SYMBOL_GPL(dw_spi_add_host);
557 void dw_spi_remove_host(struct dw_spi *dws)
559 dw_spi_debugfs_remove(dws);
561 spi_unregister_controller(dws->master);
563 if (dws->dma_ops && dws->dma_ops->dma_exit)
564 dws->dma_ops->dma_exit(dws);
566 spi_shutdown_chip(dws);
568 free_irq(dws->irq, dws->master);
570 EXPORT_SYMBOL_GPL(dw_spi_remove_host);
572 int dw_spi_suspend_host(struct dw_spi *dws)
576 ret = spi_controller_suspend(dws->master);
580 spi_shutdown_chip(dws);
583 EXPORT_SYMBOL_GPL(dw_spi_suspend_host);
585 int dw_spi_resume_host(struct dw_spi *dws)
589 spi_hw_init(&dws->master->dev, dws);
590 ret = spi_controller_resume(dws->master);
592 dev_err(&dws->master->dev, "fail to start queue (%d)\n", ret);
595 EXPORT_SYMBOL_GPL(dw_spi_resume_host);
597 MODULE_AUTHOR("Feng Tang <feng.tang@intel.com>");
598 MODULE_DESCRIPTION("Driver for DesignWare SPI controller core");
599 MODULE_LICENSE("GPL v2");