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
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
|
/** @file
This code supports a the private implementation
of the Legacy Interrupt protocol
@copyright
Copyright (c) 1999 - 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
**/
#include "LegacyInterrupt.h"
///
/// Handle for the Legacy Interrupt Protocol instance produced by this driver
///
EFI_HANDLE mLegacyInterruptHandle = NULL;
///
/// The Legacy Interrupt Protocol instance produced by this driver
///
EFI_LEGACY_INTERRUPT_PROTOCOL mLegacyInterrupt = {
GetNumberPirqs,
GetLocation,
ReadPirq,
WritePirq
};
///
/// Module Global:
/// Since this driver will only ever produce one instance of the Private Data
/// protocol you are not required to dynamically allocate the PrivateData.
///
UINT8 PirqReg[MAX_PIRQ_NUMBER] = { PIRQA, PIRQB, PIRQC, PIRQD, PIRQE, PIRQF, PIRQG, PIRQH };
/**
Return the number of PIRQs supported by this chipset.
@param[in] This Pointer to LegacyInterrupt Protocol
@param[out] NumberPirqs The pointer which point to the max IRQ number supported by this PCH.
@retval EFI_SUCCESS Legacy BIOS protocol installed
**/
EFI_STATUS
EFIAPI
GetNumberPirqs (
IN EFI_LEGACY_INTERRUPT_PROTOCOL *This,
OUT UINT8 *NumberPirqs
)
{
*NumberPirqs = MAX_PIRQ_NUMBER;
return EFI_SUCCESS;
}
/**
Return PCI location of this device. $PIR table requires this info.
@param[in] This Protocol instance pointer.
@param[out] Bus PCI Bus
@param[out] Device PCI Device
@param[out] Function PCI Function
@retval EFI_SUCCESS Bus/Device/Function returned
**/
EFI_STATUS
EFIAPI
GetLocation (
IN EFI_LEGACY_INTERRUPT_PROTOCOL *This,
OUT UINT8 *Bus,
OUT UINT8 *Device,
OUT UINT8 *Function
)
{
*Bus = DEFAULT_PCI_BUS_NUMBER_PCH;
*Device = PCI_DEVICE_NUMBER_PCH_LPC;
*Function = PCI_FUNCTION_NUMBER_PCH_LPC;
return EFI_SUCCESS;
}
/**
Builds the PCIE configuration address for the register specified by PirqNumber
@param[in] PirqNumber The PIRQ number to build the PCIE configuration address for
@retval UINTN The PCIE Configuration address for interrupt controller in PCH
**/
UINTN
GetAddress (
UINT8 PirqNumber
)
{
return MmPciAddress (
0,
DEFAULT_PCI_BUS_NUMBER_PCH,
PCI_DEVICE_NUMBER_PCH_LPC,
PCI_FUNCTION_NUMBER_PCH_LPC,
PirqReg[PirqNumber]
);
}
/**
Read the given PIRQ register
@param[in] This Pointer to LegacyInterrupt Protocol
@param[in] PirqNumber The Pirq register 0 = A, 1 = B etc
@param[out] PirqData Value read
@retval EFI_SUCCESS Decoding change affected.
@retval EFI_INVALID_PARAMETER Invalid PIRQ number
**/
EFI_STATUS
EFIAPI
ReadPirq (
IN EFI_LEGACY_INTERRUPT_PROTOCOL *This,
IN UINT8 PirqNumber,
OUT UINT8 *PirqData
)
{
if (PirqNumber >= MAX_PIRQ_NUMBER) {
return EFI_INVALID_PARAMETER;
}
*PirqData = MmioRead8 (GetAddress (PirqNumber));
*PirqData = (UINT8) (*PirqData & 0x7f);
return EFI_SUCCESS;
}
/**
Read the given PIRQ register
@param[in] This Pointer to LegacyInterrupt Protocol
@param[in] PirqNumber The Pirq register 0 = A, 1 = B etc
@param[in] PirqData Value read
@retval EFI_SUCCESS Decoding change affected.
@retval EFI_INVALID_PARAMETER Invalid PIRQ number
**/
EFI_STATUS
EFIAPI
WritePirq (
IN EFI_LEGACY_INTERRUPT_PROTOCOL *This,
IN UINT8 PirqNumber,
IN UINT8 PirqData
)
{
if (PirqNumber >= MAX_PIRQ_NUMBER) {
return EFI_INVALID_PARAMETER;
}
MmioWrite8 (GetAddress (PirqNumber), PirqData);
return EFI_SUCCESS;
}
/**
Install Driver to produce Legacy Interrupt protocol.
@param[in] ImageHandle Handle for this drivers loaded image protocol.
@param[in] SystemTable EFI system table.
@retval EFI_SUCCESS Legacy Interrupt protocol installed
@retval Other No protocol installed, unload driver.
**/
EFI_STATUS
LegacyInterruptInstall (
IN EFI_HANDLE ImageHandle,
IN EFI_SYSTEM_TABLE *SystemTable
)
{
EFI_STATUS Status;
DEBUG ((EFI_D_INFO, "LegacyInterruptInstall() Start\n"));
///
/// Make sure the Legacy Interrupt Protocol is not already installed in the system
///
ASSERT_PROTOCOL_ALREADY_INSTALLED (NULL, &gEfiLegacyInterruptProtocolGuid);
///
/// Make a new handle and install the protocol
///
Status = gBS->InstallMultipleProtocolInterfaces (
&mLegacyInterruptHandle,
&gEfiLegacyInterruptProtocolGuid,
&mLegacyInterrupt,
NULL
);
ASSERT_EFI_ERROR (Status);
DEBUG ((EFI_D_INFO, "LegacyInterruptInstall() End\n"));
return Status;
}
|