public inbox for devel@edk2.groups.io
 help / color / mirror / Atom feed
From: "Chang, Abner via groups.io" <abner.chang=amd.com@groups.io>
To: "Chesley, Brit" <Brit.Chesley@amd.com>,
	"devel@edk2.groups.io" <devel@edk2.groups.io>
Cc: "Attar, AbdulLateef (Abdul Lateef)" <AbdulLateef.Attar@amd.com>
Subject: Re: [edk2-devel] [PATCH v1 5/6] MdeModulePkg: SpiHc: SpiHc Drivers
Date: Thu, 2 May 2024 04:25:30 +0000	[thread overview]
Message-ID: <LV8PR12MB9452BCE1EC93CB6CBEBA571CEA182@LV8PR12MB9452.namprd12.prod.outlook.com> (raw)
In-Reply-To: <20240501190527.200937-6-brit.chesley@amd.com>

[AMD Official Use Only - General]

We had reviewed this patch internally before sending this to community.
Reviewed-by: Abner Chang <abner.chang@amd.com>

> -----Original Message-----
> From: Chesley, Brit <Brit.Chesley@amd.com>
> Sent: Thursday, May 2, 2024 3:05 AM
> To: devel@edk2.groups.io
> Cc: Chang, Abner <Abner.Chang@amd.com>; Attar, AbdulLateef (Abdul
> Lateef) <AbdulLateef.Attar@amd.com>
> Subject: [PATCH v1 5/6] MdeModulePkg: SpiHc: SpiHc Drivers
>
> From: Brit Chesley <brit.chesley@amd.com>
>
> Added SpiHc DXE and SMM drivers. This code receives bus transactions
> from the SpiBus layer and passes them onto the SpiHcPlatformLib
>
> Platform Initialization Spec 1.7 volume 5 section 18.1.7
>
> Bugzilla #4753
>
> Cc: Abner Chang <abner.chang@amd.com>
> Cc: Abdul Lateef Attar <AbdulLateef.Attar@amd.com>
> Signed-off-by: Brit Chesley <brit.chesley@amd.com>
> ---
>  MdeModulePkg/Bus/Spi/SpiHc/SpiHcDxe.inf |  47 ++++++++++
>  MdeModulePkg/Bus/Spi/SpiHc/SpiHcSmm.inf |  45 +++++++++
>  MdeModulePkg/Bus/Spi/SpiHc/SpiHc.h      | 117
> ++++++++++++++++++++++++
>  MdeModulePkg/Bus/Spi/SpiHc/SpiHc.c      | 115
> +++++++++++++++++++++++
>  MdeModulePkg/Bus/Spi/SpiHc/SpiHcDxe.c   | 101 ++++++++++++++++++++
>  MdeModulePkg/Bus/Spi/SpiHc/SpiHcSmm.c   |  79 ++++++++++++++++
>  MdeModulePkg/Bus/Spi/SpiHc/SpiHc.uni    |  10 ++
>  7 files changed, 514 insertions(+)
>  create mode 100644 MdeModulePkg/Bus/Spi/SpiHc/SpiHcDxe.inf
>  create mode 100644 MdeModulePkg/Bus/Spi/SpiHc/SpiHcSmm.inf
>  create mode 100644 MdeModulePkg/Bus/Spi/SpiHc/SpiHc.h
>  create mode 100644 MdeModulePkg/Bus/Spi/SpiHc/SpiHc.c
>  create mode 100644 MdeModulePkg/Bus/Spi/SpiHc/SpiHcDxe.c
>  create mode 100644 MdeModulePkg/Bus/Spi/SpiHc/SpiHcSmm.c
>  create mode 100644 MdeModulePkg/Bus/Spi/SpiHc/SpiHc.uni
>
> diff --git a/MdeModulePkg/Bus/Spi/SpiHc/SpiHcDxe.inf
> b/MdeModulePkg/Bus/Spi/SpiHc/SpiHcDxe.inf
> new file mode 100644
> index 000000000000..b71f1535cd46
> --- /dev/null
> +++ b/MdeModulePkg/Bus/Spi/SpiHc/SpiHcDxe.inf
> @@ -0,0 +1,47 @@
> +## @file
> +#  The SPI Host Controller Module DXE driver INF file
> +#
> +#  Copyright (C) 2024 Advanced Micro Devices, Inc. All rights reserved.
> +#
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> +#
> +##
> +
> +[Defines]
> +  INF_VERSION               = 1.27
> +  BASE_NAME                 = SpiHcDxe
> +  FILE_GUID                 = 95D148FF-5A23-43B9-9FC4-80AE0DD48D32
> +  MODULE_TYPE               = DXE_DRIVER
> +  VERSION_STRING            = 0.1
> +  PI_SPECIFICATION_VERSION  = 0x0001000A
> +  ENTRY_POINT               = SpiHcProtocolEntry
> +
> +[Packages]
> +  MdePkg/MdePkg.dec
> +  MdeModulePkg/MdeModulePkg.dec
> +
> +[LibraryClasses]
> +  BaseLib
> +  BaseMemoryLib
> +  DebugLib
> +  DevicePathLib
> +  MemoryAllocationLib
> +  SpiHcPlatformLib
> +  UefiBootServicesTableLib
> +  UefiDriverEntryPoint
> +  UefiLib
> +  UefiRuntimeServicesTableLib
> +
> +[Sources]
> +  SpiHc.h
> +  SpiHc.c
> +  SpiHcDxe.c
> +
> +[Protocols]
> +  gEfiSpiHcProtocolGuid
> +
> +[Depex]
> +  TRUE
> +
> +[UserExtensions.TianoCore."ExtraFiles"]
> +  SpiHc.uni
> diff --git a/MdeModulePkg/Bus/Spi/SpiHc/SpiHcSmm.inf
> b/MdeModulePkg/Bus/Spi/SpiHc/SpiHcSmm.inf
> new file mode 100644
> index 000000000000..95d5466d904b
> --- /dev/null
> +++ b/MdeModulePkg/Bus/Spi/SpiHc/SpiHcSmm.inf
> @@ -0,0 +1,45 @@
> +## @file
> +#  The SPI Host Controller Module SMM driver INF file
> +#
> +#  Copyright (C) 2024 Advanced Micro Devices, Inc. All rights reserved.
> +#
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> +#
> +##
> +
> +[Defines]
> +  INF_VERSION               = 1.27
> +  BASE_NAME                 = SpiHcSmm
> +  FILE_GUID                 = 0CDAE298-CB3B-480A-BDC4-A6840FFE1F5E
> +  MODULE_TYPE               = DXE_SMM_DRIVER
> +  VERSION_STRING            = 0.1
> +  PI_SPECIFICATION_VERSION  = 0x0001000A
> +  ENTRY_POINT               = SpiHcProtocolEntry
> +
> +[Packages]
> +  MdePkg/MdePkg.dec
> +  MdeModulePkg/MdeModulePkg.dec
> +
> +[LibraryClasses]
> +  BaseLib
> +  BaseMemoryLib
> +  DebugLib
> +  MemoryAllocationLib
> +  MmServicesTableLib
> +  SpiHcPlatformLib
> +  UefiDriverEntryPoint
> +  UefiLib
> +
> +[Sources]
> +  SpiHc.h
> +  SpiHc.c
> +  SpiHcSmm.c
> +
> +[Protocols]
> +  gEfiSpiSmmHcProtocolGuid
> +
> +[Depex]
> +  TRUE
> +
> +[UserExtensions.TianoCore."ExtraFiles"]
> +  SpiHc.uni
> diff --git a/MdeModulePkg/Bus/Spi/SpiHc/SpiHc.h
> b/MdeModulePkg/Bus/Spi/SpiHc/SpiHc.h
> new file mode 100644
> index 000000000000..c6e4c5893d53
> --- /dev/null
> +++ b/MdeModulePkg/Bus/Spi/SpiHc/SpiHc.h
> @@ -0,0 +1,117 @@
> +/** @file
> +
> +  SPI Host Controller function declarations
> +
> +  Copyright (C) 2024 Advanced Micro Devices, Inc. All rights reserved.<BR>
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> +
> +**/
> +
> +#ifndef SPI_HC_H_
> +#define SPI_HC_H_
> +
> +#include <PiDxe.h>
> +#include <Library/BaseLib.h>
> +#include <Library/BaseMemoryLib.h>
> +#include <Library/DebugLib.h>
> +#include <Library/IoLib.h>
> +#include <Protocol/SpiHc.h>
> +#include <Library/SpiHcPlatformLib.h>
> +
> +/**
> +  Assert or deassert the SPI chip select.
> +
> +  This routine is called at TPL_NOTIFY.
> +  Update the value of the chip select line for a SPI peripheral. The SPI bus
> +  layer calls this routine either in the board layer or in the SPI controller
> +  to manipulate the chip select pin at the start and end of a SPI transaction.
> +
> +  @param[in] This           Pointer to an EFI_SPI_HC_PROTOCOL structure.
> +  @param[in] SpiPeripheral  The address of an EFI_SPI_PERIPHERAL data
> structure
> +                            describing the SPI peripheral whose chip select pin
> +                            is to be manipulated. The routine may access the
> +                            ChipSelectParameter field to gain sufficient
> +                            context to complete the operati on.
> +  @param[in] PinValue       The value to be applied to the chip select line of
> +                            the SPI peripheral.
> +
> +  @retval EFI_SUCCESS            The chip select was set as requested
> +  @retval EFI_NOT_READY          Support for the chip select is not properly
> +                                 initialized
> +  @retval EFI_INVALID_PARAMETER  The ChipSeLect value or its contents are
> +                                 invalid
> +
> +**/
> +EFI_STATUS
> +EFIAPI
> +ChipSelect (
> +  IN CONST EFI_SPI_HC_PROTOCOL  *This,
> +  IN CONST EFI_SPI_PERIPHERAL   *SpiPeripheral,
> +  IN BOOLEAN                    PinValue
> +  );
> +
> +/**
> +  Set up the clock generator to produce the correct clock frequency, phase
> and
> +  polarity for a SPI chip.
> +
> +  This routine is called at TPL_NOTIFY.
> +  This routine updates the clock generator to generate the correct frequency
> +  and polarity for the SPI clock.
> +
> +  @param[in] This           Pointer to an EFI_SPI_HC_PROTOCOL structure.
> +  @param[in] SpiPeripheral  Pointer to a EFI_SPI_PERIPHERAL data structure
> from
> +                            which the routine can access the ClockParameter,
> +                            ClockPhase and ClockPolarity fields. The routine
> +                            also has access to the names for the SPI bus and
> +                            chip which can be used during debugging.
> +  @param[in] ClockHz        Pointer to the requested clock frequency. The SPI
> +                            host controller will choose a supported clock
> +                            frequency which is less then or equal to this
> +                            value. Specify zero to turn the clock generator
> +                            off. The actual clock frequency supported by the
> +                            SPI host controller will be returned.
> +
> +  @retval EFI_SUCCESS      The clock was set up successfully
> +  @retval EFI_UNSUPPORTED  The SPI controller was not able to support the
> +                           frequency requested by ClockHz
> +
> +**/
> +EFI_STATUS
> +EFIAPI
> +Clock (
> +  IN CONST EFI_SPI_HC_PROTOCOL  *This,
> +  IN CONST EFI_SPI_PERIPHERAL   *SpiPeripheral,
> +  IN UINT32                     *ClockHz
> +  );
> +
> +/**
> +  Perform the SPI transaction on the SPI peripheral using the SPI host
> +  controller.
> +
> +  This routine is called at TPL_NOTIFY.
> +  This routine synchronously returns EFI_SUCCESS indicating that the
> +  asynchronous SPI transaction was started. The routine then waits for
> +  completion of the SPI transaction prior to returning the final transaction
> +  status.
> +
> +  @param[in] This            Pointer to an EFI_SPI_HC_PROTOCOL structure.
> +  @param[in] BusTransaction  Pointer to a EFI_SPI_BUS_ TRANSACTION
> containing
> +                             the description of the SPI transaction to perform.
> +
> +  @retval EFI_SUCCESS         The transaction completed successfully
> +  @retval EFI_BAD_BUFFER_SIZE The BusTransaction->WriteBytes value is
> invalid,
> +                              or the BusTransaction->ReadinBytes value is
> +                              invalid
> +  @retval EFI_UNSUPPORTED     The BusTransaction-> Transaction Type is
> +                              unsupported
> +  @retval EFI_DEVICE_ERROR    SPI Host Controller failed transaction
> +
> +**/
> +EFI_STATUS
> +EFIAPI
> +Transaction (
> +  IN CONST EFI_SPI_HC_PROTOCOL  *This,
> +  IN EFI_SPI_BUS_TRANSACTION    *BusTransaction
> +  );
> +
> +#endif //SPI_HC_H_
> diff --git a/MdeModulePkg/Bus/Spi/SpiHc/SpiHc.c
> b/MdeModulePkg/Bus/Spi/SpiHc/SpiHc.c
> new file mode 100644
> index 000000000000..9d7bf9f542ef
> --- /dev/null
> +++ b/MdeModulePkg/Bus/Spi/SpiHc/SpiHc.c
> @@ -0,0 +1,115 @@
> +/** @file
> +
> +  SPI Host Controller shell implementation, as host controller code is platform
> +  specfic.
> +
> +  Copyright (C) 2024 Advanced Micro Devices, Inc. All rights reserved.<BR>
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> +
> +**/
> +#include "SpiHc.h"
> +
> +/**
> +  Assert or deassert the SPI chip select.
> +
> +  This routine is called at TPL_NOTIFY.
> +  Update the value of the chip select line for a SPI peripheral. The SPI bus
> +  layer calls this routine either in the board layer or in the SPI controller
> +  to manipulate the chip select pin at the start and end of a SPI transaction.
> +
> +  @param[in] This           Pointer to an EFI_SPI_HC_PROTOCOL structure.
> +  @param[in] SpiPeripheral  The address of an EFI_SPI_PERIPHERAL data
> structure
> +                            describing the SPI peripheral whose chip select pin
> +                            is to be manipulated. The routine may access the
> +                            ChipSelectParameter field to gain sufficient
> +                            context to complete the operati on.
> +  @param[in] PinValue       The value to be applied to the chip select line of
> +                            the SPI peripheral.
> +
> +  @retval EFI_SUCCESS            The chip select was set as requested
> +  @retval EFI_NOT_READY          Support for the chip select is not properly
> +                                 initialized
> +  @retval EFI_INVALID_PARAMETER  The ChipSeLect value or its contents are
> +                                 invalid
> +
> +**/
> +EFI_STATUS
> +EFIAPI
> +ChipSelect (
> +  IN CONST EFI_SPI_HC_PROTOCOL  *This,
> +  IN CONST EFI_SPI_PERIPHERAL   *SpiPeripheral,
> +  IN BOOLEAN                    PinValue
> +  )
> +{
> +  return PlatformSpiHcChipSelect (This, SpiPeripheral, PinValue);
> +}
> +
> +/**
> +  Set up the clock generator to produce the correct clock frequency, phase
> and
> +  polarity for a SPI chip.
> +
> +  This routine is called at TPL_NOTIFY.
> +  This routine updates the clock generator to generate the correct frequency
> +  and polarity for the SPI clock.
> +
> +  @param[in] This           Pointer to an EFI_SPI_HC_PROTOCOL structure.
> +  @param[in] SpiPeripheral  Pointer to a EFI_SPI_PERIPHERAL data structure
> from
> +                            which the routine can access the ClockParameter,
> +                            ClockPhase and ClockPolarity fields. The routine
> +                            also has access to the names for the SPI bus and
> +                            chip which can be used during debugging.
> +  @param[in] ClockHz        Pointer to the requested clock frequency. The SPI
> +                            host controller will choose a supported clock
> +                            frequency which is less then or equal to this
> +                            value. Specify zero to turn the clock generator
> +                            off. The actual clock frequency supported by the
> +                            SPI host controller will be returned.
> +
> +  @retval EFI_SUCCESS      The clock was set up successfully
> +  @retval EFI_UNSUPPORTED  The SPI controller was not able to support the
> +                           frequency requested by ClockHz
> +
> +**/
> +EFI_STATUS
> +EFIAPI
> +Clock (
> +  IN CONST EFI_SPI_HC_PROTOCOL  *This,
> +  IN CONST EFI_SPI_PERIPHERAL   *SpiPeripheral,
> +  IN UINT32                     *ClockHz
> +  )
> +{
> +  return PlatformSpiHcClock (This, SpiPeripheral, ClockHz);
> +}
> +
> +/**
> +  Perform the SPI transaction on the SPI peripheral using the SPI host
> +  controller.
> +
> +  This routine is called at TPL_NOTIFY.
> +  This routine synchronously returns EFI_SUCCESS indicating that the
> +  asynchronous SPI transaction was started. The routine then waits for
> +  completion of the SPI transaction prior to returning the final transaction
> +  status.
> +
> +  @param[in] This            Pointer to an EFI_SPI_HC_PROTOCOL structure.
> +  @param[in] BusTransaction  Pointer to a EFI_SPI_BUS_ TRANSACTION
> containing
> +                             the description of the SPI transaction to perform.
> +
> +  @retval EFI_SUCCESS         The transaction completed successfully
> +  @retval EFI_BAD_BUFFER_SIZE The BusTransaction->WriteBytes value is
> invalid,
> +                              or the BusTransaction->ReadinBytes value is
> +                              invalid
> +  @retval EFI_UNSUPPORTED     The BusTransaction-> Transaction Type is
> +                              unsupported
> +  @retval EFI_DEVICE_ERROR    SPI Host Controller failed transaction
> +
> +**/
> +EFI_STATUS
> +EFIAPI
> +Transaction (
> +  IN CONST EFI_SPI_HC_PROTOCOL  *This,
> +  IN EFI_SPI_BUS_TRANSACTION    *BusTransaction
> +  )
> +{
> +  return PlatformSpiHcTransaction (This, BusTransaction);
> +}
> diff --git a/MdeModulePkg/Bus/Spi/SpiHc/SpiHcDxe.c
> b/MdeModulePkg/Bus/Spi/SpiHc/SpiHcDxe.c
> new file mode 100644
> index 000000000000..d0e9827eb67c
> --- /dev/null
> +++ b/MdeModulePkg/Bus/Spi/SpiHc/SpiHcDxe.c
> @@ -0,0 +1,101 @@
> +/** @file
> +
> +  SPI Host controller entry point for DXE
> +
> +  Copyright (C) 2024 Advanced Micro Devices, Inc. All rights reserved.<BR>
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> +
> +**/
> +#include <Base.h>
> +#include <Library/BaseLib.h>
> +#include <Library/DebugLib.h>
> +#include <Library/PcdLib.h>
> +#include <Library/UefiLib.h>
> +#include <Library/MemoryAllocationLib.h>
> +#include <Library/UefiBootServicesTableLib.h>
> +#include <Library/UefiRuntimeServicesTableLib.h>
> +#include <Library/SpiHcPlatformLib.h>
> +#include <Protocol/SpiHc.h>
> +#include <IndustryStandard/SpiNorFlashJedecSfdp.h>
> +#include "SpiHc.h"
> +
> +EFI_HANDLE  mSpiHcHandle = 0;
> +
> +/**
> +  Entry point of the SPI Host Controller driver. Installs the
> EFI_SPI_HC_PROTOCOL on mSpiHcHandle.
> +  Also installs the EFI_DEVICE_PATH_PROTOCOL corresponding to the SPI
> Host controller on the same
> +  mSpiHcHandle.
> +
> +  @param[in] ImageHandle  Image handle of this driver.
> +  @param[in] SystemTable  Pointer to standard EFI system table.
> +
> +  @retval EFI_SUCCESS       Succeed.
> +  @retval EFI_OUT_RESOURCES If the system has run out of memory
> +**/
> +EFI_STATUS
> +EFIAPI
> +SpiHcProtocolEntry (
> +  IN EFI_HANDLE        ImageHandle,
> +  IN EFI_SYSTEM_TABLE  *SystemTable
> +  )
> +{
> +  EFI_STATUS                Status;
> +  EFI_SPI_HC_PROTOCOL       *HcProtocol;
> +  EFI_DEVICE_PATH_PROTOCOL  *HcDevicePath;
> +
> +  DEBUG ((DEBUG_VERBOSE, "%a - ENTRY\n", __func__));
> +
> +  // Allocate the SPI Host Controller protocol
> +  HcProtocol = AllocateZeroPool (sizeof (EFI_SPI_HC_PROTOCOL));
> +  ASSERT (HcProtocol != NULL);
> +  if (HcProtocol == NULL) {
> +    return EFI_OUT_OF_RESOURCES;
> +  }
> +
> +  // Fill in the SPI Host Controller Protocol
> +  Status = GetPlatformSpiHcDetails (
> +             &HcProtocol->Attributes,
> +             &HcProtocol->FrameSizeSupportMask,
> +             &HcProtocol->MaximumTransferBytes
> +             );
> +
> +  if (EFI_ERROR (Status)) {
> +    DEBUG ((DEBUG_VERBOSE, "Error, no Platform SPI HC details\n"));
> +    return Status;
> +  }
> +
> +  HcProtocol->ChipSelect  = ChipSelect;
> +  HcProtocol->Clock       = Clock;
> +  HcProtocol->Transaction = Transaction;
> +
> +  // Install Host Controller protocol
> +  Status = gBS->InstallProtocolInterface (
> +                  &mSpiHcHandle,
> +                  &gEfiSpiHcProtocolGuid,
> +                  EFI_NATIVE_INTERFACE,
> +                  HcProtocol
> +                  );
> +
> +  if (EFI_ERROR (Status)) {
> +    DEBUG ((DEBUG_VERBOSE, "Error installing gEfiSpiHcProtocolGuid\n"));
> +    return Status;
> +  }
> +
> +  Status = GetSpiHcDevicePath (&HcDevicePath);
> +
> +  // Install HC device path here on this handle as well
> +  Status = gBS->InstallProtocolInterface (
> +                  &mSpiHcHandle,
> +                  &gEfiDevicePathProtocolGuid,
> +                  EFI_NATIVE_INTERFACE,
> +                  HcDevicePath
> +                  );
> +
> +  if (EFI_ERROR (Status)) {
> +    DEBUG ((DEBUG_VERBOSE, "Error installing
> gEfiDevicePathProtocolGuid\n"));
> +  }
> +
> +  DEBUG ((DEBUG_VERBOSE, "%a - EXIT Status=%r\n", __func__, Status));
> +
> +  return Status;
> +}
> diff --git a/MdeModulePkg/Bus/Spi/SpiHc/SpiHcSmm.c
> b/MdeModulePkg/Bus/Spi/SpiHc/SpiHcSmm.c
> new file mode 100644
> index 000000000000..adebff97631a
> --- /dev/null
> +++ b/MdeModulePkg/Bus/Spi/SpiHc/SpiHcSmm.c
> @@ -0,0 +1,79 @@
> +/** @file
> +
> +  SPI Host controller entry point for SMM
> +
> +  Copyright (C) 2024 Advanced Micro Devices, Inc. All rights reserved.<BR>
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> +
> +**/
> +#include <Base.h>
> +#include <Library/BaseLib.h>
> +#include <Library/DebugLib.h>
> +#include <Library/PcdLib.h>
> +#include <Library/UefiLib.h>
> +#include <Library/MemoryAllocationLib.h>
> +#include <Library/MmServicesTableLib.h>
> +#include <Library/UefiRuntimeServicesTableLib.h>
> +#include <Library/SpiHcPlatformLib.h>
> +#include <Protocol/SpiSmmHc.h>
> +#include <IndustryStandard/SpiNorFlashJedecSfdp.h>
> +#include "SpiHc.h"
> +
> +EFI_HANDLE  mSpiHcHandle = 0;
> +
> +/**
> +  Entry point of the SPI Host Controller driver. Installs the
> EFI_SPI_HC_PROTOCOL on mSpiHcHandle.
> +  Also installs the EFI_DEVICE_PATH_PROTOCOL corresponding to the SPI
> Host controller on the same
> +  mSpiHcHandle.
> +
> +  @param[in] ImageHandle  Image handle of this driver.
> +  @param[in] SystemTable  Pointer to standard EFI system table.
> +
> +  @retval EFI_SUCCESS       Succeed.
> +  @retval EFI_OUT_RESOURCES If the system has run out of memory
> +**/
> +EFI_STATUS
> +EFIAPI
> +SpiHcProtocolEntry (
> +  IN EFI_HANDLE        ImageHandle,
> +  IN EFI_SYSTEM_TABLE  *SystemTable
> +  )
> +{
> +  EFI_STATUS           Status;
> +  EFI_SPI_HC_PROTOCOL  *HcProtocol;
> +
> +  DEBUG ((DEBUG_VERBOSE, "%a - ENTRY\n", __func__));
> +
> +  // Allocate the SPI Host Controller protocol
> +  HcProtocol = AllocateZeroPool (sizeof (EFI_SPI_HC_PROTOCOL));
> +  ASSERT (HcProtocol != NULL);
> +  if (HcProtocol == NULL) {
> +    return EFI_OUT_OF_RESOURCES;
> +  }
> +
> +  // Fill in the SPI Host Controller Protocol
> +  Status = GetPlatformSpiHcDetails (
> +             &HcProtocol->Attributes,
> +             &HcProtocol->FrameSizeSupportMask,
> +             &HcProtocol->MaximumTransferBytes
> +             );
> +
> +  HcProtocol->ChipSelect  = ChipSelect;
> +  HcProtocol->Clock       = Clock;
> +  HcProtocol->Transaction = Transaction;
> +
> +  Status = gMmst->MmInstallProtocolInterface (
> +                    &mSpiHcHandle,
> +                    &gEfiSpiSmmHcProtocolGuid,
> +                    EFI_NATIVE_INTERFACE,
> +                    HcProtocol
> +                    );
> +
> +  if (EFI_ERROR (Status)) {
> +    DEBUG ((DEBUG_VERBOSE, "Error installing
> gEfiSpiSmmHcProtocolGuid\n"));
> +  }
> +
> +  DEBUG ((DEBUG_VERBOSE, "%a - EXIT Status=%r\n", __func__, Status));
> +
> +  return Status;
> +}
> diff --git a/MdeModulePkg/Bus/Spi/SpiHc/SpiHc.uni
> b/MdeModulePkg/Bus/Spi/SpiHc/SpiHc.uni
> new file mode 100644
> index 000000000000..9fab0a7433c5
> --- /dev/null
> +++ b/MdeModulePkg/Bus/Spi/SpiHc/SpiHc.uni
> @@ -0,0 +1,10 @@
> +// /** @file
> +//
> +// Copyright (C) 2024 Advanced Micro Devices, Inc. All rights reserved.<BR>
> +//
> +// SPDX-License-Identifier: BSD-2-Clause-Patent
> +//
> +// **/
> +
> +#string STR_PROPERTIES_MODULE_NAME
> +#language en-US   "SPI host controller driver"
> --
> 2.42.1



-=-=-=-=-=-=-=-=-=-=-=-
Groups.io Links: You receive all messages sent to this group.
View/Reply Online (#118496): https://edk2.groups.io/g/devel/message/118496
Mute This Topic: https://groups.io/mt/105849138/7686176
Group Owner: devel+owner@edk2.groups.io
Unsubscribe: https://edk2.groups.io/g/devel/unsub [rebecca@openfw.io]
-=-=-=-=-=-=-=-=-=-=-=-



  reply	other threads:[~2024-05-02  4:25 UTC|newest]

Thread overview: 19+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-05-01 19:05 [edk2-devel] [PATCH v1 0/6] SPI Driver Stack Chesley, Brit via groups.io
2024-05-01 19:05 ` [edk2-devel] [PATCH v1 1/6] MdePkg/SpiConfiguration: Correct the definition spelling Chesley, Brit via groups.io
2024-05-02  4:20   ` Chang, Abner via groups.io
2024-05-01 19:05 ` [edk2-devel] [PATCH v1 2/6] MdeModulePkg/Bus/Spi/SpiBus: Adding SpiBus Drivers Chesley, Brit via groups.io
2024-05-02  4:24   ` Chang, Abner via groups.io
2024-05-01 19:05 ` [edk2-devel] [PATCH v1 3/6] MdeModulePkg: " Chesley, Brit via groups.io
2024-05-02  4:24   ` Chang, Abner via groups.io
2024-05-06 11:08   ` Chang, Abner via groups.io
2024-05-07  2:50     ` [edk2-devel] 回复: " gaoliming via groups.io
2024-05-01 19:05 ` [edk2-devel] [PATCH v1 4/6] MdeModulePkg:BaseSpiHcPlatformLib: Adding NULL lib instance Chesley, Brit via groups.io
2024-05-02  4:25   ` Chang, Abner via groups.io
2024-05-06 11:08   ` Chang, Abner via groups.io
2024-05-07  2:50     ` [edk2-devel] 回复: " gaoliming via groups.io
2024-05-01 19:05 ` [edk2-devel] [PATCH v1 5/6] MdeModulePkg: SpiHc: SpiHc Drivers Chesley, Brit via groups.io
2024-05-02  4:25   ` Chang, Abner via groups.io [this message]
2024-05-01 19:05 ` [edk2-devel] [PATCH v1 6/6] MdeModulePkg: Adding " Chesley, Brit via groups.io
2024-05-02  4:25   ` Chang, Abner via groups.io
2024-05-06 11:08   ` Chang, Abner via groups.io
2024-05-07  2:51     ` [edk2-devel] 回复: " gaoliming via groups.io

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-list from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=LV8PR12MB9452BCE1EC93CB6CBEBA571CEA182@LV8PR12MB9452.namprd12.prod.outlook.com \
    --to=devel@edk2.groups.io \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox