1 # SPDX-License-Identifier: GPL-2.0-only 1 # SPDX-License-Identifier: GPL-2.0-only
2 2
3 config NO_DMA 3 config NO_DMA
4 bool 4 bool
5 5
6 config HAS_DMA 6 config HAS_DMA
7 bool 7 bool
8 depends on !NO_DMA 8 depends on !NO_DMA
9 default y 9 default y
10 10
11 config DMA_OPS_HELPERS !! 11 config DMA_OPS
12 bool 12 bool
13 13
14 # 14 #
15 # IOMMU drivers that can bypass the IOMMU code 15 # IOMMU drivers that can bypass the IOMMU code and optionally use the direct
16 # mapping fast path should select this option 16 # mapping fast path should select this option and set the dma_ops_bypass
17 # flag in struct device where applicable 17 # flag in struct device where applicable
18 # 18 #
19 config DMA_OPS_BYPASS 19 config DMA_OPS_BYPASS
20 bool 20 bool
21 21
22 # Lets platform IOMMU driver choose between by <<
23 config ARCH_HAS_DMA_MAP_DIRECT <<
24 bool <<
25 <<
26 config NEED_SG_DMA_FLAGS <<
27 bool <<
28 <<
29 config NEED_SG_DMA_LENGTH 22 config NEED_SG_DMA_LENGTH
30 bool 23 bool
31 24
32 config NEED_DMA_MAP_STATE 25 config NEED_DMA_MAP_STATE
33 bool 26 bool
34 27
35 config ARCH_DMA_ADDR_T_64BIT 28 config ARCH_DMA_ADDR_T_64BIT
36 def_bool 64BIT || PHYS_ADDR_T_64BIT 29 def_bool 64BIT || PHYS_ADDR_T_64BIT
37 30
>> 31 config ARCH_HAS_DMA_COHERENCE_H
>> 32 bool
>> 33
38 config ARCH_HAS_DMA_SET_MASK 34 config ARCH_HAS_DMA_SET_MASK
39 bool 35 bool
40 36
41 # 37 #
42 # Select this option if the architecture needs 38 # Select this option if the architecture needs special handling for
43 # DMA_ATTR_WRITE_COMBINE. Normally the "uncac 39 # DMA_ATTR_WRITE_COMBINE. Normally the "uncached" mapping should be what
44 # people think of when saying write combine, s !! 40 # people thing of when saying write combine, so very few platforms should
45 # need to enable this. 41 # need to enable this.
46 # 42 #
47 config ARCH_HAS_DMA_WRITE_COMBINE 43 config ARCH_HAS_DMA_WRITE_COMBINE
48 bool 44 bool
49 45
50 # <<
51 # Select if the architectures provides the arc <<
52 # <<
53 config ARCH_HAS_DMA_MARK_CLEAN <<
54 bool <<
55 <<
56 config DMA_DECLARE_COHERENT 46 config DMA_DECLARE_COHERENT
57 bool 47 bool
58 48
59 config ARCH_HAS_SETUP_DMA_OPS 49 config ARCH_HAS_SETUP_DMA_OPS
60 bool 50 bool
61 51
62 config ARCH_HAS_TEARDOWN_DMA_OPS 52 config ARCH_HAS_TEARDOWN_DMA_OPS
63 bool 53 bool
64 54
65 config ARCH_HAS_SYNC_DMA_FOR_DEVICE 55 config ARCH_HAS_SYNC_DMA_FOR_DEVICE
66 bool 56 bool
67 57
68 config ARCH_HAS_SYNC_DMA_FOR_CPU 58 config ARCH_HAS_SYNC_DMA_FOR_CPU
69 bool 59 bool
70 select NEED_DMA_MAP_STATE 60 select NEED_DMA_MAP_STATE
71 61
72 config ARCH_HAS_SYNC_DMA_FOR_CPU_ALL 62 config ARCH_HAS_SYNC_DMA_FOR_CPU_ALL
73 bool 63 bool
74 64
75 config ARCH_HAS_DMA_PREP_COHERENT 65 config ARCH_HAS_DMA_PREP_COHERENT
76 bool 66 bool
77 67
78 config ARCH_HAS_FORCE_DMA_UNENCRYPTED 68 config ARCH_HAS_FORCE_DMA_UNENCRYPTED
79 bool 69 bool
80 70
81 # !! 71 config DMA_NONCOHERENT_CACHE_SYNC
82 # Select this option if the architecture assum <<
83 # by default. <<
84 # <<
85 config ARCH_DMA_DEFAULT_COHERENT <<
86 bool 72 bool
87 73
88 config SWIOTLB !! 74 config DMA_VIRT_OPS
89 bool 75 bool
90 select NEED_DMA_MAP_STATE !! 76 depends on HAS_DMA
91 !! 77 select DMA_OPS
92 config SWIOTLB_DYNAMIC <<
93 bool "Dynamic allocation of DMA bounce <<
94 default n <<
95 depends on SWIOTLB <<
96 help <<
97 This enables dynamic resizing of the <<
98 starts with one memory pool at boot <<
99 pools as needed. To reduce run-time <<
100 may have to specify a smaller size o <<
101 "swiotlb=" on the kernel command lin <<
102 <<
103 If unsure, say N. <<
104 78
105 config DMA_BOUNCE_UNALIGNED_KMALLOC !! 79 config SWIOTLB
106 bool 80 bool
107 depends on SWIOTLB !! 81 select NEED_DMA_MAP_STATE
108 <<
109 config DMA_NEED_SYNC <<
110 def_bool ARCH_HAS_SYNC_DMA_FOR_DEVICE <<
111 ARCH_HAS_SYNC_DMA_FOR_CPU_ALL <<
112 ARCH_HAS_DMA_OPS || SWIOTLB <<
113 <<
114 config DMA_RESTRICTED_POOL <<
115 bool "DMA Restricted Pool" <<
116 depends on OF && OF_RESERVED_MEM && SW <<
117 help <<
118 This enables support for restricted <<
119 DMA memory protection on systems wit <<
120 capabilities, such as those lacking <<
121 <<
122 For more information see <<
123 <Documentation/devicetree/bindings/r <<
124 and <kernel/dma/swiotlb.c>. <<
125 If unsure, say "n". <<
126 82
127 # 83 #
128 # Should be selected if we can mmap non-cohere 84 # Should be selected if we can mmap non-coherent mappings to userspace.
129 # The only thing that is really required is a 85 # The only thing that is really required is a way to set an uncached bit
130 # in the pagetables 86 # in the pagetables
131 # 87 #
132 config DMA_NONCOHERENT_MMAP 88 config DMA_NONCOHERENT_MMAP
133 default y if !MMU 89 default y if !MMU
134 bool 90 bool
135 91
136 config DMA_COHERENT_POOL 92 config DMA_COHERENT_POOL
137 select GENERIC_ALLOCATOR 93 select GENERIC_ALLOCATOR
138 bool 94 bool
139 95
140 config DMA_GLOBAL_POOL !! 96 config DMA_REMAP
141 select DMA_DECLARE_COHERENT <<
142 depends on !ARCH_HAS_DMA_SET_UNCACHED <<
143 depends on !DMA_DIRECT_REMAP <<
144 bool 97 bool
>> 98 depends on MMU
>> 99 select DMA_NONCOHERENT_MMAP
145 100
146 config DMA_DIRECT_REMAP 101 config DMA_DIRECT_REMAP
147 bool 102 bool
>> 103 select DMA_REMAP
148 select DMA_COHERENT_POOL 104 select DMA_COHERENT_POOL
149 select DMA_NONCOHERENT_MMAP <<
150 <<
151 # <<
152 # Fallback to arch code for DMA allocations. <<
153 # <<
154 config ARCH_HAS_DMA_ALLOC <<
155 depends on !ARCH_HAS_DMA_SET_UNCACHED <<
156 depends on !DMA_DIRECT_REMAP <<
157 depends on !DMA_GLOBAL_POOL <<
158 bool <<
159 105
160 config DMA_CMA 106 config DMA_CMA
161 bool "DMA Contiguous Memory Allocator" 107 bool "DMA Contiguous Memory Allocator"
162 depends on HAVE_DMA_CONTIGUOUS && CMA 108 depends on HAVE_DMA_CONTIGUOUS && CMA
163 help 109 help
164 This enables the Contiguous Memory A 110 This enables the Contiguous Memory Allocator which allows drivers
165 to allocate big physically-contiguou 111 to allocate big physically-contiguous blocks of memory for use with
166 hardware components that do not supp 112 hardware components that do not support I/O map nor scatter-gather.
167 113
168 You can disable CMA by specifying "c 114 You can disable CMA by specifying "cma=0" on the kernel's command
169 line. 115 line.
170 116
171 For more information see <kernel/dma !! 117 For more information see <include/linux/dma-contiguous.h>.
172 If unsure, say "n". 118 If unsure, say "n".
173 119
174 if DMA_CMA 120 if DMA_CMA
175 <<
176 config DMA_NUMA_CMA <<
177 bool "Enable separate DMA Contiguous M <<
178 depends on NUMA <<
179 help <<
180 Enable this option to get numa CMA a <<
181 can get local memory by DMA coherent <<
182 <<
183 You can set the size of pernuma CMA <<
184 or set the node id and its size of C <<
185 <node>:size[,<node>:size]" on the ke <<
186 <<
187 comment "Default contiguous memory area size:" 121 comment "Default contiguous memory area size:"
188 122
189 config CMA_SIZE_MBYTES 123 config CMA_SIZE_MBYTES
190 int "Size in Mega Bytes" 124 int "Size in Mega Bytes"
191 depends on !CMA_SIZE_SEL_PERCENTAGE 125 depends on !CMA_SIZE_SEL_PERCENTAGE
192 default 0 if X86 126 default 0 if X86
193 default 16 127 default 16
194 help 128 help
195 Defines the size (in MiB) of the def 129 Defines the size (in MiB) of the default memory area for Contiguous
196 Memory Allocator. If the size of 0 130 Memory Allocator. If the size of 0 is selected, CMA is disabled by
197 default, but it can be enabled by pa 131 default, but it can be enabled by passing cma=size[MG] to the kernel.
198 132
199 133
200 config CMA_SIZE_PERCENTAGE 134 config CMA_SIZE_PERCENTAGE
201 int "Percentage of total memory" 135 int "Percentage of total memory"
202 depends on !CMA_SIZE_SEL_MBYTES 136 depends on !CMA_SIZE_SEL_MBYTES
203 default 0 if X86 137 default 0 if X86
204 default 10 138 default 10
205 help 139 help
206 Defines the size of the default memo 140 Defines the size of the default memory area for Contiguous Memory
207 Allocator as a percentage of the tot 141 Allocator as a percentage of the total memory in the system.
208 If 0 percent is selected, CMA is dis 142 If 0 percent is selected, CMA is disabled by default, but it can be
209 enabled by passing cma=size[MG] to t 143 enabled by passing cma=size[MG] to the kernel.
210 144
211 choice 145 choice
212 prompt "Selected region size" 146 prompt "Selected region size"
213 default CMA_SIZE_SEL_MBYTES 147 default CMA_SIZE_SEL_MBYTES
214 148
215 config CMA_SIZE_SEL_MBYTES 149 config CMA_SIZE_SEL_MBYTES
216 bool "Use mega bytes value only" 150 bool "Use mega bytes value only"
217 151
218 config CMA_SIZE_SEL_PERCENTAGE 152 config CMA_SIZE_SEL_PERCENTAGE
219 bool "Use percentage value only" 153 bool "Use percentage value only"
220 154
221 config CMA_SIZE_SEL_MIN 155 config CMA_SIZE_SEL_MIN
222 bool "Use lower value (minimum)" 156 bool "Use lower value (minimum)"
223 157
224 config CMA_SIZE_SEL_MAX 158 config CMA_SIZE_SEL_MAX
225 bool "Use higher value (maximum)" 159 bool "Use higher value (maximum)"
226 160
227 endchoice 161 endchoice
228 162
229 config CMA_ALIGNMENT 163 config CMA_ALIGNMENT
230 int "Maximum PAGE_SIZE order of alignm 164 int "Maximum PAGE_SIZE order of alignment for contiguous buffers"
231 range 2 12 !! 165 range 4 12
232 default 8 166 default 8
233 help 167 help
234 DMA mapping framework by default ali 168 DMA mapping framework by default aligns all buffers to the smallest
235 PAGE_SIZE order which is greater tha 169 PAGE_SIZE order which is greater than or equal to the requested buffer
236 size. This works well for buffers up 170 size. This works well for buffers up to a few hundreds kilobytes, but
237 for larger buffers it just a memory 171 for larger buffers it just a memory waste. With this parameter you can
238 specify the maximum PAGE_SIZE order 172 specify the maximum PAGE_SIZE order for contiguous buffers. Larger
239 buffers will be aligned only to this 173 buffers will be aligned only to this specified order. The order is
240 expressed as a power of two multipli 174 expressed as a power of two multiplied by the PAGE_SIZE.
241 175
242 For example, if your system defaults 176 For example, if your system defaults to 4KiB pages, the order value
243 of 8 means that the buffers will be 177 of 8 means that the buffers will be aligned up to 1MiB only.
244 178
245 If unsure, leave the default value " 179 If unsure, leave the default value "8".
246 180
247 endif 181 endif
248 182
249 config DMA_API_DEBUG 183 config DMA_API_DEBUG
250 bool "Enable debugging of DMA-API usag 184 bool "Enable debugging of DMA-API usage"
251 select NEED_DMA_MAP_STATE 185 select NEED_DMA_MAP_STATE
252 help 186 help
253 Enable this option to debug the use 187 Enable this option to debug the use of the DMA API by device drivers.
254 With this option you will be able to 188 With this option you will be able to detect common bugs in device
255 drivers like double-freeing of DMA m 189 drivers like double-freeing of DMA mappings or freeing mappings that
256 were never allocated. 190 were never allocated.
257 191
258 This option causes a performance deg 192 This option causes a performance degradation. Use only if you want to
259 debug device drivers and dma interac 193 debug device drivers and dma interactions.
260 194
261 If unsure, say N. 195 If unsure, say N.
262 196
263 config DMA_API_DEBUG_SG 197 config DMA_API_DEBUG_SG
264 bool "Debug DMA scatter-gather usage" 198 bool "Debug DMA scatter-gather usage"
265 default y 199 default y
266 depends on DMA_API_DEBUG 200 depends on DMA_API_DEBUG
267 help 201 help
268 Perform extra checking that callers 202 Perform extra checking that callers of dma_map_sg() have respected the
269 appropriate segment length/boundary 203 appropriate segment length/boundary limits for the given device when
270 preparing DMA scatterlists. 204 preparing DMA scatterlists.
271 205
272 This is particularly likely to have 206 This is particularly likely to have been overlooked in cases where the
273 dma_map_sg() API is used for general 207 dma_map_sg() API is used for general bulk mapping of pages rather than
274 preparing literal scatter-gather des 208 preparing literal scatter-gather descriptors, where there is a risk of
275 unexpected behaviour from DMA API im 209 unexpected behaviour from DMA API implementations if the scatterlist
276 is technically out-of-spec. 210 is technically out-of-spec.
277 211
278 If unsure, say N. 212 If unsure, say N.
279 <<
280 config DMA_MAP_BENCHMARK <<
281 bool "Enable benchmarking of streaming <<
282 depends on DEBUG_FS <<
283 help <<
284 Provides /sys/kernel/debug/dma_map_b <<
285 performance of dma_(un)map_page. <<
286 <<
287 See tools/testing/selftests/dma/dma_ <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.