| /** @file |
| The PCI configuration Library Services that carry out PCI configuration and enable |
| the PCI operations to be replayed during an S3 resume. This library class |
| maps directly on top of the PciLib class. |
| |
| Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.<BR> |
| |
| This program and the accompanying materials |
| are licensed and made available under the terms and conditions |
| of the BSD License which accompanies this distribution. The |
| full text of the license may be found at |
| http://opensource.org/licenses/bsd-license.php |
| |
| THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, |
| WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. |
| |
| **/ |
| |
| #ifndef __S3_PCI_LIB_H__ |
| #define __S3_PCI_LIB_H__ |
| |
| /** |
| Macro that converts PCI Bus, PCI Device, PCI Function and PCI Register to an |
| address that can be passed to the S3 PCI Library functions. |
| |
| @param Bus The PCI Bus number. Range 0..255. |
| @param Device The PCI Device number. Range 0..31. |
| @param Function The PCI Function number. Range 0..7. |
| @param Register The PCI Register number. Range 0..255 for PCI. Range 0..4095 |
| for PCI Express. |
| |
| @return The encoded PCI address. |
| |
| **/ |
| #define S3_PCI_LIB_ADDRESS(Bus,Device,Function,Register) \ |
| (((Register) & 0xfff) | (((Function) & 0x07) << 12) | (((Device) & 0x1f) << 15) | (((Bus) & 0xff) << 20)) |
| |
| /** |
| |
| Reads and returns the 8-bit PCI configuration register specified by Address, |
| and saves the value in the S3 script to be replayed on S3 resume. |
| This function must guarantee that all PCI read and write operations are |
| serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| |
| @return The value read from the PCI configuration register. |
| |
| **/ |
| UINT8 |
| EFIAPI |
| S3PciRead8 ( |
| IN UINTN Address |
| ); |
| |
| /** |
| Writes an 8-bit PCI configuration register, and saves the value in the S3 |
| script to be replayed on S3 resume. |
| |
| Writes the 8-bit PCI configuration register specified by Address with the |
| value specified by Value. Value is returned. This function must guarantee |
| that all PCI read and write operations are serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| @param[in] Value The value to write. |
| |
| @return The value written to the PCI configuration register. |
| |
| **/ |
| UINT8 |
| EFIAPI |
| S3PciWrite8 ( |
| IN UINTN Address, |
| IN UINT8 Value |
| ); |
| |
| /** |
| Performs a bitwise OR of an 8-bit PCI configuration register with |
| an 8-bit value, and saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 8-bit PCI configuration register specified by Address, performs a |
| bitwise OR between the read result and the value specified by |
| OrData, and writes the result to the 8-bit PCI configuration register |
| specified by Address. The value written to the PCI configuration register is |
| returned. This function must guarantee that all PCI read and write operations |
| are serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| @param[in] OrData The value to OR with the PCI configuration register. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT8 |
| EFIAPI |
| S3PciOr8 ( |
| IN UINTN Address, |
| IN UINT8 OrData |
| ); |
| |
| /** |
| Performs a bitwise AND of an 8-bit PCI configuration register with an 8-bit |
| value, and saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 8-bit PCI configuration register specified by Address, performs a |
| bitwise AND between the read result and the value specified by AndData, and |
| writes the result to the 8-bit PCI configuration register specified by |
| Address. The value written to the PCI configuration register is returned. |
| This function must guarantee that all PCI read and write operations are |
| serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| @param[in] AndData The value to AND with the PCI configuration register. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT8 |
| EFIAPI |
| S3PciAnd8 ( |
| IN UINTN Address, |
| IN UINT8 AndData |
| ); |
| |
| /** |
| Performs a bitwise AND of an 8-bit PCI configuration register with an 8-bit |
| value, followed a bitwise OR with another 8-bit value, and saves |
| the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 8-bit PCI configuration register specified by Address, performs a |
| bitwise AND between the read result and the value specified by AndData, |
| performs a bitwise OR between the result of the AND operation and |
| the value specified by OrData, and writes the result to the 8-bit PCI |
| configuration register specified by Address. The value written to the PCI |
| configuration register is returned. This function must guarantee that all PCI |
| read and write operations are serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| @param[in] AndData The value to AND with the PCI configuration register. |
| @param[in] OrData The value to OR with the result of the AND operation. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT8 |
| EFIAPI |
| S3PciAndThenOr8 ( |
| IN UINTN Address, |
| IN UINT8 AndData, |
| IN UINT8 OrData |
| ); |
| |
| /** |
| Reads a bit field of a PCI configuration register, and saves the value in |
| the S3 script to be replayed on S3 resume. |
| |
| Reads the bit field in an 8-bit PCI configuration register. The bit field is |
| specified by the StartBit and the EndBit. The value of the bit field is |
| returned. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If StartBit is greater than 7, then ASSERT(). |
| If EndBit is greater than 7, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to read. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..7. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..7. |
| |
| @return The value of the bit field read from the PCI configuration register. |
| |
| **/ |
| UINT8 |
| EFIAPI |
| S3PciBitFieldRead8 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit |
| ); |
| |
| /** |
| Writes a bit field to a PCI configuration register, and saves the value in |
| the S3 script to be replayed on S3 resume. |
| |
| Writes Value to the bit field of the PCI configuration register. The bit |
| field is specified by the StartBit and the EndBit. All other bits in the |
| destination PCI configuration register are preserved. The new value of the |
| 8-bit register is returned. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If StartBit is greater than 7, then ASSERT(). |
| If EndBit is greater than 7, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to write. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..7. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..7. |
| @param[in] Value New value of the bit field. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT8 |
| EFIAPI |
| S3PciBitFieldWrite8 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit, |
| IN UINT8 Value |
| ); |
| |
| /** |
| Reads a bit field in an 8-bit PCI configuration, performs a bitwise OR, and |
| writes the result back to the bit field in the 8-bit port, and saves the value |
| in the S3 script to be replayed on S3 resume. |
| |
| Reads the 8-bit PCI configuration register specified by Address, performs a |
| bitwise OR between the read result and the value specified by |
| OrData, and writes the result to the 8-bit PCI configuration register |
| specified by Address. The value written to the PCI configuration register is |
| returned. This function must guarantee that all PCI read and write operations |
| are serialized. Extra left bits in OrData are stripped. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If StartBit is greater than 7, then ASSERT(). |
| If EndBit is greater than 7, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to write. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..7. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..7. |
| @param[in] OrData The value to OR with the PCI configuration register. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT8 |
| EFIAPI |
| S3PciBitFieldOr8 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit, |
| IN UINT8 OrData |
| ); |
| |
| /** |
| Reads a bit field in an 8-bit PCI configuration register, performs a bitwise |
| AND, and writes the result back to the bit field in the 8-bit register and |
| saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 8-bit PCI configuration register specified by Address, performs a |
| bitwise AND between the read result and the value specified by AndData, and |
| writes the result to the 8-bit PCI configuration register specified by |
| Address. The value written to the PCI configuration register is returned. |
| This function must guarantee that all PCI read and write operations are |
| serialized. Extra left bits in AndData are stripped. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If StartBit is greater than 7, then ASSERT(). |
| If EndBit is greater than 7, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to write. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..7. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..7. |
| @param[in] AndData The value to AND with the PCI configuration register. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT8 |
| EFIAPI |
| S3PciBitFieldAnd8 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit, |
| IN UINT8 AndData |
| ); |
| |
| /** |
| Reads a bit field in an 8-bit Address, performs a bitwise AND followed by a |
| bitwise OR, and writes the result back to the bit field in the |
| 8-bit port, and saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 8-bit PCI configuration register specified by Address, performs a |
| bitwise AND followed by a bitwise OR between the read result and |
| the value specified by AndData, and writes the result to the 8-bit PCI |
| configuration register specified by Address. The value written to the PCI |
| configuration register is returned. This function must guarantee that all PCI |
| read and write operations are serialized. Extra left bits in both AndData and |
| OrData are stripped. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If StartBit is greater than 7, then ASSERT(). |
| If EndBit is greater than 7, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to write. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..7. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..7. |
| @param[in] AndData The value to AND with the PCI configuration register. |
| @param[in] OrData The value to OR with the result of the AND operation. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT8 |
| EFIAPI |
| S3PciBitFieldAndThenOr8 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit, |
| IN UINT8 AndData, |
| IN UINT8 OrData |
| ); |
| |
| /** |
| Reads a 16-bit PCI configuration register, and saves the value in the S3 |
| script to be replayed on S3 resume. |
| |
| Reads and returns the 16-bit PCI configuration register specified by Address. |
| This function must guarantee that all PCI read and write operations are |
| serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 16-bit boundary, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| |
| @return The read value from the PCI configuration register. |
| |
| **/ |
| UINT16 |
| EFIAPI |
| S3PciRead16 ( |
| IN UINTN Address |
| ); |
| |
| /** |
| Writes a 16-bit PCI configuration register, and saves the value in the S3 |
| script to be replayed on S3 resume. |
| |
| Writes the 16-bit PCI configuration register specified by Address with the |
| value specified by Value. Value is returned. This function must guarantee |
| that all PCI read and write operations are serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 16-bit boundary, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| @param[in] Value The value to write. |
| |
| @return The value written to the PCI configuration register. |
| |
| **/ |
| UINT16 |
| EFIAPI |
| S3PciWrite16 ( |
| IN UINTN Address, |
| IN UINT16 Value |
| ); |
| |
| /** |
| Performs a bitwise OR of a 16-bit PCI configuration register with |
| a 16-bit value, and saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 16-bit PCI configuration register specified by Address, performs a |
| bitwise OR between the read result and the value specified by |
| OrData, and writes the result to the 16-bit PCI configuration register |
| specified by Address. The value written to the PCI configuration register is |
| returned. This function must guarantee that all PCI read and write operations |
| are serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 16-bit boundary, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| @param[in] OrData The value to OR with the PCI configuration register. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT16 |
| EFIAPI |
| S3PciOr16 ( |
| IN UINTN Address, |
| IN UINT16 OrData |
| ); |
| |
| /** |
| Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit |
| value, and saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 16-bit PCI configuration register specified by Address, performs a |
| bitwise AND between the read result and the value specified by AndData, and |
| writes the result to the 16-bit PCI configuration register specified by |
| Address. The value written to the PCI configuration register is returned. |
| This function must guarantee that all PCI read and write operations are |
| serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 16-bit boundary, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| @param[in] AndData The value to AND with the PCI configuration register. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT16 |
| EFIAPI |
| S3PciAnd16 ( |
| IN UINTN Address, |
| IN UINT16 AndData |
| ); |
| |
| /** |
| Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit |
| value, followed a bitwise OR with another 16-bit value, and saves |
| the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 16-bit PCI configuration register specified by Address, performs a |
| bitwise AND between the read result and the value specified by AndData, |
| performs a bitwise OR between the result of the AND operation and |
| the value specified by OrData, and writes the result to the 16-bit PCI |
| configuration register specified by Address. The value written to the PCI |
| configuration register is returned. This function must guarantee that all PCI |
| read and write operations are serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 16-bit boundary, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| @param[in] AndData The value to AND with the PCI configuration register. |
| @param[in] OrData The value to OR with the result of the AND operation. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT16 |
| EFIAPI |
| S3PciAndThenOr16 ( |
| IN UINTN Address, |
| IN UINT16 AndData, |
| IN UINT16 OrData |
| ); |
| |
| /** |
| Reads a bit field of a PCI configuration register, and saves the value in |
| the S3 script to be replayed on S3 resume. |
| |
| Reads the bit field in a 16-bit PCI configuration register. The bit field is |
| specified by the StartBit and the EndBit. The value of the bit field is |
| returned. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 16-bit boundary, then ASSERT(). |
| If StartBit is greater than 15, then ASSERT(). |
| If EndBit is greater than 15, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to read. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..15. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..15. |
| |
| @return The value of the bit field read from the PCI configuration register. |
| |
| **/ |
| UINT16 |
| EFIAPI |
| S3PciBitFieldRead16 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit |
| ); |
| |
| /** |
| Writes a bit field to a PCI configuration register, and saves the value in |
| the S3 script to be replayed on S3 resume. |
| |
| Writes Value to the bit field of the PCI configuration register. The bit |
| field is specified by the StartBit and the EndBit. All other bits in the |
| destination PCI configuration register are preserved. The new value of the |
| 16-bit register is returned. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 16-bit boundary, then ASSERT(). |
| If StartBit is greater than 15, then ASSERT(). |
| If EndBit is greater than 15, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to write. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..15. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..15. |
| @param[in] Value New value of the bit field. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT16 |
| EFIAPI |
| S3PciBitFieldWrite16 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit, |
| IN UINT16 Value |
| ); |
| |
| /** |
| Reads a bit field in a 16-bit PCI configuration, performs a bitwise OR, and |
| writes the result back to the bit field in the 16-bit port, and saves the value |
| in the S3 script to be replayed on S3 resume. |
| |
| Reads the 16-bit PCI configuration register specified by Address, performs a |
| bitwise OR between the read result and the value specified by |
| OrData, and writes the result to the 16-bit PCI configuration register |
| specified by Address. The value written to the PCI configuration register is |
| returned. This function must guarantee that all PCI read and write operations |
| are serialized. Extra left bits in OrData are stripped. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 16-bit boundary, then ASSERT(). |
| If StartBit is greater than 15, then ASSERT(). |
| If EndBit is greater than 15, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to write. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..15. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..15. |
| @param[in] OrData The value to OR with the PCI configuration register. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT16 |
| EFIAPI |
| S3PciBitFieldOr16 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit, |
| IN UINT16 OrData |
| ); |
| |
| /** |
| Reads a bit field in a 16-bit PCI configuration register, performs a bitwise |
| AND, and writes the result back to the bit field in the 16-bit register and |
| saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 16-bit PCI configuration register specified by Address, performs a |
| bitwise AND between the read result and the value specified by AndData, and |
| writes the result to the 16-bit PCI configuration register specified by |
| Address. The value written to the PCI configuration register is returned. |
| This function must guarantee that all PCI read and write operations are |
| serialized. Extra left bits in AndData are stripped. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 16-bit boundary, then ASSERT(). |
| If StartBit is greater than 15, then ASSERT(). |
| If EndBit is greater than 15, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to write. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..15. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..15. |
| @param[in] AndData The value to AND with the PCI configuration register. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT16 |
| EFIAPI |
| S3PciBitFieldAnd16 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit, |
| IN UINT16 AndData |
| ); |
| |
| /** |
| Reads a bit field in a 16-bit Address, performs a bitwise AND followed by a |
| bitwise OR, and writes the result back to the bit field in the |
| 16-bit port, and saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 16-bit PCI configuration register specified by Address, performs a |
| bitwise AND followed by a bitwise OR between the read result and |
| the value specified by AndData, and writes the result to the 16-bit PCI |
| configuration register specified by Address. The value written to the PCI |
| configuration register is returned. This function must guarantee that all PCI |
| read and write operations are serialized. Extra left bits in both AndData and |
| OrData are stripped. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 16-bit boundary, then ASSERT(). |
| If StartBit is greater than 15, then ASSERT(). |
| If EndBit is greater than 15, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to write. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..15. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..15. |
| @param[in] AndData The value to AND with the PCI configuration register. |
| @param[in] OrData The value to OR with the result of the AND operation. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT16 |
| EFIAPI |
| S3PciBitFieldAndThenOr16 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit, |
| IN UINT16 AndData, |
| IN UINT16 OrData |
| ); |
| |
| /** |
| Reads a 32-bit PCI configuration register, and saves the value in the S3 |
| script to be replayed on S3 resume. |
| |
| Reads and returns the 32-bit PCI configuration register specified by Address. |
| This function must guarantee that all PCI read and write operations are |
| serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 32-bit boundary, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| |
| @return The read value from the PCI configuration register. |
| |
| **/ |
| UINT32 |
| EFIAPI |
| S3PciRead32 ( |
| IN UINTN Address |
| ); |
| |
| /** |
| Writes a 32-bit PCI configuration register, and saves the value in the S3 |
| script to be replayed on S3 resume. |
| |
| Writes the 32-bit PCI configuration register specified by Address with the |
| value specified by Value. Value is returned. This function must guarantee |
| that all PCI read and write operations are serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 32-bit boundary, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| @param[in] Value The value to write. |
| |
| @return The value written to the PCI configuration register. |
| |
| **/ |
| UINT32 |
| EFIAPI |
| S3PciWrite32 ( |
| IN UINTN Address, |
| IN UINT32 Value |
| ); |
| |
| /** |
| Performs a bitwise OR of a 32-bit PCI configuration register with |
| a 32-bit value, and saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 32-bit PCI configuration register specified by Address, performs a |
| bitwise OR between the read result and the value specified by |
| OrData, and writes the result to the 32-bit PCI configuration register |
| specified by Address. The value written to the PCI configuration register is |
| returned. This function must guarantee that all PCI read and write operations |
| are serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 32-bit boundary, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| @param[in] OrData The value to OR with the PCI configuration register. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT32 |
| EFIAPI |
| S3PciOr32 ( |
| IN UINTN Address, |
| IN UINT32 OrData |
| ); |
| |
| /** |
| Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit |
| value, and saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 32-bit PCI configuration register specified by Address, performs a |
| bitwise AND between the read result and the value specified by AndData, and |
| writes the result to the 32-bit PCI configuration register specified by |
| Address. The value written to the PCI configuration register is returned. |
| This function must guarantee that all PCI read and write operations are |
| serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 32-bit boundary, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| @param[in] AndData The value to AND with the PCI configuration register. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT32 |
| EFIAPI |
| S3PciAnd32 ( |
| IN UINTN Address, |
| IN UINT32 AndData |
| ); |
| |
| /** |
| Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit |
| value, followed a bitwise OR with another 32-bit value, and saves |
| the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 32-bit PCI configuration register specified by Address, performs a |
| bitwise AND between the read result and the value specified by AndData, |
| performs a bitwise OR between the result of the AND operation and |
| the value specified by OrData, and writes the result to the 32-bit PCI |
| configuration register specified by Address. The value written to the PCI |
| configuration register is returned. This function must guarantee that all PCI |
| read and write operations are serialized. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 32-bit boundary, then ASSERT(). |
| |
| @param[in] Address The address that encodes the PCI Bus, Device, Function and |
| Register. |
| @param[in] AndData The value to AND with the PCI configuration register. |
| @param[in] OrData The value to OR with the result of the AND operation. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT32 |
| EFIAPI |
| S3PciAndThenOr32 ( |
| IN UINTN Address, |
| IN UINT32 AndData, |
| IN UINT32 OrData |
| ); |
| |
| /** |
| Reads a bit field of a PCI configuration register, and saves the value in |
| the S3 script to be replayed on S3 resume. |
| |
| Reads the bit field in a 32-bit PCI configuration register. The bit field is |
| specified by the StartBit and the EndBit. The value of the bit field is |
| returned. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 32-bit boundary, then ASSERT(). |
| If StartBit is greater than 31, then ASSERT(). |
| If EndBit is greater than 31, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to read. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..31. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..31. |
| |
| @return The value of the bit field read from the PCI configuration register. |
| |
| **/ |
| UINT32 |
| EFIAPI |
| S3PciBitFieldRead32 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit |
| ); |
| |
| /** |
| Writes a bit field to a PCI configuration register, and saves the value in |
| the S3 script to be replayed on S3 resume. |
| |
| Writes Value to the bit field of the PCI configuration register. The bit |
| field is specified by the StartBit and the EndBit. All other bits in the |
| destination PCI configuration register are preserved. The new value of the |
| 32-bit register is returned. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 32-bit boundary, then ASSERT(). |
| If StartBit is greater than 31, then ASSERT(). |
| If EndBit is greater than 31, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to write. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..31. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..31. |
| @param[in] Value New value of the bit field. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT32 |
| EFIAPI |
| S3PciBitFieldWrite32 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit, |
| IN UINT32 Value |
| ); |
| |
| /** |
| Reads a bit field in a 32-bit PCI configuration, performs a bitwise OR, and |
| writes the result back to the bit field in the 32-bit port, and saves the value |
| in the S3 script to be replayed on S3 resume. |
| |
| Reads the 32-bit PCI configuration register specified by Address, performs a |
| bitwise OR between the read result and the value specified by |
| OrData, and writes the result to the 32-bit PCI configuration register |
| specified by Address. The value written to the PCI configuration register is |
| returned. This function must guarantee that all PCI read and write operations |
| are serialized. Extra left bits in OrData are stripped. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 32-bit boundary, then ASSERT(). |
| If StartBit is greater than 31, then ASSERT(). |
| If EndBit is greater than 31, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to write. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..31. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..31. |
| @param[in] OrData The value to OR with the PCI configuration register. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT32 |
| EFIAPI |
| S3PciBitFieldOr32 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit, |
| IN UINT32 OrData |
| ); |
| |
| /** |
| Reads a bit field in a 32-bit PCI configuration register, performs a bitwise |
| AND, and writes the result back to the bit field in the 32-bit register and |
| saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 32-bit PCI configuration register specified by Address, performs a |
| bitwise AND between the read result and the value specified by AndData, and |
| writes the result to the 32-bit PCI configuration register specified by |
| Address. The value written to the PCI configuration register is returned. |
| This function must guarantee that all PCI read and write operations are |
| serialized. Extra left bits in AndData are stripped. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 32-bit boundary, then ASSERT(). |
| If StartBit is greater than 31, then ASSERT(). |
| If EndBit is greater than 31, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to write. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..31. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..31. |
| @param[in] AndData The value to AND with the PCI configuration register. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT32 |
| EFIAPI |
| S3PciBitFieldAnd32 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit, |
| IN UINT32 AndData |
| ); |
| |
| /** |
| Reads a bit field in a 32-bit Address, performs a bitwise AND followed by a |
| bitwise OR, and writes the result back to the bit field in the |
| 32-bit port, and saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the 32-bit PCI configuration register specified by Address, performs a |
| bitwise AND followed by a bitwise OR between the read result and |
| the value specified by AndData, and writes the result to the 32-bit PCI |
| configuration register specified by Address. The value written to the PCI |
| configuration register is returned. This function must guarantee that all PCI |
| read and write operations are serialized. Extra left bits in both AndData and |
| OrData are stripped. |
| |
| If Address > 0x0FFFFFFF, then ASSERT(). |
| If Address is not aligned on a 32-bit boundary, then ASSERT(). |
| If StartBit is greater than 31, then ASSERT(). |
| If EndBit is greater than 31, then ASSERT(). |
| If EndBit is less than StartBit, then ASSERT(). |
| If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT(). |
| |
| @param[in] Address The PCI configuration register to write. |
| @param[in] StartBit The ordinal of the least significant bit in the bit field. |
| Range 0..31. |
| @param[in] EndBit The ordinal of the most significant bit in the bit field. |
| Range 0..31. |
| @param[in] AndData The value to AND with the PCI configuration register. |
| @param[in] OrData The value to OR with the result of the AND operation. |
| |
| @return The value written back to the PCI configuration register. |
| |
| **/ |
| UINT32 |
| EFIAPI |
| S3PciBitFieldAndThenOr32 ( |
| IN UINTN Address, |
| IN UINTN StartBit, |
| IN UINTN EndBit, |
| IN UINT32 AndData, |
| IN UINT32 OrData |
| ); |
| |
| /** |
| Reads a range of PCI configuration registers into a caller supplied buffer, |
| and saves the value in the S3 script to be replayed on S3 resume. |
| |
| Reads the range of PCI configuration registers specified by StartAddress and |
| Size into the buffer specified by Buffer. This function only allows the PCI |
| configuration registers from a single PCI function to be read. Size is |
| returned. When possible 32-bit PCI configuration read cycles are used to read |
| from StartAdress to StartAddress + Size. Due to alignment restrictions, 8-bit |
| and 16-bit PCI configuration read cycles may be used at the beginning and the |
| end of the range. |
| |
| If StartAddress > 0x0FFFFFFF, then ASSERT(). |
| If ((StartAddress & 0xFFF) + Size) > 0x1000, then ASSERT(). |
| If Size > 0 and Buffer is NULL, then ASSERT(). |
| |
| @param[in] StartAddress Starting address that encodes the PCI Bus, Device, |
| Function and Register. |
| @param[in] Size Size in bytes of the transfer. |
| @param[out] Buffer The pointer to a buffer receiving the data read. |
| |
| @return Size. |
| |
| **/ |
| UINTN |
| EFIAPI |
| S3PciReadBuffer ( |
| IN UINTN StartAddress, |
| IN UINTN Size, |
| OUT VOID *Buffer |
| ); |
| |
| /** |
| Copies the data in a caller supplied buffer to a specified range of PCI |
| configuration space, and saves the value in the S3 script to be replayed on S3 |
| resume. |
| |
| Writes the range of PCI configuration registers specified by StartAddress and |
| Size from the buffer specified by Buffer. This function only allows the PCI |
| configuration registers from a single PCI function to be written. Size is |
| returned. When possible 32-bit PCI configuration write cycles are used to |
| write from StartAdress to StartAddress + Size. Due to alignment restrictions, |
| 8-bit and 16-bit PCI configuration write cycles may be used at the beginning |
| and the end of the range. |
| |
| If StartAddress > 0x0FFFFFFF, then ASSERT(). |
| If ((StartAddress & 0xFFF) + Size) > 0x1000, then ASSERT(). |
| If Size > 0 and Buffer is NULL, then ASSERT(). |
| |
| @param[in] StartAddress Starting address that encodes the PCI Bus, Device, |
| Function and Register. |
| @param[in] Size Size in bytes of the transfer. |
| @param[in] Buffer The pointer to a buffer containing the data to write. |
| |
| @return Size. |
| |
| **/ |
| UINTN |
| EFIAPI |
| S3PciWriteBuffer ( |
| IN UINTN StartAddress, |
| IN UINTN Size, |
| IN VOID *Buffer |
| ); |
| |
| #endif |