]>
git.proxmox.com Git - mirror_edk2.git/blob - MdePkg/Library/DxeIoLibCpuIo2/IoLibMmioBuffer.c
2 I/O Library MMIO Buffer Functions.
4 Copyright (c) 2010 - 2018, Intel Corporation. All rights reserved.<BR>
5 SPDX-License-Identifier: BSD-2-Clause-Patent
9 #include "DxeCpuIo2LibInternal.h"
12 Copy data from MMIO region to system memory by using 8-bit access.
14 Copy data from MMIO region specified by starting address StartAddress
15 to system memory specified by Buffer by using 8-bit access. The total
16 number of byte to be copied is specified by Length. Buffer is returned.
18 If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().
19 If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().
22 @param StartAddress The starting address for the MMIO region to be copied from.
23 @param Length The size in bytes of the copy.
24 @param Buffer The pointer to a system memory buffer receiving the data read.
32 IN UINTN StartAddress
,
39 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- StartAddress
));
40 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- (UINTN
)Buffer
));
42 ReturnBuffer
= Buffer
;
44 while (Length
-- > 0) {
45 *(Buffer
++) = MmioRead8 (StartAddress
++);
52 Copy data from MMIO region to system memory by using 16-bit access.
54 Copy data from MMIO region specified by starting address StartAddress
55 to system memory specified by Buffer by using 16-bit access. The total
56 number of byte to be copied is specified by Length. Buffer is returned.
58 If StartAddress is not aligned on a 16-bit boundary, then ASSERT().
60 If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().
61 If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().
63 If Length is not aligned on a 16-bit boundary, then ASSERT().
65 If Buffer is not aligned on a 16-bit boundary, then ASSERT().
67 @param StartAddress The starting address for the MMIO region to be copied from.
68 @param Length The size in bytes of the copy.
69 @param Buffer The pointer to a system memory buffer receiving the data read.
77 IN UINTN StartAddress
,
84 ASSERT ((StartAddress
& (sizeof (UINT16
) - 1)) == 0);
86 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- StartAddress
));
87 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- (UINTN
)Buffer
));
89 ASSERT ((Length
& (sizeof (UINT16
) - 1)) == 0);
90 ASSERT (((UINTN
)Buffer
& (sizeof (UINT16
) - 1)) == 0);
92 ReturnBuffer
= Buffer
;
95 *(Buffer
++) = MmioRead16 (StartAddress
);
96 StartAddress
+= sizeof (UINT16
);
97 Length
-= sizeof (UINT16
);
104 Copy data from MMIO region to system memory by using 32-bit access.
106 Copy data from MMIO region specified by starting address StartAddress
107 to system memory specified by Buffer by using 32-bit access. The total
108 number of byte to be copied is specified by Length. Buffer is returned.
110 If StartAddress is not aligned on a 32-bit boundary, then ASSERT().
112 If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().
113 If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().
115 If Length is not aligned on a 32-bit boundary, then ASSERT().
116 If Buffer is not aligned on a 32-bit boundary, then ASSERT().
118 @param StartAddress The starting address for the MMIO region to be copied from.
119 @param Length The size in bytes of the copy.
120 @param Buffer The pointer to a system memory buffer receiving the data read.
128 IN UINTN StartAddress
,
133 UINT32
*ReturnBuffer
;
135 ASSERT ((StartAddress
& (sizeof (UINT32
) - 1)) == 0);
137 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- StartAddress
));
138 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- (UINTN
)Buffer
));
140 ASSERT ((Length
& (sizeof (UINT32
) - 1)) == 0);
141 ASSERT (((UINTN
)Buffer
& (sizeof (UINT32
) - 1)) == 0);
143 ReturnBuffer
= Buffer
;
146 *(Buffer
++) = MmioRead32 (StartAddress
);
147 StartAddress
+= sizeof (UINT32
);
148 Length
-= sizeof (UINT32
);
155 Copy data from MMIO region to system memory by using 64-bit access.
157 Copy data from MMIO region specified by starting address StartAddress
158 to system memory specified by Buffer by using 64-bit access. The total
159 number of byte to be copied is specified by Length. Buffer is returned.
161 If StartAddress is not aligned on a 64-bit boundary, then ASSERT().
163 If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().
164 If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().
166 If Length is not aligned on a 64-bit boundary, then ASSERT().
168 If Buffer is not aligned on a 64-bit boundary, then ASSERT().
170 @param StartAddress The starting address for the MMIO region to be copied from.
171 @param Length The size in bytes of the copy.
172 @param Buffer The pointer to a system memory buffer receiving the data read.
180 IN UINTN StartAddress
,
185 UINT64
*ReturnBuffer
;
187 ASSERT ((StartAddress
& (sizeof (UINT64
) - 1)) == 0);
189 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- StartAddress
));
190 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- (UINTN
)Buffer
));
192 ASSERT ((Length
& (sizeof (UINT64
) - 1)) == 0);
193 ASSERT (((UINTN
)Buffer
& (sizeof (UINT64
) - 1)) == 0);
195 ReturnBuffer
= Buffer
;
198 *(Buffer
++) = MmioRead64 (StartAddress
);
199 StartAddress
+= sizeof (UINT64
);
200 Length
-= sizeof (UINT64
);
207 Copy data from system memory to MMIO region by using 8-bit access.
209 Copy data from system memory specified by Buffer to MMIO region specified
210 by starting address StartAddress by using 8-bit access. The total number
211 of byte to be copied is specified by Length. Buffer is returned.
213 If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().
214 If Length is greater than (MAX_ADDRESS -Buffer + 1), then ASSERT().
217 @param StartAddress The starting address for the MMIO region to be copied to.
218 @param Length The size in bytes of the copy.
219 @param Buffer The pointer to a system memory buffer containing the data to write.
227 IN UINTN StartAddress
,
229 IN CONST UINT8
*Buffer
234 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- StartAddress
));
235 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- (UINTN
)Buffer
));
237 ReturnBuffer
= (UINT8
*)Buffer
;
239 while (Length
-- > 0) {
240 MmioWrite8 (StartAddress
++, *(Buffer
++));
247 Copy data from system memory to MMIO region by using 16-bit access.
249 Copy data from system memory specified by Buffer to MMIO region specified
250 by starting address StartAddress by using 16-bit access. The total number
251 of byte to be copied is specified by Length. Buffer is returned.
253 If StartAddress is not aligned on a 16-bit boundary, then ASSERT().
255 If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().
256 If Length is greater than (MAX_ADDRESS -Buffer + 1), then ASSERT().
258 If Length is not aligned on a 16-bit boundary, then ASSERT().
260 If Buffer is not aligned on a 16-bit boundary, then ASSERT().
262 @param StartAddress The starting address for the MMIO region to be copied to.
263 @param Length The size in bytes of the copy.
264 @param Buffer The pointer to a system memory buffer containing the data to write.
272 IN UINTN StartAddress
,
274 IN CONST UINT16
*Buffer
277 UINT16
*ReturnBuffer
;
279 ASSERT ((StartAddress
& (sizeof (UINT16
) - 1)) == 0);
281 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- StartAddress
));
282 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- (UINTN
)Buffer
));
284 ASSERT ((Length
& (sizeof (UINT16
) - 1)) == 0);
285 ASSERT (((UINTN
)Buffer
& (sizeof (UINT16
) - 1)) == 0);
287 ReturnBuffer
= (UINT16
*)Buffer
;
290 MmioWrite16 (StartAddress
, *(Buffer
++));
292 StartAddress
+= sizeof (UINT16
);
293 Length
-= sizeof (UINT16
);
300 Copy data from system memory to MMIO region by using 32-bit access.
302 Copy data from system memory specified by Buffer to MMIO region specified
303 by starting address StartAddress by using 32-bit access. The total number
304 of byte to be copied is specified by Length. Buffer is returned.
306 If StartAddress is not aligned on a 32-bit boundary, then ASSERT().
308 If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().
309 If Length is greater than (MAX_ADDRESS -Buffer + 1), then ASSERT().
311 If Length is not aligned on a 32-bit boundary, then ASSERT().
313 If Buffer is not aligned on a 32-bit boundary, then ASSERT().
315 @param StartAddress The starting address for the MMIO region to be copied to.
316 @param Length The size in bytes of the copy.
317 @param Buffer The pointer to a system memory buffer containing the data to write.
325 IN UINTN StartAddress
,
327 IN CONST UINT32
*Buffer
330 UINT32
*ReturnBuffer
;
332 ASSERT ((StartAddress
& (sizeof (UINT32
) - 1)) == 0);
334 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- StartAddress
));
335 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- (UINTN
)Buffer
));
337 ASSERT ((Length
& (sizeof (UINT32
) - 1)) == 0);
338 ASSERT (((UINTN
)Buffer
& (sizeof (UINT32
) - 1)) == 0);
340 ReturnBuffer
= (UINT32
*)Buffer
;
343 MmioWrite32 (StartAddress
, *(Buffer
++));
345 StartAddress
+= sizeof (UINT32
);
346 Length
-= sizeof (UINT32
);
353 Copy data from system memory to MMIO region by using 64-bit access.
355 Copy data from system memory specified by Buffer to MMIO region specified
356 by starting address StartAddress by using 64-bit access. The total number
357 of byte to be copied is specified by Length. Buffer is returned.
359 If StartAddress is not aligned on a 64-bit boundary, then ASSERT().
361 If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().
362 If Length is greater than (MAX_ADDRESS -Buffer + 1), then ASSERT().
364 If Length is not aligned on a 64-bit boundary, then ASSERT().
366 If Buffer is not aligned on a 64-bit boundary, then ASSERT().
368 @param StartAddress The starting address for the MMIO region to be copied to.
369 @param Length The size in bytes of the copy.
370 @param Buffer The pointer to a system memory buffer containing the data to write.
378 IN UINTN StartAddress
,
380 IN CONST UINT64
*Buffer
383 UINT64
*ReturnBuffer
;
385 ASSERT ((StartAddress
& (sizeof (UINT64
) - 1)) == 0);
387 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- StartAddress
));
388 ASSERT ((Length
- 1) <= (MAX_ADDRESS
- (UINTN
)Buffer
));
390 ASSERT ((Length
& (sizeof (UINT64
) - 1)) == 0);
391 ASSERT (((UINTN
)Buffer
& (sizeof (UINT64
) - 1)) == 0);
393 ReturnBuffer
= (UINT64
*)Buffer
;
396 MmioWrite64 (StartAddress
, *(Buffer
++));
398 StartAddress
+= sizeof (UINT64
);
399 Length
-= sizeof (UINT64
);