1 // SPDX-License-Identifier: GPL-2.0-only
3 * SPI-Engine SPI controller driver
4 * Copyright 2015 Analog Devices Inc.
5 * Author: Lars-Peter Clausen <lars@metafoo.de>
9 #include <linux/completion.h>
10 #include <linux/fpga/adi-axi-common.h>
11 #include <linux/interrupt.h>
14 #include <linux/module.h>
15 #include <linux/overflow.h>
16 #include <linux/platform_device.h>
17 #include <linux/spi/spi.h>
19 #define SPI_ENGINE_REG_RESET 0x40
21 #define SPI_ENGINE_REG_INT_ENABLE 0x80
22 #define SPI_ENGINE_REG_INT_PENDING 0x84
23 #define SPI_ENGINE_REG_INT_SOURCE 0x88
25 #define SPI_ENGINE_REG_SYNC_ID 0xc0
27 #define SPI_ENGINE_REG_CMD_FIFO_ROOM 0xd0
28 #define SPI_ENGINE_REG_SDO_FIFO_ROOM 0xd4
29 #define SPI_ENGINE_REG_SDI_FIFO_LEVEL 0xd8
31 #define SPI_ENGINE_REG_CMD_FIFO 0xe0
32 #define SPI_ENGINE_REG_SDO_DATA_FIFO 0xe4
33 #define SPI_ENGINE_REG_SDI_DATA_FIFO 0xe8
34 #define SPI_ENGINE_REG_SDI_DATA_FIFO_PEEK 0xec
36 #define SPI_ENGINE_INT_CMD_ALMOST_EMPTY BIT(0)
37 #define SPI_ENGINE_INT_SDO_ALMOST_EMPTY BIT(1)
38 #define SPI_ENGINE_INT_SDI_ALMOST_FULL BIT(2)
39 #define SPI_ENGINE_INT_SYNC BIT(3)
41 #define SPI_ENGINE_CONFIG_CPHA BIT(0)
42 #define SPI_ENGINE_CONFIG_CPOL BIT(1)
43 #define SPI_ENGINE_CONFIG_3WIRE BIT(2)
45 #define SPI_ENGINE_INST_TRANSFER 0x0
46 #define SPI_ENGINE_INST_ASSERT 0x1
47 #define SPI_ENGINE_INST_WRITE 0x2
48 #define SPI_ENGINE_INST_MISC 0x3
50 #define SPI_ENGINE_CMD_REG_CLK_DIV 0x0
51 #define SPI_ENGINE_CMD_REG_CONFIG 0x1
52 #define SPI_ENGINE_CMD_REG_XFER_BITS 0x2
54 #define SPI_ENGINE_MISC_SYNC 0x0
55 #define SPI_ENGINE_MISC_SLEEP 0x1
57 #define SPI_ENGINE_TRANSFER_WRITE 0x1
58 #define SPI_ENGINE_TRANSFER_READ 0x2
60 /* Arbitrary sync ID for use by host->cur_msg */
61 #define AXI_SPI_ENGINE_CUR_MSG_SYNC_ID 0x1
63 #define SPI_ENGINE_CMD(inst, arg1, arg2) \
64 (((inst) << 12) | ((arg1) << 8) | (arg2))
66 #define SPI_ENGINE_CMD_TRANSFER(flags, n) \
67 SPI_ENGINE_CMD(SPI_ENGINE_INST_TRANSFER, (flags), (n))
68 #define SPI_ENGINE_CMD_ASSERT(delay, cs) \
69 SPI_ENGINE_CMD(SPI_ENGINE_INST_ASSERT, (delay), (cs))
70 #define SPI_ENGINE_CMD_WRITE(reg, val) \
71 SPI_ENGINE_CMD(SPI_ENGINE_INST_WRITE, (reg), (val))
72 #define SPI_ENGINE_CMD_SLEEP(delay) \
73 SPI_ENGINE_CMD(SPI_ENGINE_INST_MISC, SPI_ENGINE_MISC_SLEEP, (delay))
74 #define SPI_ENGINE_CMD_SYNC(id) \
75 SPI_ENGINE_CMD(SPI_ENGINE_INST_MISC, SPI_ENGINE_MISC_SYNC, (id))
77 struct spi_engine_program {
79 uint16_t instructions[] __counted_by(length);
83 * struct spi_engine_message_state - SPI engine per-message state
85 struct spi_engine_message_state {
86 /** @cmd_length: Number of elements in cmd_buf array. */
88 /** @cmd_buf: Array of commands not yet written to CMD FIFO. */
89 const uint16_t *cmd_buf;
90 /** @tx_xfer: Next xfer with tx_buf not yet fully written to TX FIFO. */
91 struct spi_transfer *tx_xfer;
92 /** @tx_length: Size of tx_buf in bytes. */
93 unsigned int tx_length;
94 /** @tx_buf: Bytes not yet written to TX FIFO. */
95 const uint8_t *tx_buf;
96 /** @rx_xfer: Next xfer with rx_buf not yet fully written to RX FIFO. */
97 struct spi_transfer *rx_xfer;
98 /** @rx_length: Size of tx_buf in bytes. */
99 unsigned int rx_length;
100 /** @rx_buf: Bytes not yet written to the RX FIFO. */
111 struct spi_engine_message_state msg_state;
112 struct completion msg_complete;
113 unsigned int int_enable;
116 static void spi_engine_program_add_cmd(struct spi_engine_program *p,
117 bool dry, uint16_t cmd)
122 p->instructions[p->length - 1] = cmd;
125 static unsigned int spi_engine_get_config(struct spi_device *spi)
127 unsigned int config = 0;
129 if (spi->mode & SPI_CPOL)
130 config |= SPI_ENGINE_CONFIG_CPOL;
131 if (spi->mode & SPI_CPHA)
132 config |= SPI_ENGINE_CONFIG_CPHA;
133 if (spi->mode & SPI_3WIRE)
134 config |= SPI_ENGINE_CONFIG_3WIRE;
139 static void spi_engine_gen_xfer(struct spi_engine_program *p, bool dry,
140 struct spi_transfer *xfer)
144 if (xfer->bits_per_word <= 8)
146 else if (xfer->bits_per_word <= 16)
152 unsigned int n = min(len, 256U);
153 unsigned int flags = 0;
156 flags |= SPI_ENGINE_TRANSFER_WRITE;
158 flags |= SPI_ENGINE_TRANSFER_READ;
160 spi_engine_program_add_cmd(p, dry,
161 SPI_ENGINE_CMD_TRANSFER(flags, n - 1));
166 static void spi_engine_gen_sleep(struct spi_engine_program *p, bool dry,
167 int delay_ns, u32 sclk_hz)
171 /* negative delay indicates error, e.g. from spi_delay_to_ns() */
175 /* rounding down since executing the instruction adds a couple of ticks delay */
176 t = DIV_ROUND_DOWN_ULL((u64)delay_ns * sclk_hz, NSEC_PER_SEC);
178 unsigned int n = min(t, 256U);
180 spi_engine_program_add_cmd(p, dry, SPI_ENGINE_CMD_SLEEP(n - 1));
185 static void spi_engine_gen_cs(struct spi_engine_program *p, bool dry,
186 struct spi_device *spi, bool assert)
188 unsigned int mask = 0xff;
191 mask ^= BIT(spi_get_chipselect(spi, 0));
193 spi_engine_program_add_cmd(p, dry, SPI_ENGINE_CMD_ASSERT(0, mask));
197 * Performs precompile steps on the message.
199 * The SPI core does most of the message/transfer validation and filling in
200 * fields for us via __spi_validate(). This fixes up anything remaining not
203 * NB: This is separate from spi_engine_compile_message() because the latter
204 * is called twice and would otherwise result in double-evaluation.
206 static void spi_engine_precompile_message(struct spi_message *msg)
208 unsigned int clk_div, max_hz = msg->spi->controller->max_speed_hz;
209 struct spi_transfer *xfer;
211 list_for_each_entry(xfer, &msg->transfers, transfer_list) {
212 clk_div = DIV_ROUND_UP(max_hz, xfer->speed_hz);
213 xfer->effective_speed_hz = max_hz / min(clk_div, 256U);
217 static void spi_engine_compile_message(struct spi_message *msg, bool dry,
218 struct spi_engine_program *p)
220 struct spi_device *spi = msg->spi;
221 struct spi_controller *host = spi->controller;
222 struct spi_transfer *xfer;
223 int clk_div, new_clk_div;
224 bool keep_cs = false;
225 u8 bits_per_word = 0;
229 spi_engine_program_add_cmd(p, dry,
230 SPI_ENGINE_CMD_WRITE(SPI_ENGINE_CMD_REG_CONFIG,
231 spi_engine_get_config(spi)));
233 xfer = list_first_entry(&msg->transfers, struct spi_transfer, transfer_list);
234 spi_engine_gen_cs(p, dry, spi, !xfer->cs_off);
236 list_for_each_entry(xfer, &msg->transfers, transfer_list) {
237 new_clk_div = host->max_speed_hz / xfer->effective_speed_hz;
238 if (new_clk_div != clk_div) {
239 clk_div = new_clk_div;
240 /* actual divider used is register value + 1 */
241 spi_engine_program_add_cmd(p, dry,
242 SPI_ENGINE_CMD_WRITE(SPI_ENGINE_CMD_REG_CLK_DIV,
246 if (bits_per_word != xfer->bits_per_word) {
247 bits_per_word = xfer->bits_per_word;
248 spi_engine_program_add_cmd(p, dry,
249 SPI_ENGINE_CMD_WRITE(SPI_ENGINE_CMD_REG_XFER_BITS,
253 spi_engine_gen_xfer(p, dry, xfer);
254 spi_engine_gen_sleep(p, dry, spi_delay_to_ns(&xfer->delay, xfer),
255 xfer->effective_speed_hz);
257 if (xfer->cs_change) {
258 if (list_is_last(&xfer->transfer_list, &msg->transfers)) {
262 spi_engine_gen_cs(p, dry, spi, false);
264 spi_engine_gen_sleep(p, dry, spi_delay_to_ns(
265 &xfer->cs_change_delay, xfer),
266 xfer->effective_speed_hz);
268 if (!list_next_entry(xfer, transfer_list)->cs_off)
269 spi_engine_gen_cs(p, dry, spi, true);
271 } else if (!list_is_last(&xfer->transfer_list, &msg->transfers) &&
272 xfer->cs_off != list_next_entry(xfer, transfer_list)->cs_off) {
273 spi_engine_gen_cs(p, dry, spi, xfer->cs_off);
278 spi_engine_gen_cs(p, dry, spi, false);
281 * Restore clockdiv to default so that future gen_sleep commands don't
282 * have to be aware of the current register state.
285 spi_engine_program_add_cmd(p, dry,
286 SPI_ENGINE_CMD_WRITE(SPI_ENGINE_CMD_REG_CLK_DIV, 0));
289 static void spi_engine_xfer_next(struct spi_message *msg,
290 struct spi_transfer **_xfer)
292 struct spi_transfer *xfer = *_xfer;
295 xfer = list_first_entry(&msg->transfers,
296 struct spi_transfer, transfer_list);
297 } else if (list_is_last(&xfer->transfer_list, &msg->transfers)) {
300 xfer = list_next_entry(xfer, transfer_list);
306 static void spi_engine_tx_next(struct spi_message *msg)
308 struct spi_engine_message_state *st = msg->state;
309 struct spi_transfer *xfer = st->tx_xfer;
312 spi_engine_xfer_next(msg, &xfer);
313 } while (xfer && !xfer->tx_buf);
317 st->tx_length = xfer->len;
318 st->tx_buf = xfer->tx_buf;
324 static void spi_engine_rx_next(struct spi_message *msg)
326 struct spi_engine_message_state *st = msg->state;
327 struct spi_transfer *xfer = st->rx_xfer;
330 spi_engine_xfer_next(msg, &xfer);
331 } while (xfer && !xfer->rx_buf);
335 st->rx_length = xfer->len;
336 st->rx_buf = xfer->rx_buf;
342 static bool spi_engine_write_cmd_fifo(struct spi_engine *spi_engine,
343 struct spi_message *msg)
345 void __iomem *addr = spi_engine->base + SPI_ENGINE_REG_CMD_FIFO;
346 struct spi_engine_message_state *st = msg->state;
347 unsigned int n, m, i;
350 n = readl_relaxed(spi_engine->base + SPI_ENGINE_REG_CMD_FIFO_ROOM);
351 while (n && st->cmd_length) {
352 m = min(n, st->cmd_length);
354 for (i = 0; i < m; i++)
355 writel_relaxed(buf[i], addr);
361 return st->cmd_length != 0;
364 static bool spi_engine_write_tx_fifo(struct spi_engine *spi_engine,
365 struct spi_message *msg)
367 void __iomem *addr = spi_engine->base + SPI_ENGINE_REG_SDO_DATA_FIFO;
368 struct spi_engine_message_state *st = msg->state;
369 unsigned int n, m, i;
371 n = readl_relaxed(spi_engine->base + SPI_ENGINE_REG_SDO_FIFO_ROOM);
372 while (n && st->tx_length) {
373 if (st->tx_xfer->bits_per_word <= 8) {
374 const u8 *buf = st->tx_buf;
376 m = min(n, st->tx_length);
377 for (i = 0; i < m; i++)
378 writel_relaxed(buf[i], addr);
381 } else if (st->tx_xfer->bits_per_word <= 16) {
382 const u16 *buf = (const u16 *)st->tx_buf;
384 m = min(n, st->tx_length / 2);
385 for (i = 0; i < m; i++)
386 writel_relaxed(buf[i], addr);
388 st->tx_length -= m * 2;
390 const u32 *buf = (const u32 *)st->tx_buf;
392 m = min(n, st->tx_length / 4);
393 for (i = 0; i < m; i++)
394 writel_relaxed(buf[i], addr);
396 st->tx_length -= m * 4;
399 if (st->tx_length == 0)
400 spi_engine_tx_next(msg);
403 return st->tx_length != 0;
406 static bool spi_engine_read_rx_fifo(struct spi_engine *spi_engine,
407 struct spi_message *msg)
409 void __iomem *addr = spi_engine->base + SPI_ENGINE_REG_SDI_DATA_FIFO;
410 struct spi_engine_message_state *st = msg->state;
411 unsigned int n, m, i;
413 n = readl_relaxed(spi_engine->base + SPI_ENGINE_REG_SDI_FIFO_LEVEL);
414 while (n && st->rx_length) {
415 if (st->rx_xfer->bits_per_word <= 8) {
416 u8 *buf = st->rx_buf;
418 m = min(n, st->rx_length);
419 for (i = 0; i < m; i++)
420 buf[i] = readl_relaxed(addr);
423 } else if (st->rx_xfer->bits_per_word <= 16) {
424 u16 *buf = (u16 *)st->rx_buf;
426 m = min(n, st->rx_length / 2);
427 for (i = 0; i < m; i++)
428 buf[i] = readl_relaxed(addr);
430 st->rx_length -= m * 2;
432 u32 *buf = (u32 *)st->rx_buf;
434 m = min(n, st->rx_length / 4);
435 for (i = 0; i < m; i++)
436 buf[i] = readl_relaxed(addr);
438 st->rx_length -= m * 4;
441 if (st->rx_length == 0)
442 spi_engine_rx_next(msg);
445 return st->rx_length != 0;
448 static irqreturn_t spi_engine_irq(int irq, void *devid)
450 struct spi_controller *host = devid;
451 struct spi_message *msg = host->cur_msg;
452 struct spi_engine *spi_engine = spi_controller_get_devdata(host);
453 unsigned int disable_int = 0;
454 unsigned int pending;
455 int completed_id = -1;
457 pending = readl_relaxed(spi_engine->base + SPI_ENGINE_REG_INT_PENDING);
459 if (pending & SPI_ENGINE_INT_SYNC) {
460 writel_relaxed(SPI_ENGINE_INT_SYNC,
461 spi_engine->base + SPI_ENGINE_REG_INT_PENDING);
462 completed_id = readl_relaxed(
463 spi_engine->base + SPI_ENGINE_REG_SYNC_ID);
466 spin_lock(&spi_engine->lock);
468 if (pending & SPI_ENGINE_INT_CMD_ALMOST_EMPTY) {
469 if (!spi_engine_write_cmd_fifo(spi_engine, msg))
470 disable_int |= SPI_ENGINE_INT_CMD_ALMOST_EMPTY;
473 if (pending & SPI_ENGINE_INT_SDO_ALMOST_EMPTY) {
474 if (!spi_engine_write_tx_fifo(spi_engine, msg))
475 disable_int |= SPI_ENGINE_INT_SDO_ALMOST_EMPTY;
478 if (pending & (SPI_ENGINE_INT_SDI_ALMOST_FULL | SPI_ENGINE_INT_SYNC)) {
479 if (!spi_engine_read_rx_fifo(spi_engine, msg))
480 disable_int |= SPI_ENGINE_INT_SDI_ALMOST_FULL;
483 if (pending & SPI_ENGINE_INT_SYNC && msg) {
484 if (completed_id == AXI_SPI_ENGINE_CUR_MSG_SYNC_ID) {
486 msg->actual_length = msg->frame_length;
487 complete(&spi_engine->msg_complete);
488 disable_int |= SPI_ENGINE_INT_SYNC;
493 spi_engine->int_enable &= ~disable_int;
494 writel_relaxed(spi_engine->int_enable,
495 spi_engine->base + SPI_ENGINE_REG_INT_ENABLE);
498 spin_unlock(&spi_engine->lock);
503 static int spi_engine_optimize_message(struct spi_message *msg)
505 struct spi_engine_program p_dry, *p;
507 spi_engine_precompile_message(msg);
510 spi_engine_compile_message(msg, true, &p_dry);
512 p = kzalloc(struct_size(p, instructions, p_dry.length + 1), GFP_KERNEL);
516 spi_engine_compile_message(msg, false, p);
518 spi_engine_program_add_cmd(p, false, SPI_ENGINE_CMD_SYNC(
519 AXI_SPI_ENGINE_CUR_MSG_SYNC_ID));
526 static int spi_engine_unoptimize_message(struct spi_message *msg)
528 kfree(msg->opt_state);
533 static int spi_engine_transfer_one_message(struct spi_controller *host,
534 struct spi_message *msg)
536 struct spi_engine *spi_engine = spi_controller_get_devdata(host);
537 struct spi_engine_message_state *st = &spi_engine->msg_state;
538 struct spi_engine_program *p = msg->opt_state;
539 unsigned int int_enable = 0;
542 /* reinitialize message state for this transfer */
543 memset(st, 0, sizeof(*st));
544 st->cmd_buf = p->instructions;
545 st->cmd_length = p->length;
548 reinit_completion(&spi_engine->msg_complete);
550 spin_lock_irqsave(&spi_engine->lock, flags);
552 if (spi_engine_write_cmd_fifo(spi_engine, msg))
553 int_enable |= SPI_ENGINE_INT_CMD_ALMOST_EMPTY;
555 spi_engine_tx_next(msg);
556 if (spi_engine_write_tx_fifo(spi_engine, msg))
557 int_enable |= SPI_ENGINE_INT_SDO_ALMOST_EMPTY;
559 spi_engine_rx_next(msg);
560 if (st->rx_length != 0)
561 int_enable |= SPI_ENGINE_INT_SDI_ALMOST_FULL;
563 int_enable |= SPI_ENGINE_INT_SYNC;
565 writel_relaxed(int_enable,
566 spi_engine->base + SPI_ENGINE_REG_INT_ENABLE);
567 spi_engine->int_enable = int_enable;
568 spin_unlock_irqrestore(&spi_engine->lock, flags);
570 if (!wait_for_completion_timeout(&spi_engine->msg_complete,
571 msecs_to_jiffies(5000))) {
573 "Timeout occurred while waiting for transfer to complete. Hardware is probably broken.\n");
574 msg->status = -ETIMEDOUT;
577 spi_finalize_current_message(host);
582 static void spi_engine_release_hw(void *p)
584 struct spi_engine *spi_engine = p;
586 writel_relaxed(0xff, spi_engine->base + SPI_ENGINE_REG_INT_PENDING);
587 writel_relaxed(0x00, spi_engine->base + SPI_ENGINE_REG_INT_ENABLE);
588 writel_relaxed(0x01, spi_engine->base + SPI_ENGINE_REG_RESET);
591 static int spi_engine_probe(struct platform_device *pdev)
593 struct spi_engine *spi_engine;
594 struct spi_controller *host;
595 unsigned int version;
599 irq = platform_get_irq(pdev, 0);
603 host = devm_spi_alloc_host(&pdev->dev, sizeof(*spi_engine));
607 spi_engine = spi_controller_get_devdata(host);
609 spin_lock_init(&spi_engine->lock);
610 init_completion(&spi_engine->msg_complete);
612 spi_engine->clk = devm_clk_get_enabled(&pdev->dev, "s_axi_aclk");
613 if (IS_ERR(spi_engine->clk))
614 return PTR_ERR(spi_engine->clk);
616 spi_engine->ref_clk = devm_clk_get_enabled(&pdev->dev, "spi_clk");
617 if (IS_ERR(spi_engine->ref_clk))
618 return PTR_ERR(spi_engine->ref_clk);
620 spi_engine->base = devm_platform_ioremap_resource(pdev, 0);
621 if (IS_ERR(spi_engine->base))
622 return PTR_ERR(spi_engine->base);
624 version = readl(spi_engine->base + ADI_AXI_REG_VERSION);
625 if (ADI_AXI_PCORE_VER_MAJOR(version) != 1) {
626 dev_err(&pdev->dev, "Unsupported peripheral version %u.%u.%c\n",
627 ADI_AXI_PCORE_VER_MAJOR(version),
628 ADI_AXI_PCORE_VER_MINOR(version),
629 ADI_AXI_PCORE_VER_PATCH(version));
633 writel_relaxed(0x00, spi_engine->base + SPI_ENGINE_REG_RESET);
634 writel_relaxed(0xff, spi_engine->base + SPI_ENGINE_REG_INT_PENDING);
635 writel_relaxed(0x00, spi_engine->base + SPI_ENGINE_REG_INT_ENABLE);
637 ret = devm_add_action_or_reset(&pdev->dev, spi_engine_release_hw,
642 ret = devm_request_irq(&pdev->dev, irq, spi_engine_irq, 0, pdev->name,
647 host->dev.of_node = pdev->dev.of_node;
648 host->mode_bits = SPI_CPOL | SPI_CPHA | SPI_3WIRE;
649 host->bits_per_word_mask = SPI_BPW_RANGE_MASK(1, 32);
650 host->max_speed_hz = clk_get_rate(spi_engine->ref_clk) / 2;
651 host->transfer_one_message = spi_engine_transfer_one_message;
652 host->optimize_message = spi_engine_optimize_message;
653 host->unoptimize_message = spi_engine_unoptimize_message;
654 host->num_chipselect = 8;
656 if (host->max_speed_hz == 0)
657 return dev_err_probe(&pdev->dev, -EINVAL, "spi_clk rate is 0");
659 ret = devm_spi_register_controller(&pdev->dev, host);
663 platform_set_drvdata(pdev, host);
668 static const struct of_device_id spi_engine_match_table[] = {
669 { .compatible = "adi,axi-spi-engine-1.00.a" },
672 MODULE_DEVICE_TABLE(of, spi_engine_match_table);
674 static struct platform_driver spi_engine_driver = {
675 .probe = spi_engine_probe,
677 .name = "spi-engine",
678 .of_match_table = spi_engine_match_table,
681 module_platform_driver(spi_engine_driver);
683 MODULE_AUTHOR("Lars-Peter Clausen <lars@metafoo.de>");
684 MODULE_DESCRIPTION("Analog Devices SPI engine peripheral driver");
685 MODULE_LICENSE("GPL");