Linux/include/linux/dma/sprd-dma.h

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

1 /* SPDX-License-Identifier: GPL-2.0 */ 1 /* SPDX-License-Identifier: GPL-2.0 */ 2 2 3 #ifndef _SPRD_DMA_H_ 3 #ifndef _SPRD_DMA_H_ 4 #define _SPRD_DMA_H_ 4 #define _SPRD_DMA_H_ 5 5 6 #define SPRD_DMA_REQ_SHIFT 8 !! 6 #define SPRD_DMA_REQ_SHIFT 16 7 #define SPRD_DMA_TRG_MODE_SHIFT 16 !! 7 #define SPRD_DMA_FLAGS(req_mode, int_type) \ 8 #define SPRD_DMA_CHN_MODE_SHIFT 24 !! 8 ((req_mode) << SPRD_DMA_REQ_SHIFT | (int_type)) 9 #define SPRD_DMA_FLAGS(chn_mode, trg_mode, req << 10 ((chn_mode) << SPRD_DMA_CHN_MODE_SHIFT << 11 (trg_mode) << SPRD_DMA_TRG_MODE_SHIFT << 12 (req_mode) << SPRD_DMA_REQ_SHIFT | (in << 13 << 14 /* << 15 * The Spreadtrum DMA controller supports chan << 16 * we can request 2 dma channels, one for sour << 17 * destination channel. Each channel is indepe << 18 * configurations. Once the source channel's t << 19 * trigger the destination channel's transacti << 20 * signal. << 21 * << 22 * To support 2-stage tansfer, we must configu << 23 * mode as below definition. << 24 */ << 25 << 26 /* << 27 * enum sprd_dma_chn_mode: define the DMA chan << 28 * @SPRD_DMA_CHN_MODE_NONE: No channel mode se << 29 * support the 2-stage transfer. << 30 * @SPRD_DMA_SRC_CHN0: Channel used as source << 31 * @SPRD_DMA_SRC_CHN1: Channel used as source << 32 * @SPRD_DMA_DST_CHN0: Channel used as destina << 33 * @SPRD_DMA_DST_CHN1: Channel used as destina << 34 * << 35 * Now the DMA controller can supports 2 group << 36 */ << 37 enum sprd_dma_chn_mode { << 38 SPRD_DMA_CHN_MODE_NONE, << 39 SPRD_DMA_SRC_CHN0, << 40 SPRD_DMA_SRC_CHN1, << 41 SPRD_DMA_DST_CHN0, << 42 SPRD_DMA_DST_CHN1, << 43 }; << 44 << 45 /* << 46 * enum sprd_dma_trg_mode: define the DMA chan << 47 * transfer << 48 * @SPRD_DMA_NO_TRG: No trigger setting. << 49 * @SPRD_DMA_FRAG_DONE_TRG: Trigger the transa << 50 * automatically once the source channel's fra << 51 * @SPRD_DMA_BLOCK_DONE_TRG: Trigger the trans << 52 * automatically once the source channel's blo << 53 * @SPRD_DMA_TRANS_DONE_TRG: Trigger the trans << 54 * automatically once the source channel's tra << 55 * @SPRD_DMA_LIST_DONE_TRG: Trigger the transa << 56 * automatically once the source channel's lin << 57 */ << 58 enum sprd_dma_trg_mode { << 59 SPRD_DMA_NO_TRG, << 60 SPRD_DMA_FRAG_DONE_TRG, << 61 SPRD_DMA_BLOCK_DONE_TRG, << 62 SPRD_DMA_TRANS_DONE_TRG, << 63 SPRD_DMA_LIST_DONE_TRG, << 64 }; << 65 9 66 /* 10 /* 67 * enum sprd_dma_req_mode: define the DMA requ 11 * enum sprd_dma_req_mode: define the DMA request mode 68 * @SPRD_DMA_FRAG_REQ: fragment request mode 12 * @SPRD_DMA_FRAG_REQ: fragment request mode 69 * @SPRD_DMA_BLK_REQ: block request mode 13 * @SPRD_DMA_BLK_REQ: block request mode 70 * @SPRD_DMA_TRANS_REQ: transaction request mo 14 * @SPRD_DMA_TRANS_REQ: transaction request mode 71 * @SPRD_DMA_LIST_REQ: link-list request mode 15 * @SPRD_DMA_LIST_REQ: link-list request mode 72 * 16 * 73 * We have 4 types request mode: fragment mode 17 * We have 4 types request mode: fragment mode, block mode, transaction mode 74 * and linklist mode. One transaction can cont 18 * and linklist mode. One transaction can contain several blocks, one block can 75 * contain several fragments. Link-list mode m 19 * contain several fragments. Link-list mode means we can save several DMA 76 * configuration into one reserved memory, the 20 * configuration into one reserved memory, then DMA can fetch each DMA 77 * configuration automatically to start transf 21 * configuration automatically to start transfer. 78 */ 22 */ 79 enum sprd_dma_req_mode { 23 enum sprd_dma_req_mode { 80 SPRD_DMA_FRAG_REQ, 24 SPRD_DMA_FRAG_REQ, 81 SPRD_DMA_BLK_REQ, 25 SPRD_DMA_BLK_REQ, 82 SPRD_DMA_TRANS_REQ, 26 SPRD_DMA_TRANS_REQ, 83 SPRD_DMA_LIST_REQ, 27 SPRD_DMA_LIST_REQ, 84 }; 28 }; 85 29 86 /* 30 /* 87 * enum sprd_dma_int_type: define the DMA inte 31 * enum sprd_dma_int_type: define the DMA interrupt type 88 * @SPRD_DMA_NO_INT: do not need generate DMA 32 * @SPRD_DMA_NO_INT: do not need generate DMA interrupts. 89 * @SPRD_DMA_FRAG_INT: fragment done interrupt 33 * @SPRD_DMA_FRAG_INT: fragment done interrupt when one fragment request 90 * is done. 34 * is done. 91 * @SPRD_DMA_BLK_INT: block done interrupt whe 35 * @SPRD_DMA_BLK_INT: block done interrupt when one block request is done. 92 * @SPRD_DMA_BLK_FRAG_INT: block and fragment 36 * @SPRD_DMA_BLK_FRAG_INT: block and fragment interrupt when one fragment 93 * or one block request is done. 37 * or one block request is done. 94 * @SPRD_DMA_TRANS_INT: tansaction done interr 38 * @SPRD_DMA_TRANS_INT: tansaction done interrupt when one transaction 95 * request is done. 39 * request is done. 96 * @SPRD_DMA_TRANS_FRAG_INT: transaction and f 40 * @SPRD_DMA_TRANS_FRAG_INT: transaction and fragment interrupt when one 97 * transaction request or fragment request is 41 * transaction request or fragment request is done. 98 * @SPRD_DMA_TRANS_BLK_INT: transaction and bl 42 * @SPRD_DMA_TRANS_BLK_INT: transaction and block interrupt when one 99 * transaction request or block request is don 43 * transaction request or block request is done. 100 * @SPRD_DMA_LIST_INT: link-list done interrup 44 * @SPRD_DMA_LIST_INT: link-list done interrupt when one link-list request 101 * is done. 45 * is done. 102 * @SPRD_DMA_CFGERR_INT: configure error inter 46 * @SPRD_DMA_CFGERR_INT: configure error interrupt when configuration is 103 * incorrect. 47 * incorrect. 104 */ 48 */ 105 enum sprd_dma_int_type { 49 enum sprd_dma_int_type { 106 SPRD_DMA_NO_INT, 50 SPRD_DMA_NO_INT, 107 SPRD_DMA_FRAG_INT, 51 SPRD_DMA_FRAG_INT, 108 SPRD_DMA_BLK_INT, 52 SPRD_DMA_BLK_INT, 109 SPRD_DMA_BLK_FRAG_INT, 53 SPRD_DMA_BLK_FRAG_INT, 110 SPRD_DMA_TRANS_INT, 54 SPRD_DMA_TRANS_INT, 111 SPRD_DMA_TRANS_FRAG_INT, 55 SPRD_DMA_TRANS_FRAG_INT, 112 SPRD_DMA_TRANS_BLK_INT, 56 SPRD_DMA_TRANS_BLK_INT, 113 SPRD_DMA_LIST_INT, 57 SPRD_DMA_LIST_INT, 114 SPRD_DMA_CFGERR_INT, 58 SPRD_DMA_CFGERR_INT, 115 }; << 116 << 117 /* << 118 * struct sprd_dma_linklist - DMA link-list ad << 119 * @virt_addr: link-list virtual address to co << 120 * @phy_addr: link-list physical address to li << 121 * @wrap_addr: the wrap address for link-list << 122 * transfer address reaches the wrap address, << 123 * will jump to the address specified by wrap_ << 124 * << 125 * The Spreadtrum DMA controller supports the << 126 * can supply several groups configurations (e << 127 * DMA transfer) saved in memory, and DMA cont << 128 * configurations by writing the physical addr << 129 * link-list register. << 130 * << 131 * Just as shown below, the link-list pointer << 132 * physical address of 'configuration 1', and << 133 * pointer will be pointed to 'configuration 2 << 134 * Once trigger the DMA transfer, the DMA cont << 135 * 1' to its registers automatically, after 'c << 136 * done, DMA controller will load 'configurati << 137 * DMA transactions are done. << 138 * << 139 * Note: The last link-list pointer should poi << 140 * of 'configuration 1', which can avoid DMA c << 141 * configuration when the last configuration t << 142 * << 143 * DMA controller linkl << 144 * ====================== -------- << 145 *| | | conf << 146 *| DMA controller | ------->| << 147 *| | | | << 148 *| | | | << 149 *| | | | << 150 *| linklist pointer reg |---- ----| link << 151 * ====================== | -------- << 152 * | << 153 * | -------- << 154 * | | conf << 155 * --->| << 156 * | << 157 * | << 158 * | << 159 * ----| link << 160 * | -------- << 161 * | << 162 * | -------- << 163 * | | conf << 164 * --->| << 165 * | << 166 * | << 167 * << 168 * << 169 * << 170 * | << 171 * | -------- << 172 * | | conf << 173 * --->| << 174 * | << 175 * | << 176 * | << 177 * | link << 178 * -------- << 179 * << 180 * To support the link-list mode, DMA slaves s << 181 * from always-on IRAM or dma coherent memory << 182 * configuration, and pass the virtual and phy << 183 */ << 184 struct sprd_dma_linklist { << 185 unsigned long virt_addr; << 186 phys_addr_t phy_addr; << 187 phys_addr_t wrap_addr; << 188 }; 59 }; 189 60 190 #endif 61 #endif 191 62

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

TOMOYO Linux Cross Reference
Linux/include/linux/dma/sprd-dma.h

Diff markup

Differences between /include/linux/dma/sprd-dma.h (Version linux-6.12-rc7) and /include/linux/dma/sprd-dma.h (Version linux-4.18.20)

TOMOYO Linux Cross Reference Linux/include/linux/dma/sprd-dma.h

Diff markup

Differences between /include/linux/dma/sprd-dma.h (Version linux-6.12-rc7) and /include/linux/dma/sprd-dma.h (Version linux-4.18.20)

TOMOYO Linux Cross Reference
Linux/include/linux/dma/sprd-dma.h