/** @file
  The default version of EFI_PEI_CPU_IO_PPI support published by PeiServices in
  PeiCore initialization phase.

  EFI_PEI_CPU_IO_PPI is installed by some platform or chipset-specific PEIM that
  abstracts the processor-visible I/O operations. When PeiCore is started, the
  default version of EFI_PEI_CPU_IO_PPI will be assigned to PeiServices table.

  Copyright (c) 2009 - 2016, 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.

**/

#include "PeiMain.h"

///
/// This default instance of EFI_PEI_CPU_IO_PPI install assigned to EFI_PEI_SERVICE.CpuIo
/// when PeiCore's initialization.
///
EFI_PEI_CPU_IO_PPI gPeiDefaultCpuIoPpi = {
  {
    PeiDefaultMemRead,
    PeiDefaultMemWrite
  },
  {
    PeiDefaultIoRead,
    PeiDefaultIoWrite
  },
  PeiDefaultIoRead8,
  PeiDefaultIoRead16,
  PeiDefaultIoRead32,
  PeiDefaultIoRead64,
  PeiDefaultIoWrite8,
  PeiDefaultIoWrite16,
  PeiDefaultIoWrite32,
  PeiDefaultIoWrite64,
  PeiDefaultMemRead8,
  PeiDefaultMemRead16,
  PeiDefaultMemRead32,
  PeiDefaultMemRead64,
  PeiDefaultMemWrite8,
  PeiDefaultMemWrite16,
  PeiDefaultMemWrite32,
  PeiDefaultMemWrite64
};

/**
  Memory-based read services.

  This function is to perform the Memory Access Read service based on installed
  instance of the EFI_PEI_CPU_IO_PPI.
  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then
  return EFI_NOT_YET_AVAILABLE.

  @param[in]      PeiServices           An indirect pointer to the PEI Services Table
                                        published by the PEI Foundation.
  @param[in]      This                  Pointer to local data for the interface.
  @param[in]      Width                 The width of the access. Enumerated in bytes.
  @param[in]      Address               The physical address of the access.
  @param[in]      Count                 The number of accesses to perform.
  @param[in, out] Buffer                A pointer to the buffer of data.

  @retval         EFI_SUCCESS           The function completed successfully.
  @retval         EFI_NOT_YET_AVAILABLE The service has not been installed.

**/
EFI_STATUS
EFIAPI
PeiDefaultMemRead (
  IN  CONST EFI_PEI_SERVICES            **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI          *This,
  IN  EFI_PEI_CPU_IO_PPI_WIDTH          Width,
  IN  UINT64                            Address,
  IN  UINTN                             Count,
  IN  OUT VOID                          *Buffer
  )
{
  return EFI_NOT_AVAILABLE_YET;
}

/**
  Memory-based write services.

  This function is to perform the Memory Access Write service based on installed
  instance of the EFI_PEI_CPU_IO_PPI.
  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then
  return EFI_NOT_YET_AVAILABLE.

  @param[in]      PeiServices           An indirect pointer to the PEI Services Table
                                        published by the PEI Foundation.
  @param[in]      This                  Pointer to local data for the interface.
  @param[in]      Width                 The width of the access. Enumerated in bytes.
  @param[in]      Address               The physical address of the access.
  @param[in]      Count                 The number of accesses to perform.
  @param[in, out] Buffer                A pointer to the buffer of data.

  @retval         EFI_SUCCESS           The function completed successfully.
  @retval         EFI_NOT_YET_AVAILABLE The service has not been installed.

**/
EFI_STATUS
EFIAPI
PeiDefaultMemWrite (
  IN  CONST EFI_PEI_SERVICES            **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI          *This,
  IN  EFI_PEI_CPU_IO_PPI_WIDTH          Width,
  IN  UINT64                            Address,
  IN  UINTN                             Count,
  IN  OUT VOID                          *Buffer
  )
{
  return EFI_NOT_AVAILABLE_YET;
}

