CorebootPayloadPkg/Library/PlatformHookLib/PlatformHookLib.c

   1 /** @file
   2   Platform Hook Library instance for UART device upon coreboot.
   3
   4   Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
   5   This program and the accompanying materials
   6   are licensed and made available under the terms and conditions of the BSD License
   7   which accompanies this distribution.  The full text of the license may be found at
   8   http://opensource.org/licenses/bsd-license.php
   9
  10   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  11   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  12
  13 **/
  14
  15 #include <Base.h>
  16 #include <Uefi/UefiBaseType.h>
  17 #include <Library/PciLib.h>
  18 #include <Library/PlatformHookLib.h>
  19 #include <Library/CbParseLib.h>
  20 #include <Library/PcdLib.h>
  21
  22 typedef struct {
  23   UINT16  VendorId;          ///< Vendor ID to match the PCI device.  The value 0xFFFF terminates the list of entries.
  24   UINT16  DeviceId;          ///< Device ID to match the PCI device
  25   UINT32  ClockRate;         ///< UART clock rate.  Set to 0 for default clock rate of 1843200 Hz
  26   UINT64  Offset;            ///< The byte offset into to the BAR
  27   UINT8   BarIndex;          ///< Which BAR to get the UART base address
  28   UINT8   RegisterStride;    ///< UART register stride in bytes.  Set to 0 for default register stride of 1 byte.
  29   UINT16  ReceiveFifoDepth;  ///< UART receive FIFO depth in bytes. Set to 0 for a default FIFO depth of 16 bytes.
  30   UINT16  TransmitFifoDepth; ///< UART transmit FIFO depth in bytes. Set to 0 for a default FIFO depth of 16 bytes.
  31   UINT8   Reserved[2];
  32 } PCI_SERIAL_PARAMETER;
  33
  34 /**
  35   Performs platform specific initialization required for the CPU to access
  36   the hardware associated with a SerialPortLib instance.  This function does
  37   not intiailzie the serial port hardware itself.  Instead, it initializes
  38   hardware devices that are required for the CPU to access the serial port
  39   hardware.  This function may be called more than once.
  40
  41   @retval RETURN_SUCCESS       The platform specific initialization succeeded.
  42   @retval RETURN_DEVICE_ERROR  The platform specific initialization could not be completed.
  43
  44 **/
  45 RETURN_STATUS
  46 EFIAPI
  47 PlatformHookSerialPortInitialize (
  48   VOID
  49   )
  50 {
  51   RETURN_STATUS     Status;
  52   UINT32            SerialRegBase;
  53   UINT32            SerialRegAccessType;
  54   UINT32            BaudRate;
  55   UINT32            RegWidth;
  56   UINT32            InputHertz;
  57   UINT32            PayloadParam;
  58   UINT32            DeviceVendor;
  59   PCI_SERIAL_PARAMETER *SerialParam;
  60
  61   Status = CbParseSerialInfo (&SerialRegBase, &SerialRegAccessType,
  62                               &RegWidth, &BaudRate, &InputHertz,
  63                               &PayloadParam);
  64   if (RETURN_ERROR (Status)) {
  65     return Status;
  66   }
  67
  68   if (SerialRegAccessType == 2) { //MMIO
  69     Status = PcdSetBoolS (PcdSerialUseMmio, TRUE);
  70   } else { //IO
  71     Status = PcdSetBoolS (PcdSerialUseMmio, FALSE);
  72   }
  73   if (RETURN_ERROR (Status)) {
  74     return Status;
  75   }
  76   Status = PcdSet64S (PcdSerialRegisterBase, (UINT64) SerialRegBase);
  77   if (RETURN_ERROR (Status)) {
  78     return Status;
  79   }
  80
  81   Status = PcdSet32S (PcdSerialRegisterStride, RegWidth);
  82   if (RETURN_ERROR (Status)) {
  83     return Status;
  84   }
  85
  86   Status = PcdSet32S (PcdSerialBaudRate, BaudRate);
  87   if (RETURN_ERROR (Status)) {
  88     return Status;
  89   }
  90
  91   Status = PcdSet64S (PcdUartDefaultBaudRate, BaudRate);
  92   if (RETURN_ERROR (Status)) {
  93     return Status;
  94   }
  95
  96   Status = PcdSet32S (PcdSerialClockRate, InputHertz);
  97   if (RETURN_ERROR (Status)) {
  98     return Status;
  99   }
 100
 101   if (PayloadParam >= 0x80000000) {
 102     DeviceVendor = PciRead32 (PayloadParam & 0x0ffff000);
 103     SerialParam = PcdGetPtr(PcdPciSerialParameters);
 104     SerialParam->VendorId = (UINT16)DeviceVendor;
 105     SerialParam->DeviceId = DeviceVendor >> 16;
 106     SerialParam->ClockRate = InputHertz;
 107     SerialParam->RegisterStride = (UINT8)RegWidth;
 108   }
 109
 110   return RETURN_SUCCESS;
 111 }