1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 /* 3 * SiFive FU540 Platform DMA driver 4 * Copyright (C) 2019 SiFive 5 * 6 * Based partially on: 7 * - drivers/dma/fsl-edma.c 8 * - drivers/dma/dw-edma/ 9 * - drivers/dma/pxa-dma.c 10 * 11 * See the following sources for further documentation: 12 * - Chapter 12 "Platform DMA Engine (PDMA)" of 13 * SiFive FU540-C000 v1.0 14 * https://static.dev.sifive.com/FU540-C000-v1.0.pdf 15 */ 16 #ifndef _SF_PDMA_H 17 #define _SF_PDMA_H 18 19 #include <linux/dmaengine.h> 20 #include <linux/dma-direction.h> 21 22 #include "../dmaengine.h" 23 #include "../virt-dma.h" 24 25 #define PDMA_MAX_NR_CH 4 26 27 #define PDMA_BASE_ADDR 0x3000000 28 #define PDMA_CHAN_OFFSET 0x1000 29 30 /* Register Offset */ 31 #define PDMA_CTRL 0x000 32 #define PDMA_XFER_TYPE 0x004 33 #define PDMA_XFER_SIZE 0x008 34 #define PDMA_DST_ADDR 0x010 35 #define PDMA_SRC_ADDR 0x018 36 #define PDMA_ACT_TYPE 0x104 /* Read-only */ 37 #define PDMA_REMAINING_BYTE 0x108 /* Read-only */ 38 #define PDMA_CUR_DST_ADDR 0x110 /* Read-only*/ 39 #define PDMA_CUR_SRC_ADDR 0x118 /* Read-only*/ 40 41 /* CTRL */ 42 #define PDMA_CLEAR_CTRL 0x0 43 #define PDMA_CLAIM_MASK GENMASK(0, 0) 44 #define PDMA_RUN_MASK GENMASK(1, 1) 45 #define PDMA_ENABLE_DONE_INT_MASK GENMASK(14, 14) 46 #define PDMA_ENABLE_ERR_INT_MASK GENMASK(15, 15) 47 #define PDMA_DONE_STATUS_MASK GENMASK(30, 30) 48 #define PDMA_ERR_STATUS_MASK GENMASK(31, 31) 49 50 /* Transfer Type */ 51 #define PDMA_FULL_SPEED 0xFF000008 52 53 /* Error Recovery */ 54 #define MAX_RETRY 1 55 56 #define SF_PDMA_REG_BASE(ch) (pdma->membase + (PDMA_CHAN_OFFSET * (ch))) 57 58 struct pdma_regs { 59 /* read-write regs */ 60 void __iomem *ctrl; /* 4 bytes */ 61 62 void __iomem *xfer_type; /* 4 bytes */ 63 void __iomem *xfer_size; /* 8 bytes */ 64 void __iomem *dst_addr; /* 8 bytes */ 65 void __iomem *src_addr; /* 8 bytes */ 66 67 /* read-only */ 68 void __iomem *act_type; /* 4 bytes */ 69 void __iomem *residue; /* 8 bytes */ 70 void __iomem *cur_dst_addr; /* 8 bytes */ 71 void __iomem *cur_src_addr; /* 8 bytes */ 72 }; 73 74 struct sf_pdma_desc { 75 u32 xfer_type; 76 u64 xfer_size; 77 u64 dst_addr; 78 u64 src_addr; 79 struct virt_dma_desc vdesc; 80 struct sf_pdma_chan *chan; 81 enum dma_transfer_direction dirn; 82 struct dma_async_tx_descriptor *async_tx; 83 }; 84 85 enum sf_pdma_pm_state { 86 RUNNING = 0, 87 SUSPENDED, 88 }; 89 90 struct sf_pdma_chan { 91 struct virt_dma_chan vchan; 92 enum dma_status status; 93 enum sf_pdma_pm_state pm_state; 94 u32 slave_id; 95 struct sf_pdma *pdma; 96 struct sf_pdma_desc *desc; 97 struct dma_slave_config cfg; 98 u32 attr; 99 dma_addr_t dma_dev_addr; 100 u32 dma_dev_size; 101 struct tasklet_struct done_tasklet; 102 struct tasklet_struct err_tasklet; 103 struct pdma_regs regs; 104 spinlock_t lock; /* protect chan data */ 105 bool xfer_err; 106 int txirq; 107 int errirq; 108 int retries; 109 }; 110 111 struct sf_pdma { 112 struct dma_device dma_dev; 113 void __iomem *membase; 114 void __iomem *mappedbase; 115 u32 n_chans; 116 struct sf_pdma_chan chans[] __counted_by(n_chans); 117 }; 118 119 #endif /* _SF_PDMA_H */ 120