/** @file\r
\r
- Copyright (c) 2011 - 2012, Intel Corporation. All rights reserved.<BR>\r
+ Copyright (c) 2011 - 2013, Intel Corporation. All rights reserved.<BR>\r
+ Copyright (C) 2013, Red Hat, Inc.\r
+ Copyright (c) 2017, AMD Incorporated. All rights reserved.<BR>\r
\r
- This program and the accompanying materials\r
- are licensed and made available under the terms and conditions of the BSD License\r
- which accompanies this distribution. The full text of the license may be found at\r
- http://opensource.org/licenses/bsd-license.php\r
-\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+ SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#include <Library/MemoryAllocationLib.h>\r
#include <Library/UefiBootServicesTableLib.h>\r
\r
-STATIC BOOLEAN mQemuFwCfgSupported = FALSE;\r
-\r
-\r
-/**\r
- Reads an 8-bit I/O port fifo into a block of memory.\r
-\r
- Reads the 8-bit I/O fifo port specified by Port.\r
-\r
- The port is read Count times, and the read data is\r
- stored in the provided Buffer.\r
-\r
- This function must guarantee that all I/O read and write operations are\r
- serialized.\r
-\r
- If 8-bit I/O port operations are not supported, then ASSERT().\r
-\r
- @param Port The I/O port to read.\r
- @param Count The number of times to read I/O port.\r
- @param Buffer The buffer to store the read data into.\r
-\r
-**/\r
-VOID\r
-EFIAPI\r
-IoReadFifo8 (\r
- IN UINTN Port,\r
- IN UINTN Count,\r
- OUT VOID *Buffer\r
- );\r
-\r
-\r
-/**\r
- Returns a boolean indicating if the firmware configuration interface\r
- is available or not.\r
-\r
- @retval TRUE The interface is available\r
- @retval FALSE The interface is not available\r
-\r
-**/\r
-BOOLEAN\r
-EFIAPI\r
-QemuFwCfgIsAvailable (\r
- VOID\r
- )\r
-{\r
- return mQemuFwCfgSupported;\r
-}\r
-\r
+#include "QemuFwCfgLibInternal.h"\r
\r
/**\r
Selects a firmware configuration item for reading.\r
- \r
+\r
Following this call, any data read from this item will start from\r
the beginning of the configuration item's data.\r
\r
VOID\r
EFIAPI\r
QemuFwCfgSelectItem (\r
- IN FIRMWARE_CONFIG_ITEM QemuFwCfgItem\r
+ IN FIRMWARE_CONFIG_ITEM QemuFwCfgItem\r
)\r
{\r
- DEBUG ((EFI_D_INFO, "Select Item: 0x%x\n", (UINT16)(UINTN) QemuFwCfgItem));\r
- IoWrite16 (0x510, (UINT16)(UINTN) QemuFwCfgItem);\r
+ DEBUG ((DEBUG_INFO, "Select Item: 0x%x\n", (UINT16)(UINTN)QemuFwCfgItem));\r
+ IoWrite16 (FW_CFG_IO_SELECTOR, (UINT16)(UINTN)QemuFwCfgItem);\r
}\r
\r
-\r
/**\r
Reads firmware configuration bytes into a buffer\r
\r
VOID\r
EFIAPI\r
InternalQemuFwCfgReadBytes (\r
- IN UINTN Size,\r
- IN VOID *Buffer OPTIONAL\r
+ IN UINTN Size,\r
+ IN VOID *Buffer OPTIONAL\r
)\r
{\r
- IoReadFifo8 (0x511, Size, Buffer);\r
-}\r
+ if (InternalQemuFwCfgDmaIsAvailable () && (Size <= MAX_UINT32)) {\r
+ InternalQemuFwCfgDmaBytes ((UINT32)Size, Buffer, FW_CFG_DMA_CTL_READ);\r
+ return;\r
+ }\r
\r
+ IoReadFifo8 (FW_CFG_IO_DATA, Size, Buffer);\r
+}\r
\r
/**\r
Reads firmware configuration bytes into a buffer\r
VOID\r
EFIAPI\r
QemuFwCfgReadBytes (\r
- IN UINTN Size,\r
- IN VOID *Buffer\r
+ IN UINTN Size,\r
+ IN VOID *Buffer\r
)\r
{\r
- if (mQemuFwCfgSupported) {\r
+ if (InternalQemuFwCfgIsAvailable ()) {\r
InternalQemuFwCfgReadBytes (Size, Buffer);\r
} else {\r
ZeroMem (Buffer, Size);\r
}\r
}\r
\r
+/**\r
+ Write firmware configuration bytes from a buffer\r
+\r
+ If called multiple times, then the data written will\r
+ continue at the offset of the firmware configuration\r
+ item where the previous write ended.\r
+\r
+ @param[in] Size - Size in bytes to write\r
+ @param[in] Buffer - Buffer to read data from\r
+\r
+**/\r
+VOID\r
+EFIAPI\r
+QemuFwCfgWriteBytes (\r
+ IN UINTN Size,\r
+ IN VOID *Buffer\r
+ )\r
+{\r
+ if (InternalQemuFwCfgIsAvailable ()) {\r
+ if (InternalQemuFwCfgDmaIsAvailable () && (Size <= MAX_UINT32)) {\r
+ InternalQemuFwCfgDmaBytes ((UINT32)Size, Buffer, FW_CFG_DMA_CTL_WRITE);\r
+ return;\r
+ }\r
+\r
+ IoWriteFifo8 (FW_CFG_IO_DATA, Size, Buffer);\r
+ }\r
+}\r
+\r
+/**\r
+ Skip bytes in the firmware configuration item.\r
+\r
+ Increase the offset of the firmware configuration item without transferring\r
+ bytes between the item and a caller-provided buffer. Subsequent read, write\r
+ or skip operations will commence at the increased offset.\r
+\r
+ @param[in] Size Number of bytes to skip.\r
+**/\r
+VOID\r
+EFIAPI\r
+QemuFwCfgSkipBytes (\r
+ IN UINTN Size\r
+ )\r
+{\r
+ UINTN ChunkSize;\r
+ UINT8 SkipBuffer[256];\r
+\r
+ if (!InternalQemuFwCfgIsAvailable ()) {\r
+ return;\r
+ }\r
+\r
+ if (InternalQemuFwCfgDmaIsAvailable () && (Size <= MAX_UINT32)) {\r
+ InternalQemuFwCfgDmaBytes ((UINT32)Size, NULL, FW_CFG_DMA_CTL_SKIP);\r
+ return;\r
+ }\r
+\r
+ //\r
+ // Emulate the skip by reading data in chunks, and throwing it away. The\r
+ // implementation below is suitable even for phases where RAM or dynamic\r
+ // allocation is not available or appropriate. It also doesn't affect the\r
+ // static data footprint for client modules. Large skips are not expected,\r
+ // therefore this fallback is not performance critical. The size of\r
+ // SkipBuffer is thought not to exert a large pressure on the stack in any\r
+ // phase.\r
+ //\r
+ while (Size > 0) {\r
+ ChunkSize = MIN (Size, sizeof SkipBuffer);\r
+ IoReadFifo8 (FW_CFG_IO_DATA, ChunkSize, SkipBuffer);\r
+ Size -= ChunkSize;\r
+ }\r
+}\r
\r
/**\r
Reads a UINT8 firmware configuration value\r
VOID\r
)\r
{\r
- UINT8 Result;\r
+ UINT8 Result;\r
\r
QemuFwCfgReadBytes (sizeof (Result), &Result);\r
\r
return Result;\r
}\r
\r
-\r
/**\r
Reads a UINT16 firmware configuration value\r
\r
VOID\r
)\r
{\r
- UINT16 Result;\r
+ UINT16 Result;\r
\r
QemuFwCfgReadBytes (sizeof (Result), &Result);\r
\r
return Result;\r
}\r
\r
-\r
/**\r
Reads a UINT32 firmware configuration value\r
\r
VOID\r
)\r
{\r
- UINT32 Result;\r
+ UINT32 Result;\r
\r
QemuFwCfgReadBytes (sizeof (Result), &Result);\r
\r
return Result;\r
}\r
\r
-\r
/**\r
Reads a UINT64 firmware configuration value\r
\r
VOID\r
)\r
{\r
- UINT64 Result;\r
+ UINT64 Result;\r
\r
QemuFwCfgReadBytes (sizeof (Result), &Result);\r
\r
return Result;\r
}\r
\r
+/**\r
+ Find the configuration item corresponding to the firmware configuration file.\r
+\r
+ @param[in] Name - Name of file to look up.\r
+ @param[out] Item - Configuration item corresponding to the file, to be passed\r
+ to QemuFwCfgSelectItem ().\r
+ @param[out] Size - Number of bytes in the file.\r
+\r
+ @return RETURN_SUCCESS If file is found.\r
+ RETURN_NOT_FOUND If file is not found.\r
+ RETURN_UNSUPPORTED If firmware configuration is unavailable.\r
\r
+**/\r
RETURN_STATUS\r
EFIAPI\r
-QemuFwCfgInitialize (\r
- VOID\r
+QemuFwCfgFindFile (\r
+ IN CONST CHAR8 *Name,\r
+ OUT FIRMWARE_CONFIG_ITEM *Item,\r
+ OUT UINTN *Size\r
)\r
{\r
- UINT32 Signature;\r
- UINT32 Revision;\r
+ UINT32 Count;\r
+ UINT32 Idx;\r
\r
- //\r
- // Enable the access routines while probing to see if it is supported.\r
- //\r
- mQemuFwCfgSupported = TRUE;\r
-\r
- QemuFwCfgSelectItem (QemuFwCfgItemSignature);\r
- Signature = QemuFwCfgRead32 ();\r
- DEBUG ((EFI_D_INFO, "FW CFG Signature: 0x%x\n", Signature));\r
- QemuFwCfgSelectItem (QemuFwCfgItemInterfaceVersion);\r
- Revision = QemuFwCfgRead32 ();\r
- DEBUG ((EFI_D_INFO, "FW CFG Revision: 0x%x\n", Revision));\r
- if ((Signature != SIGNATURE_32 ('Q', 'E', 'M', 'U')) ||\r
- (Revision < 1)\r
- ) {\r
- DEBUG ((EFI_D_INFO, "QemuFwCfg interface not supported.\n"));\r
- mQemuFwCfgSupported = FALSE;\r
- return RETURN_SUCCESS;\r
+ if (!InternalQemuFwCfgIsAvailable ()) {\r
+ return RETURN_UNSUPPORTED;\r
+ }\r
+\r
+ QemuFwCfgSelectItem (QemuFwCfgItemFileDir);\r
+ Count = SwapBytes32 (QemuFwCfgRead32 ());\r
+\r
+ for (Idx = 0; Idx < Count; ++Idx) {\r
+ UINT32 FileSize;\r
+ UINT16 FileSelect;\r
+ UINT16 FileReserved;\r
+ CHAR8 FName[QEMU_FW_CFG_FNAME_SIZE];\r
+\r
+ FileSize = QemuFwCfgRead32 ();\r
+ FileSelect = QemuFwCfgRead16 ();\r
+ FileReserved = QemuFwCfgRead16 ();\r
+ (VOID)FileReserved; /* Force a do-nothing reference. */\r
+ InternalQemuFwCfgReadBytes (sizeof (FName), FName);\r
+\r
+ if (AsciiStrCmp (Name, FName) == 0) {\r
+ *Item = SwapBytes16 (FileSelect);\r
+ *Size = SwapBytes32 (FileSize);\r
+ return RETURN_SUCCESS;\r
+ }\r
}\r
\r
- DEBUG ((EFI_D_INFO, "QemuFwCfg interface is supported.\n"));\r
- return RETURN_SUCCESS;\r
+ return RETURN_NOT_FOUND;\r
}\r