]>
git.proxmox.com Git - mirror_edk2.git/blob - MdePkg/Library/BaseIoLibIntrinsic/IoLibNoIo.c
2 I/O library for non I/O read and write access (memory map I/O read and
3 write only) architecture, such as ARM and RISC-V processor.
5 Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
6 Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
7 Copyright (c) 2017, AMD Incorporated. All rights reserved.<BR>
8 Copyright (c) 2020, Hewlett Packard Enterprise Development LP. All rights reserved.<BR>
10 SPDX-License-Identifier: BSD-2-Clause-Patent
16 // Include common header file for this module.
18 #include "BaseIoLibIntrinsicInternal.h"
21 Reads an 8-bit I/O port.
23 Reads the 8-bit I/O port specified by Port. The 8-bit read value is returned.
24 This function must guarantee that all I/O read and write operations are
27 If 8-bit I/O port operations are not supported, then ASSERT().
29 @param Port The I/O port to read.
31 @return The value read.
45 Writes an 8-bit I/O port.
47 Writes the 8-bit I/O port specified by Port with the value specified by Value
48 and returns Value. This function must guarantee that all I/O read and write
49 operations are serialized.
51 If 8-bit I/O port operations are not supported, then ASSERT().
53 @param Port The I/O port to write.
54 @param Value The value to write to the I/O port.
56 @return The value written the I/O port.
71 Reads a 16-bit I/O port.
73 Reads the 16-bit I/O port specified by Port. The 16-bit read value is returned.
74 This function must guarantee that all I/O read and write operations are
77 If 16-bit I/O port operations are not supported, then ASSERT().
79 @param Port The I/O port to read.
81 @return The value read.
95 Writes a 16-bit I/O port.
97 Writes the 16-bit I/O port specified by Port with the value specified by Value
98 and returns Value. This function must guarantee that all I/O read and write
99 operations are serialized.
101 If 16-bit I/O port operations are not supported, then ASSERT().
103 @param Port The I/O port to write.
104 @param Value The value to write to the I/O port.
106 @return The value written the I/O port.
121 Reads a 32-bit I/O port.
123 Reads the 32-bit I/O port specified by Port. The 32-bit read value is returned.
124 This function must guarantee that all I/O read and write operations are
127 If 32-bit I/O port operations are not supported, then ASSERT().
129 @param Port The I/O port to read.
131 @return The value read.
145 Writes a 32-bit I/O port.
147 Writes the 32-bit I/O port specified by Port with the value specified by Value
148 and returns Value. This function must guarantee that all I/O read and write
149 operations are serialized.
151 If 32-bit I/O port operations are not supported, then ASSERT().
153 @param Port The I/O port to write.
154 @param Value The value to write to the I/O port.
156 @return The value written the I/O port.
171 Reads a 64-bit I/O port.
173 Reads the 64-bit I/O port specified by Port. The 64-bit read value is returned.
174 This function must guarantee that all I/O read and write operations are
177 If 64-bit I/O port operations are not supported, then ASSERT().
178 If Port is not aligned on a 64-bit boundary, then ASSERT().
180 @param Port The I/O port to read.
182 @return The value read.
196 Writes a 64-bit I/O port.
198 Writes the 64-bit I/O port specified by Port with the value specified by Value
199 and returns Value. This function must guarantee that all I/O read and write
200 operations are serialized.
202 If 64-bit I/O port operations are not supported, then ASSERT().
203 If Port is not aligned on a 64-bit boundary, then ASSERT().
205 @param Port The I/O port to write.
206 @param Value The value to write to the I/O port.
208 @return The value written to the I/O port.
223 Reads an 8-bit I/O port fifo into a block of memory.
225 Reads the 8-bit I/O fifo port specified by Port.
226 The port is read Count times, and the read data is
227 stored in the provided Buffer.
229 This function must guarantee that all I/O read and write operations are
232 If 8-bit I/O port operations are not supported, then ASSERT().
234 @param Port The I/O port to read.
235 @param Count The number of times to read I/O port.
236 @param Buffer The buffer to store the read data into.
251 Writes a block of memory into an 8-bit I/O port fifo.
253 Writes the 8-bit I/O fifo port specified by Port.
254 The port is written Count times, and the write data is
255 retrieved from the provided Buffer.
257 This function must guarantee that all I/O write and write operations are
260 If 8-bit I/O port operations are not supported, then ASSERT().
262 @param Port The I/O port to write.
263 @param Count The number of times to write I/O port.
264 @param Buffer The buffer to retrieve the write data from.
279 Reads a 16-bit I/O port fifo into a block of memory.
281 Reads the 16-bit I/O fifo port specified by Port.
282 The port is read Count times, and the read data is
283 stored in the provided Buffer.
285 This function must guarantee that all I/O read and write operations are
288 If 16-bit I/O port operations are not supported, then ASSERT().
290 @param Port The I/O port to read.
291 @param Count The number of times to read I/O port.
292 @param Buffer The buffer to store the read data into.
307 Writes a block of memory into a 16-bit I/O port fifo.
309 Writes the 16-bit I/O fifo port specified by Port.
310 The port is written Count times, and the write data is
311 retrieved from the provided Buffer.
313 This function must guarantee that all I/O write and write operations are
316 If 16-bit I/O port operations are not supported, then ASSERT().
318 @param Port The I/O port to write.
319 @param Count The number of times to write I/O port.
320 @param Buffer The buffer to retrieve the write data from.
335 Reads a 32-bit I/O port fifo into a block of memory.
337 Reads the 32-bit I/O fifo port specified by Port.
338 The port is read Count times, and the read data is
339 stored in the provided Buffer.
341 This function must guarantee that all I/O read and write operations are
344 If 32-bit I/O port operations are not supported, then ASSERT().
346 @param Port The I/O port to read.
347 @param Count The number of times to read I/O port.
348 @param Buffer The buffer to store the read data into.
363 Writes a block of memory into a 32-bit I/O port fifo.
365 Writes the 32-bit I/O fifo port specified by Port.
366 The port is written Count times, and the write data is
367 retrieved from the provided Buffer.
369 This function must guarantee that all I/O write and write operations are
372 If 32-bit I/O port operations are not supported, then ASSERT().
374 @param Port The I/O port to write.
375 @param Count The number of times to write I/O port.
376 @param Buffer The buffer to retrieve the write data from.
391 Reads an 8-bit MMIO register.
393 Reads the 8-bit MMIO register specified by Address. The 8-bit read value is
394 returned. This function must guarantee that all MMIO read and write
395 operations are serialized.
397 If 8-bit MMIO register operations are not supported, then ASSERT().
399 @param Address The MMIO register to read.
401 @return The value read.
412 Value
= *(volatile UINT8
*)Address
;
417 Writes an 8-bit MMIO register.
419 Writes the 8-bit MMIO register specified by Address with the value specified
420 by Value and returns Value. This function must guarantee that all MMIO read
421 and write operations are serialized.
423 If 8-bit MMIO register operations are not supported, then ASSERT().
425 @param Address The MMIO register to write.
426 @param Value The value to write to the MMIO register.
436 *(volatile UINT8
*)Address
= Value
;
441 Reads a 16-bit MMIO register.
443 Reads the 16-bit MMIO register specified by Address. The 16-bit read value is
444 returned. This function must guarantee that all MMIO read and write
445 operations are serialized.
447 If 16-bit MMIO register operations are not supported, then ASSERT().
449 @param Address The MMIO register to read.
451 @return The value read.
462 ASSERT ((Address
& 1) == 0);
463 Value
= *(volatile UINT16
*)Address
;
468 Writes a 16-bit MMIO register.
470 Writes the 16-bit MMIO register specified by Address with the value specified
471 by Value and returns Value. This function must guarantee that all MMIO read
472 and write operations are serialized.
474 If 16-bit MMIO register operations are not supported, then ASSERT().
476 @param Address The MMIO register to write.
477 @param Value The value to write to the MMIO register.
487 ASSERT ((Address
& 1) == 0);
488 *(volatile UINT16
*)Address
= Value
;
493 Reads a 32-bit MMIO register.
495 Reads the 32-bit MMIO register specified by Address. The 32-bit read value is
496 returned. This function must guarantee that all MMIO read and write
497 operations are serialized.
499 If 32-bit MMIO register operations are not supported, then ASSERT().
501 @param Address The MMIO register to read.
503 @return The value read.
514 ASSERT ((Address
& 3) == 0);
515 Value
= *(volatile UINT32
*)Address
;
520 Writes a 32-bit MMIO register.
522 Writes the 32-bit MMIO register specified by Address with the value specified
523 by Value and returns Value. This function must guarantee that all MMIO read
524 and write operations are serialized.
526 If 32-bit MMIO register operations are not supported, then ASSERT().
528 @param Address The MMIO register to write.
529 @param Value The value to write to the MMIO register.
539 ASSERT ((Address
& 3) == 0);
540 *(volatile UINT32
*)Address
= Value
;
545 Reads a 64-bit MMIO register.
547 Reads the 64-bit MMIO register specified by Address. The 64-bit read value is
548 returned. This function must guarantee that all MMIO read and write
549 operations are serialized.
551 If 64-bit MMIO register operations are not supported, then ASSERT().
553 @param Address The MMIO register to read.
555 @return The value read.
566 ASSERT ((Address
& 7) == 0);
567 Value
= *(volatile UINT64
*)Address
;
572 Writes a 64-bit MMIO register.
574 Writes the 64-bit MMIO register specified by Address with the value specified
575 by Value and returns Value. This function must guarantee that all MMIO read
576 and write operations are serialized.
578 If 64-bit MMIO register operations are not supported, then ASSERT().
580 @param Address The MMIO register to write.
581 @param Value The value to write to the MMIO register.
591 ASSERT ((Address
& 7) == 0);
592 *(volatile UINT64
*)Address
= Value
;