/**
  IO-based read services.

  This function is to perform the IO-base read service for the EFI_PEI_CPU_IO_PPI.
  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then
  return EFI_NOT_YET_AVAILABLE.

  @param[in]      PeiServices           An indirect pointer to the PEI Services Table
                                        published by the PEI Foundation.
  @param[in]      This                  Pointer to local data for the interface.
  @param[in]      Width                 The width of the access. Enumerated in bytes.
  @param[in]      Address               The physical address of the access.
  @param[in]      Count                 The number of accesses to perform.
  @param[in, out] Buffer                A pointer to the buffer of data.

  @retval         EFI_SUCCESS           The function completed successfully.
  @retval         EFI_NOT_YET_AVAILABLE The service has not been installed.

**/
EFI_STATUS
EFIAPI
PeiDefaultIoRead (
  IN      CONST EFI_PEI_SERVICES          **PeiServices,
  IN      CONST EFI_PEI_CPU_IO_PPI        *This,
  IN      EFI_PEI_CPU_IO_PPI_WIDTH        Width,
  IN      UINT64                          Address,
  IN      UINTN                           Count,
  IN OUT  VOID                            *Buffer
  )
{
  return EFI_NOT_AVAILABLE_YET;
}

/**
  IO-based write services.

  This function is to perform the IO-base write service for the EFI_PEI_CPU_IO_PPI.
  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then
  return EFI_NOT_YET_AVAILABLE.

  @param[in]      PeiServices           An indirect pointer to the PEI Services Table
                                        published by the PEI Foundation.
  @param[in]      This                  Pointer to local data for the interface.
  @param[in]      Width                 The width of the access. Enumerated in bytes.
  @param[in]      Address               The physical address of the access.
  @param[in]      Count                 The number of accesses to perform.
  @param[in, out] Buffer                A pointer to the buffer of data.

  @retval         EFI_SUCCESS           The function completed successfully.
  @retval         EFI_NOT_YET_AVAILABLE The service has not been installed.

**/
EFI_STATUS
EFIAPI
PeiDefaultIoWrite (
  IN      CONST EFI_PEI_SERVICES          **PeiServices,
  IN      CONST EFI_PEI_CPU_IO_PPI        *This,
  IN      EFI_PEI_CPU_IO_PPI_WIDTH        Width,
  IN      UINT64                          Address,
  IN      UINTN                           Count,
  IN OUT  VOID                            *Buffer
  )
{
  return EFI_NOT_AVAILABLE_YET;
}

/**
  8-bit I/O read operations.

  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then
  return 0.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.

  @return                    An 8-bit value returned from the I/O space.

**/
UINT8
EFIAPI
PeiDefaultIoRead8 (
  IN  CONST EFI_PEI_SERVICES      **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI    *This,
  IN  UINT64                      Address
  )
{
  return 0;
}

/**
  Reads an 16-bit I/O port.

  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then
  return 0.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.

  @return                    A 16-bit value returned from the I/O space.
**/
UINT16
EFIAPI
PeiDefaultIoRead16 (
  IN  CONST EFI_PEI_SERVICES      **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI    *This,
  IN  UINT64                      Address
  )
{
  return 0;
}

/**
  Reads an 32-bit I/O port.

  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then
  return 0.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.

  @return                    A 32-bit value returned from the I/O space.

**/
UINT32
EFIAPI
PeiDefaultIoRead32 (
  IN  CONST EFI_PEI_SERVICES      **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI    *This,
  IN  UINT64                      Address
  )
{
  return 0;
}

/**
  Reads an 64-bit I/O port.

  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then
  return 0.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.

  @return                    A 64-bit value returned from the I/O space.

**/
UINT64
EFIAPI
PeiDefaultIoRead64 (
  IN  CONST EFI_PEI_SERVICES      **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI    *This,
  IN  UINT64                      Address
  )
{
  return 0;
}

/**
  8-bit I/O write operations.
  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then do
  nothing.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.
  @param[in]  Data           The data to write.

**/
VOID
EFIAPI
PeiDefaultIoWrite8 (
  IN  CONST EFI_PEI_SERVICES      **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI    *This,
  IN  UINT64                      Address,
  IN  UINT8                       Data
  )
{
}

