1 // SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause
3 // AMD SPI controller driver
5 // Copyright (c) 2020, Advanced Micro Devices, Inc.
9 #include <linux/acpi.h>
10 #include <linux/init.h>
11 #include <linux/module.h>
12 #include <linux/platform_device.h>
13 #include <linux/delay.h>
14 #include <linux/spi/spi.h>
15 #include <linux/iopoll.h>
16 #include <linux/spi/spi-mem.h>
18 #define AMD_SPI_CTRL0_REG 0x00
19 #define AMD_SPI_EXEC_CMD BIT(16)
20 #define AMD_SPI_FIFO_CLEAR BIT(20)
21 #define AMD_SPI_BUSY BIT(31)
23 #define AMD_SPI_OPCODE_REG 0x45
24 #define AMD_SPI_CMD_TRIGGER_REG 0x47
25 #define AMD_SPI_TRIGGER_CMD BIT(7)
27 #define AMD_SPI_OPCODE_MASK 0xFF
29 #define AMD_SPI_ALT_CS_REG 0x1D
30 #define AMD_SPI_ALT_CS_MASK 0x3
32 #define AMD_SPI_FIFO_BASE 0x80
33 #define AMD_SPI_TX_COUNT_REG 0x48
34 #define AMD_SPI_RX_COUNT_REG 0x4B
35 #define AMD_SPI_STATUS_REG 0x4C
37 #define AMD_SPI_FIFO_SIZE 70
38 #define AMD_SPI_MEM_SIZE 200
39 #define AMD_SPI_MAX_DATA 64
41 #define AMD_SPI_ENA_REG 0x20
42 #define AMD_SPI_ALT_SPD_SHIFT 20
43 #define AMD_SPI_ALT_SPD_MASK GENMASK(23, AMD_SPI_ALT_SPD_SHIFT)
44 #define AMD_SPI_SPI100_SHIFT 0
45 #define AMD_SPI_SPI100_MASK GENMASK(AMD_SPI_SPI100_SHIFT, AMD_SPI_SPI100_SHIFT)
46 #define AMD_SPI_SPEED_REG 0x6C
47 #define AMD_SPI_SPD7_SHIFT 8
48 #define AMD_SPI_SPD7_MASK GENMASK(13, AMD_SPI_SPD7_SHIFT)
50 #define AMD_SPI_MAX_HZ 100000000
51 #define AMD_SPI_MIN_HZ 800000
54 * enum amd_spi_versions - SPI controller versions
55 * @AMD_SPI_V1: AMDI0061 hardware version
56 * @AMD_SPI_V2: AMDI0062 hardware version
58 enum amd_spi_versions {
77 * struct amd_spi_freq - Matches device speed with values to write in regs
78 * @speed_hz: Device frequency
79 * @enable_val: Value to be written to "enable register"
80 * @spd7_val: Some frequencies requires to have a value written at SPISPEED register
89 * struct amd_spi - SPI driver instance
90 * @io_remap_addr: Start address of the SPI controller registers
91 * @version: SPI controller hardware version
92 * @speed_hz: Device frequency
95 void __iomem *io_remap_addr;
96 enum amd_spi_versions version;
97 unsigned int speed_hz;
100 static inline u8 amd_spi_readreg8(struct amd_spi *amd_spi, int idx)
102 return ioread8((u8 __iomem *)amd_spi->io_remap_addr + idx);
105 static inline void amd_spi_writereg8(struct amd_spi *amd_spi, int idx, u8 val)
107 iowrite8(val, ((u8 __iomem *)amd_spi->io_remap_addr + idx));
110 static void amd_spi_setclear_reg8(struct amd_spi *amd_spi, int idx, u8 set, u8 clear)
112 u8 tmp = amd_spi_readreg8(amd_spi, idx);
114 tmp = (tmp & ~clear) | set;
115 amd_spi_writereg8(amd_spi, idx, tmp);
118 static inline u32 amd_spi_readreg32(struct amd_spi *amd_spi, int idx)
120 return ioread32((u8 __iomem *)amd_spi->io_remap_addr + idx);
123 static inline void amd_spi_writereg32(struct amd_spi *amd_spi, int idx, u32 val)
125 iowrite32(val, ((u8 __iomem *)amd_spi->io_remap_addr + idx));
128 static inline void amd_spi_setclear_reg32(struct amd_spi *amd_spi, int idx, u32 set, u32 clear)
130 u32 tmp = amd_spi_readreg32(amd_spi, idx);
132 tmp = (tmp & ~clear) | set;
133 amd_spi_writereg32(amd_spi, idx, tmp);
136 static void amd_spi_select_chip(struct amd_spi *amd_spi, u8 cs)
138 amd_spi_setclear_reg8(amd_spi, AMD_SPI_ALT_CS_REG, cs, AMD_SPI_ALT_CS_MASK);
141 static inline void amd_spi_clear_chip(struct amd_spi *amd_spi, u8 chip_select)
143 amd_spi_writereg8(amd_spi, AMD_SPI_ALT_CS_REG, chip_select & ~AMD_SPI_ALT_CS_MASK);
146 static void amd_spi_clear_fifo_ptr(struct amd_spi *amd_spi)
148 amd_spi_setclear_reg32(amd_spi, AMD_SPI_CTRL0_REG, AMD_SPI_FIFO_CLEAR, AMD_SPI_FIFO_CLEAR);
151 static int amd_spi_set_opcode(struct amd_spi *amd_spi, u8 cmd_opcode)
153 switch (amd_spi->version) {
155 amd_spi_setclear_reg32(amd_spi, AMD_SPI_CTRL0_REG, cmd_opcode,
156 AMD_SPI_OPCODE_MASK);
159 amd_spi_writereg8(amd_spi, AMD_SPI_OPCODE_REG, cmd_opcode);
166 static inline void amd_spi_set_rx_count(struct amd_spi *amd_spi, u8 rx_count)
168 amd_spi_setclear_reg8(amd_spi, AMD_SPI_RX_COUNT_REG, rx_count, 0xff);
171 static inline void amd_spi_set_tx_count(struct amd_spi *amd_spi, u8 tx_count)
173 amd_spi_setclear_reg8(amd_spi, AMD_SPI_TX_COUNT_REG, tx_count, 0xff);
176 static int amd_spi_busy_wait(struct amd_spi *amd_spi)
181 switch (amd_spi->version) {
183 reg = AMD_SPI_CTRL0_REG;
186 reg = AMD_SPI_STATUS_REG;
192 return readl_poll_timeout(amd_spi->io_remap_addr + reg, val,
193 !(val & AMD_SPI_BUSY), 20, 2000000);
196 static int amd_spi_execute_opcode(struct amd_spi *amd_spi)
200 ret = amd_spi_busy_wait(amd_spi);
204 switch (amd_spi->version) {
206 /* Set ExecuteOpCode bit in the CTRL0 register */
207 amd_spi_setclear_reg32(amd_spi, AMD_SPI_CTRL0_REG, AMD_SPI_EXEC_CMD,
211 /* Trigger the command execution */
212 amd_spi_setclear_reg8(amd_spi, AMD_SPI_CMD_TRIGGER_REG,
213 AMD_SPI_TRIGGER_CMD, AMD_SPI_TRIGGER_CMD);
220 static int amd_spi_host_setup(struct spi_device *spi)
222 struct amd_spi *amd_spi = spi_controller_get_devdata(spi->controller);
224 amd_spi_clear_fifo_ptr(amd_spi);
229 static const struct amd_spi_freq amd_spi_freq[] = {
230 { AMD_SPI_MAX_HZ, F_100MHz, 0},
231 { 66660000, F_66_66MHz, 0},
232 { 50000000, SPI_SPD7, F_50MHz},
233 { 33330000, F_33_33MHz, 0},
234 { 22220000, F_22_22MHz, 0},
235 { 16660000, F_16_66MHz, 0},
236 { 4000000, SPI_SPD7, F_4MHz},
237 { 3170000, SPI_SPD7, F_3_17MHz},
238 { AMD_SPI_MIN_HZ, F_800KHz, 0},
241 static int amd_set_spi_freq(struct amd_spi *amd_spi, u32 speed_hz)
243 unsigned int i, spd7_val, alt_spd;
245 if (speed_hz < AMD_SPI_MIN_HZ)
248 for (i = 0; i < ARRAY_SIZE(amd_spi_freq); i++)
249 if (speed_hz >= amd_spi_freq[i].speed_hz)
252 if (amd_spi->speed_hz == amd_spi_freq[i].speed_hz)
255 amd_spi->speed_hz = amd_spi_freq[i].speed_hz;
257 alt_spd = (amd_spi_freq[i].enable_val << AMD_SPI_ALT_SPD_SHIFT)
258 & AMD_SPI_ALT_SPD_MASK;
259 amd_spi_setclear_reg32(amd_spi, AMD_SPI_ENA_REG, alt_spd,
260 AMD_SPI_ALT_SPD_MASK);
262 if (amd_spi->speed_hz == AMD_SPI_MAX_HZ)
263 amd_spi_setclear_reg32(amd_spi, AMD_SPI_ENA_REG, 1,
264 AMD_SPI_SPI100_MASK);
266 if (amd_spi_freq[i].spd7_val) {
267 spd7_val = (amd_spi_freq[i].spd7_val << AMD_SPI_SPD7_SHIFT)
269 amd_spi_setclear_reg32(amd_spi, AMD_SPI_SPEED_REG, spd7_val,
276 static inline int amd_spi_fifo_xfer(struct amd_spi *amd_spi,
277 struct spi_controller *host,
278 struct spi_message *message)
280 struct spi_transfer *xfer = NULL;
281 struct spi_device *spi = message->spi;
282 u8 cmd_opcode = 0, fifo_pos = AMD_SPI_FIFO_BASE;
285 u32 tx_len = 0, rx_len = 0;
287 list_for_each_entry(xfer, &message->transfers,
290 amd_set_spi_freq(amd_spi, xfer->speed_hz);
292 amd_set_spi_freq(amd_spi, spi->max_speed_hz);
295 buf = (u8 *)xfer->tx_buf;
297 cmd_opcode = *(u8 *)xfer->tx_buf;
303 /* Write data into the FIFO. */
304 for (i = 0; i < xfer->len; i++)
305 amd_spi_writereg8(amd_spi, fifo_pos + i, buf[i]);
307 fifo_pos += xfer->len;
310 /* Store no. of bytes to be received from FIFO */
316 message->status = -EINVAL;
320 amd_spi_set_opcode(amd_spi, cmd_opcode);
321 amd_spi_set_tx_count(amd_spi, tx_len);
322 amd_spi_set_rx_count(amd_spi, rx_len);
324 /* Execute command */
325 message->status = amd_spi_execute_opcode(amd_spi);
330 message->status = amd_spi_busy_wait(amd_spi);
334 list_for_each_entry(xfer, &message->transfers, transfer_list)
336 buf = (u8 *)xfer->rx_buf;
337 /* Read data from FIFO to receive buffer */
338 for (i = 0; i < xfer->len; i++)
339 buf[i] = amd_spi_readreg8(amd_spi, fifo_pos + i);
340 fifo_pos += xfer->len;
344 /* Update statistics */
345 message->actual_length = tx_len + rx_len + 1;
348 switch (amd_spi->version) {
352 amd_spi_clear_chip(amd_spi, spi_get_chipselect(message->spi, 0));
358 spi_finalize_current_message(host);
360 return message->status;
363 static bool amd_spi_supports_op(struct spi_mem *mem,
364 const struct spi_mem_op *op)
366 /* bus width is number of IO lines used to transmit */
367 if (op->cmd.buswidth > 1 || op->addr.buswidth > 1 ||
368 op->data.buswidth > 1 || op->data.nbytes > AMD_SPI_MAX_DATA)
371 return spi_mem_default_supports_op(mem, op);
374 static int amd_spi_adjust_op_size(struct spi_mem *mem, struct spi_mem_op *op)
376 op->data.nbytes = clamp_val(op->data.nbytes, 0, AMD_SPI_MAX_DATA);
380 static void amd_spi_set_addr(struct amd_spi *amd_spi,
381 const struct spi_mem_op *op)
383 u8 nbytes = op->addr.nbytes;
384 u64 addr_val = op->addr.val;
387 base_addr = AMD_SPI_FIFO_BASE + nbytes;
389 for (i = 0; i < nbytes; i++) {
390 amd_spi_writereg8(amd_spi, base_addr - i - 1, addr_val &
396 static void amd_spi_mem_data_out(struct amd_spi *amd_spi,
397 const struct spi_mem_op *op)
399 int base_addr = AMD_SPI_FIFO_BASE + op->addr.nbytes;
400 u8 *buf = (u8 *)op->data.buf.out;
401 u32 nbytes = op->data.nbytes;
404 amd_spi_set_opcode(amd_spi, op->cmd.opcode);
405 amd_spi_set_addr(amd_spi, op);
407 for (i = 0; i < nbytes; i++)
408 amd_spi_writereg8(amd_spi, (base_addr + i), buf[i]);
410 amd_spi_set_tx_count(amd_spi, op->addr.nbytes + op->data.nbytes);
411 amd_spi_set_rx_count(amd_spi, 0);
412 amd_spi_clear_fifo_ptr(amd_spi);
413 amd_spi_execute_opcode(amd_spi);
416 static void amd_spi_mem_data_in(struct amd_spi *amd_spi,
417 const struct spi_mem_op *op)
419 int offset = (op->addr.nbytes == 0) ? 0 : 1;
420 u8 *buf = (u8 *)op->data.buf.in;
421 u32 nbytes = op->data.nbytes;
424 base_addr = AMD_SPI_FIFO_BASE + op->addr.nbytes + offset;
426 amd_spi_set_opcode(amd_spi, op->cmd.opcode);
427 amd_spi_set_addr(amd_spi, op);
428 amd_spi_set_tx_count(amd_spi, op->addr.nbytes);
429 amd_spi_set_rx_count(amd_spi, op->data.nbytes + 1);
430 amd_spi_clear_fifo_ptr(amd_spi);
431 amd_spi_execute_opcode(amd_spi);
432 amd_spi_busy_wait(amd_spi);
434 for (i = 0; i < nbytes; i++)
435 buf[i] = amd_spi_readreg8(amd_spi, base_addr + i);
438 static int amd_spi_exec_mem_op(struct spi_mem *mem,
439 const struct spi_mem_op *op)
441 struct amd_spi *amd_spi;
444 amd_spi = spi_controller_get_devdata(mem->spi->controller);
446 ret = amd_set_spi_freq(amd_spi, mem->spi->max_speed_hz);
450 switch (op->data.dir) {
451 case SPI_MEM_DATA_IN:
452 amd_spi_mem_data_in(amd_spi, op);
454 case SPI_MEM_DATA_OUT:
456 case SPI_MEM_NO_DATA:
457 amd_spi_mem_data_out(amd_spi, op);
466 static const struct spi_controller_mem_ops amd_spi_mem_ops = {
467 .exec_op = amd_spi_exec_mem_op,
468 .adjust_op_size = amd_spi_adjust_op_size,
469 .supports_op = amd_spi_supports_op,
472 static int amd_spi_host_transfer(struct spi_controller *host,
473 struct spi_message *msg)
475 struct amd_spi *amd_spi = spi_controller_get_devdata(host);
476 struct spi_device *spi = msg->spi;
478 amd_spi_select_chip(amd_spi, spi_get_chipselect(spi, 0));
481 * Extract spi_transfers from the spi message and
482 * program the controller.
484 return amd_spi_fifo_xfer(amd_spi, host, msg);
487 static size_t amd_spi_max_transfer_size(struct spi_device *spi)
489 return AMD_SPI_FIFO_SIZE;
492 static int amd_spi_probe(struct platform_device *pdev)
494 struct device *dev = &pdev->dev;
495 struct spi_controller *host;
496 struct amd_spi *amd_spi;
499 /* Allocate storage for host and driver private data */
500 host = devm_spi_alloc_host(dev, sizeof(struct amd_spi));
502 return dev_err_probe(dev, -ENOMEM, "Error allocating SPI host\n");
504 amd_spi = spi_controller_get_devdata(host);
505 amd_spi->io_remap_addr = devm_platform_ioremap_resource(pdev, 0);
506 if (IS_ERR(amd_spi->io_remap_addr))
507 return dev_err_probe(dev, PTR_ERR(amd_spi->io_remap_addr),
508 "ioremap of SPI registers failed\n");
510 dev_dbg(dev, "io_remap_address: %p\n", amd_spi->io_remap_addr);
512 amd_spi->version = (uintptr_t) device_get_match_data(dev);
514 /* Initialize the spi_controller fields */
516 host->num_chipselect = 4;
518 host->flags = SPI_CONTROLLER_HALF_DUPLEX;
519 host->max_speed_hz = AMD_SPI_MAX_HZ;
520 host->min_speed_hz = AMD_SPI_MIN_HZ;
521 host->setup = amd_spi_host_setup;
522 host->transfer_one_message = amd_spi_host_transfer;
523 host->mem_ops = &amd_spi_mem_ops;
524 host->max_transfer_size = amd_spi_max_transfer_size;
525 host->max_message_size = amd_spi_max_transfer_size;
527 /* Register the controller with SPI framework */
528 err = devm_spi_register_controller(dev, host);
530 return dev_err_probe(dev, err, "error registering SPI controller\n");
536 static const struct acpi_device_id spi_acpi_match[] = {
537 { "AMDI0061", AMD_SPI_V1 },
538 { "AMDI0062", AMD_SPI_V2 },
541 MODULE_DEVICE_TABLE(acpi, spi_acpi_match);
544 static struct platform_driver amd_spi_driver = {
547 .acpi_match_table = ACPI_PTR(spi_acpi_match),
549 .probe = amd_spi_probe,
552 module_platform_driver(amd_spi_driver);
554 MODULE_LICENSE("Dual BSD/GPL");
556 MODULE_DESCRIPTION("AMD SPI Master Controller Driver");