summaryrefslogtreecommitdiff
path: root/ReferenceCode/ME/Heci/Pei/HeciInit.c
blob: 0375bd76cd30d340d432c7d529d6f2731992dcaa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
/** @file
  Framework PEIM to HECI.

@copyright
  Copyright (c) 2008 - 2012 Intel Corporation. All rights reserved
  This software and associated documentation (if any) is furnished
  under a license and may only be used or copied in accordance
  with the terms of the license. Except as permitted by such
  license, no part of this software or documentation may be
  reproduced, stored in a retrieval system, or transmitted in any
  form or by any means without the express written consent of
  Intel Corporation.

  This file contains an 'Intel Peripheral Driver' and uniquely
  identified as "Intel Reference Module" and is
  licensed for Intel CPUs and chipsets under the terms of your
  license agreement with Intel or your vendor.  This file may
  be modified by the user, subject to additional terms of the
  license agreement
**/

//
// External include files do NOT need to be explicitly specified in real EDKII
// environment
//
#if !defined(EDK_RELEASE_VERSION) || (EDK_RELEASE_VERSION < 0x00020000)
//
// Statements that include other files
//
#include "HeciInit.h"
#endif
//
// Function Declarations
//
static PEI_HECI_PPI           mHeciPpi = {
  HeciSendwAck,
  HeciReadMsg,
  HeciSendMsg,
  InitializeHeci,
  HeciGetMeStatus,
  HeciGetMeMode
};

static EFI_PEI_PPI_DESCRIPTOR mInstallHeciPpi = {
  EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST,
  &gPeiHeciPpiGuid,
  &mHeciPpi
};

//
// Function Implementations
//

/**
  Internal function performing Heci platform PPIs init needed in PEI phase

  @param[in] PeiServices          General purpose services available to every PEIM.

  @retval EFI_SUCCESS             The function completed successfully.
  @retval EFI_DEVICE_ERROR        ME FPT is bad
**/
EFI_STATUS
EFIAPI
PeiInstallHeciPpi (
  IN EFI_PEI_SERVICES             **PeiServices
  )
{
  EFI_STATUS  Status;

  ///
  /// Check for ME FPT Bad
  ///
  if ((HeciPciRead32 (R_FWSTATE) & 0x0020) != 0) {

    return EFI_DEVICE_ERROR;
  }
  ///
  /// Initialize Heci platform PPIs
  /// Do not use EdkIIGlueLib here because PeiService pointer used in GlueLib
  /// is not updated after memory installed.
  ///
  Status = (**PeiServices).InstallPpi (PeiServices, &mInstallHeciPpi);
  ASSERT_EFI_ERROR (Status);

  DEBUG ((EFI_D_ERROR, "Install Heci Ppi Complete.\n"));
  return Status;
}

/**
  Internal function performing PM register initialization for Me

  @param[in] PeiServices          General purpose services available to every PEIM.

  @retval EFI_SUCCESS             Always return EFI_SUCCESS
**/
EFI_STATUS
EFIAPI
MePmInit (
  IN EFI_PEI_SERVICES             **PeiServices
  )
{
  UINT16  PmBase;
  UINT16  Pm1Cnt;

  ///
  /// Before system memory initialization, BIOS should check the WAK_STS bit in PM1_STS[15] (PCH register PMBASE+00h)
  /// to determine if Intel Management Engine has reset the system while the host was in a sleep state. If WAK_STS is
  /// not set, BIOS should ensure a non-sleep exit path is taken. One way to accomplish this is by overwriting
  /// PM1_CNT[12:10] (PCH register PMBASE+04h) to 111b to force an S5 exit path by the BIOS.
  ///
  PmBase = PciRead16 (
            PCI_LIB_ADDRESS (DEFAULT_PCI_BUS_NUMBER_PCH,
            PCI_DEVICE_NUMBER_PCH_LPC,
            0,
            R_PCH_LPC_ACPI_BASE)
            ) & B_PCH_LPC_ACPI_BASE_BAR;

  ASSERT (PmBase != 0);

  if (PmBase != 0) {
    if ((IoRead16 (PmBase + R_PCH_ACPI_PM1_STS) & B_PCH_ACPI_PM1_STS_WAK) == 0) {
      Pm1Cnt = IoRead16 (PmBase + R_PCH_ACPI_PM1_CNT) | V_PCH_ACPI_PM1_CNT_S5;
      IoWrite16 (PmBase + R_PCH_ACPI_PM1_CNT, Pm1Cnt);
      DEBUG ((EFI_D_ERROR, "Force an S5 exit path.\n"));
    }
  }

  return EFI_SUCCESS;
}

/**
  Internal function performing Me initialization.

  @param[in] PeiServices          General purpose services available to every PEIM.

  @retval EFI_SUCCESS             Heci initialization completed successfully.
  @retval All other error conditions encountered result in an ASSERT.
**/
EFI_STATUS
EFIAPI
MeInit (
  IN EFI_PEI_SERVICES             **PeiServices
  )
{
  EFI_STATUS  Status;

  Status = MePmInit (PeiServices);
  return Status;
}

/**
  Initialize ME after reset

  @param[in] FfsHeader            Not used.
  @param[in] PeiServices          General purpose services available to every PEIM.

  @retval EFI_SUCCESS             Heci initialization completed successfully.
  @retval All other error conditions encountered result in an ASSERT.
**/
EFI_STATUS
PeimHeciInit (
  IN EFI_FFS_FILE_HEADER          *FfsHeader,
  IN EFI_PEI_SERVICES             **PeiServices
  )
{
  EFI_STATUS  Status;

  ///
  /// Performing Me initialization
  ///
  Status = MeInit (PeiServices);
  ASSERT_EFI_ERROR (Status);

  Status = PeiInstallHeciPpi (PeiServices);
  if (EFI_ERROR (Status)) {
    DEBUG ((EFI_D_ERROR, "(ICC) Failed to PeiInstallHeciPpi! Status = %r\n", Status));
  } else {
    DEBUG ((EFI_D_INFO, "HeciInit Complete.\n"));
  }

  return Status;
}