/**
  16-bit I/O write operations.
  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then do
  nothing.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.
  @param[in]  Data           The data to write.

**/
VOID
EFIAPI
PeiDefaultIoWrite16 (
  IN  CONST EFI_PEI_SERVICES      **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI    *This,
  IN  UINT64                      Address,
  IN  UINT16                      Data
  )
{
}

/**
  32-bit I/O write operations.
  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then do
  nothing.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.
  @param[in]  Data           The data to write.

**/
VOID
EFIAPI
PeiDefaultIoWrite32 (
  IN  CONST EFI_PEI_SERVICES      **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI    *This,
  IN  UINT64                      Address,
  IN  UINT32                      Data
  )
{
}

/**
  64-bit I/O write operations.
  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then do
  nothing.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.
  @param[in]  Data           The data to write.

**/
VOID
EFIAPI
PeiDefaultIoWrite64 (
  IN  CONST EFI_PEI_SERVICES      **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI    *This,
  IN  UINT64                      Address,
  IN  UINT64                      Data
  )
{
}

/**
  8-bit memory read operations.

  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then
  return 0.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.

  @return                    An 8-bit value returned from the memory space.

**/
UINT8
EFIAPI
PeiDefaultMemRead8 (
  IN  CONST EFI_PEI_SERVICES      **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI    *This,
  IN  UINT64                      Address
  )
{
  return 0;
}

/**
  16-bit memory read operations

  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then
  return 0.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.

  @return                    An 16-bit value returned from the memory space.

**/
UINT16
EFIAPI
PeiDefaultMemRead16 (
  IN  CONST EFI_PEI_SERVICES      **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI    *This,
  IN  UINT64                      Address
  )
{
  return 0;
}

/**
  32-bit memory read operations.

  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then
  return 0.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.

  @return                    An 32-bit value returned from the memory space.

**/
UINT32
EFIAPI
PeiDefaultMemRead32 (
  IN  CONST EFI_PEI_SERVICES      **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI    *This,
  IN  UINT64                      Address
  )
{
  return 0;
}

/**
  64-bit memory read operations.

  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then
  return 0.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.

  @return                    An 64-bit value returned from the memory space.

**/
UINT64
EFIAPI
PeiDefaultMemRead64 (
  IN  CONST EFI_PEI_SERVICES      **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI    *This,
  IN  UINT64                      Address
  )
{
  return 0;
}

/**
  8-bit memory write operations.
  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then do
  nothing.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.
  @param[in]  Data           The data to write.

**/
VOID
EFIAPI
PeiDefaultMemWrite8 (
  IN  CONST EFI_PEI_SERVICES        **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI      *This,
  IN  UINT64                        Address,
  IN  UINT8                         Data
  )
{
}

/**
  16-bit memory write operations.
  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then do
  nothing.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.
  @param[in]  Data           The data to write.

**/
VOID
EFIAPI
PeiDefaultMemWrite16 (
  IN  CONST EFI_PEI_SERVICES        **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI      *This,
  IN  UINT64                        Address,
  IN  UINT16                        Data
  )
{
}

/**
  32-bit memory write operations.
  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then do
  nothing.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.
  @param[in]  Data           The data to write.

**/
VOID
EFIAPI
PeiDefaultMemWrite32 (
  IN  CONST EFI_PEI_SERVICES        **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI      *This,
  IN  UINT64                        Address,
  IN  UINT32                        Data
  )
{
}

/**
  64-bit memory write operations.
  If the EFI_PEI_CPU_IO_PPI is not installed by platform/chipset PEIM, then do
  nothing.

  @param[in]  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.
  @param[in]  This           Pointer to local data for the interface.
  @param[in]  Address        The physical address of the access.
  @param[in]  Data           The data to write.

**/
VOID
EFIAPI
PeiDefaultMemWrite64 (
  IN  CONST EFI_PEI_SERVICES        **PeiServices,
  IN  CONST EFI_PEI_CPU_IO_PPI      *This,
  IN  UINT64                        Address,
  IN  UINT64                        Data
  )
{
}