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
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
|
/** @file
Copyright (c) 2018, 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 that 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.
**/
#ifndef _PCH_CYCLE_DECODING_LIB_H_
#define _PCH_CYCLE_DECODING_LIB_H_
/**
Set PCH ACPI base address.
The Address should not be 0 and should be 256 bytes alignment, and it is IO space, so must not exceed 0xFFFF.
This cycle decoding is allowed to set when DMIC.SRL is 0.
Programming steps:
1. clear PMC PCI offset 44h [7] to diable ACPI base address first before changing base address.
2. program PMC PCI offset 40h [15:2] to ACPI base address.
3. set PMC PCI offset 44h [7] to enable ACPI base address.
4. program "ACPI Base Address" PCR[DMI] + 27B4h[23:18, 15:2, 0] to [0x3F, PMC PCI Offset 40h bit[15:2], 1].
5. Program "ACPI Base Destination ID" PCR[DMI] + 27B8h[31:0] to [0x23A0].
@param[in] Address Address for ACPI base address.
@retval EFI_SUCCESS Successfully completed.
@retval EFI_INVALID_PARAMETER Invalid base address passed.
**/
EFI_STATUS
EFIAPI
PchAcpiBaseSet (
IN UINT16 Address
);
/**
Get PCH ACPI base address.
@param[out] Address Address of ACPI base address.
@retval EFI_SUCCESS Successfully completed.
@retval EFI_INVALID_PARAMETER Invalid pointer passed.
**/
EFI_STATUS
EFIAPI
PchAcpiBaseGet (
OUT UINT16 *Address
);
/**
Set PCH PWRM base address.
This cycle decoding is allowed to set when DMIC.SRL is 0.
Programming steps:
1. clear PMC PCI offset 44h [8] to diable PWRM base address first before changing PWRM base address.
2. program PMC PCI offset 48h [31:16] to PM base address.
3. set PMC PCI offset 44h [8] to enable PWRM base address.
4. program "PM Base Address Memory Range Base" PCR[DMI] + 27ACh[15:0] to the same value programmed in PMC PCI Offset 48h bit[31:16], this has an implication of making sure the PWRMBASE to be 64KB aligned.
program "PM Base Address Memory Range Limit" PCR[DMI] + 27ACh[31:16] to the value programmed in PMC PCI Offset 48h bit[31:16], this has an implication of making sure the memory allocated to PWRMBASE to be 64KB in size.
5. program "PM Base Control" PCR[DMI] + 27B0h[31, 30:0] to [1, 0x23A0].
@param[in] Address Address for PWRM base address.
@retval EFI_SUCCESS Successfully completed.
@retval EFI_INVALID_PARAMETER Invalid base address passed.
**/
EFI_STATUS
EFIAPI
PchPwrmBaseSet (
IN UINT32 Address
);
/**
Get PCH PWRM base address.
@param[out] Address Address of PWRM base address.
@retval EFI_SUCCESS Successfully completed.
@retval EFI_INVALID_PARAMETER Invalid pointer passed.
**/
EFI_STATUS
EFIAPI
PchPwrmBaseGet (
OUT UINT32 *Address
);
/**
Set PCH TCO base address.
This cycle decoding is allowed to set when DMIC.SRL is 0.
Programming steps:
1. set Smbus PCI offset 54h [8] to enable TCO base address.
2. program Smbus PCI offset 50h [15:5] to TCO base address.
3. set Smbus PCI offset 54h [8] to enable TCO base address.
4. program "TCO Base Address" PCR[DMI] + 2778h[15:5, 1] to [Smbus PCI offset 50h[15:5], 1].
@param[in] Address Address for TCO base address.
@retval EFI_SUCCESS Successfully completed.
@retval EFI_INVALID_PARAMETER Invalid base address passed.
**/
EFI_STATUS
EFIAPI
PchTcoBaseSet (
IN UINT16 Address
);
/**
Get PCH TCO base address.
@param[out] Address Address of TCO base address.
@retval EFI_SUCCESS Successfully completed.
@retval EFI_INVALID_PARAMETER Invalid pointer passed.
**/
EFI_STATUS
EFIAPI
PchTcoBaseGet (
OUT UINT16 *Address
);
///
/// structure of LPC general IO range register
/// It contains base address, address mask, and enable status.
///
typedef struct {
UINT32 BaseAddr :16;
UINT32 Length :15;
UINT32 Enable : 1;
} PCH_LPC_GEN_IO_RANGE;
#define PCH_LPC_GEN_IO_RANGE_MAX 4
///
/// structure of LPC general IO range register list
/// It lists all LPC general IO ran registers supported by PCH.
///
typedef struct {
PCH_LPC_GEN_IO_RANGE Range[PCH_LPC_GEN_IO_RANGE_MAX];
} PCH_LPC_GEN_IO_RANGE_LIST;
/**
Set PCH LPC generic IO range.
For generic IO range, the base address must align to 4 and less than 0xFFFF, and the length must be power of 2
and less than or equal to 256. Moreover, the address must be length aligned.
This function basically checks the address and length, which should not overlap with all other generic ranges.
If no more generic range register available, it returns out of resource error.
This cycle decoding is allowed to set when DMIC.SRL is 0.
The IO ranges below 0x100 have fixed target. The target might be ITSS,RTC,LPC,PMC or terminated inside P2SB
but all predefined and can't be changed. IO range below 0x100 will be skipped except 0x80-0x8F.
Steps of programming generic IO range:
1. Program LPC/eSPI PCI Offset 84h ~ 93h of Mask, Address, and Enable.
2. Program LPC/eSPI Generic IO Range #, PCR[DMI] + 2730h ~ 273Fh to the same value programmed in LPC/eSPI PCI Offset 84h~93h.
@param[in] Address Address for generic IO range base address.
@param[in] Length Length of generic IO range.
@retval EFI_SUCCESS Successfully completed.
@retval EFI_INVALID_PARAMETER Invalid base address or length passed.
@retval EFI_OUT_OF_RESOURCES No more generic range available.
@retval EFI_UNSUPPORTED DMIC.SRL is set.
**/
EFI_STATUS
EFIAPI
PchLpcGenIoRangeSet (
IN UINT16 Address,
IN UINTN Length
, IN UINT8 SlaveDevice
);
/**
Get PCH LPC generic IO range list.
This function returns a list of base address, length, and enable for all LPC generic IO range regsiters.
@param[out] LpcGenIoRangeList Return all LPC generic IO range register status.
@retval EFI_SUCCESS Successfully completed.
@retval EFI_INVALID_PARAMETER Invalid base address passed.
**/
EFI_STATUS
EFIAPI
PchLpcGenIoRangeGet (
OUT PCH_LPC_GEN_IO_RANGE_LIST *LpcGenIoRangeList
, IN UINT8 SlaveDevice
);
/**
Set PCH LPC memory range decoding.
This cycle decoding is allowed to set when DMIC.SRL is 0.
Programming steps:
1. Program LPC/eSPI PCI 98h [0] to [0] to disable memory decoding first before changing base address.
2. Program LPC/eSPI PCI 98h [31:16, 0] to [Address, 1].
3. Program LPC/eSPI Memory Range, PCR[DMI] + 2740h to the same value programmed in LPC/eSPI PCI Offset 98h.
@param[in] Address Address for memory base address.
@retval EFI_SUCCESS Successfully completed.
@retval EFI_INVALID_PARAMETER Invalid base address or length passed.
@retval EFI_OUT_OF_RESOURCES No more generic range available.
**/
EFI_STATUS
EFIAPI
PchLpcMemRangeSet (
IN UINT32 Address
, IN UINT8 SlaveDevice
);
/**
Get PCH LPC memory range decoding address.
@param[out] Address Address of LPC memory decoding base address.
@retval EFI_SUCCESS Successfully completed.
@retval EFI_INVALID_PARAMETER Invalid base address passed.
**/
EFI_STATUS
EFIAPI
PchLpcMemRangeGet (
OUT UINT32 *Address
, IN UINT8 SlaveDevice
);
/**
Set PCH BIOS range deocding.
This will check General Control and Status bit 10 (GCS.BBS) to identify SPI or LPC/eSPI and program BDE register accordingly.
Please check EDS for detail of BiosDecodeEnable bit definition.
bit 15: F8-FF Enable
bit 14: F0-F8 Enable
bit 13: E8-EF Enable
bit 12: E0-E8 Enable
bit 11: D8-DF Enable
bit 10: D0-D7 Enable
bit 9: C8-CF Enable
bit 8: C0-C7 Enable
bit 7: Legacy F Segment Enable
bit 6: Legacy E Segment Enable
bit 5: Reserved
bit 4: Reserved
bit 3: 70-7F Enable
bit 2: 60-6F Enable
bit 1: 50-5F Enable
bit 0: 40-4F Enable
This cycle decoding is allowed to set when DMIC.SRL is 0.
Programming steps:
1. if GCS.BBS is 0 (SPI), program SPI PCI offset D8h to BiosDecodeEnable.
if GCS.BBS is 1 (LPC/eSPi), program LPC/eSPI PCI offset D8h to BiosDecodeEnable.
2. program LPC/eSPI/SPI BIOS Decode Enable, PCR[DMI] + 2744h to the same value programmed in LPC/eSPI or SPI PCI Offset D8h.
@param[in] BiosDecodeEnable Bios decode enable setting.
@retval EFI_SUCCESS Successfully completed.
**/
EFI_STATUS
EFIAPI
PchBiosDecodeEnableSet (
IN UINT16 BiosDecodeEnable
);
/**
Set PCH LPC IO decode ranges.
Program LPC I/O Decode Ranges, PCR[DMI] + 2770h[15:0] to the same value programmed in LPC offset 80h.
Please check EDS for detail of Lpc IO decode ranges bit definition.
Bit 12: FDD range
Bit 9:8: LPT range
Bit 6:4: ComB range
Bit 2:0: ComA range
@param[in] LpcIoDecodeRanges Lpc IO decode ranges bit settings.
@retval EFI_SUCCESS Successfully completed.
@retval EFI_UNSUPPORTED DMIC.SRL is set.
**/
EFI_STATUS
EFIAPI
PchLpcIoDecodeRangesSet (
IN UINT16 LpcIoDecodeRanges
);
/**
Set PCH LPC IO enable decoding.
Setup LPC I/O Enables, PCR[DMI] + 2774h[15:0] to the same value program in LPC offset 82h.
Note: Bit[15:10] of the source decode register is Read-Only. The IO range indicated by the Enables field
in LPC 82h[13:10] is always forwarded by DMI to subtractive agent for handling.
Please check EDS for detail of Lpc IO decode ranges bit definition.
@param[in] LpcIoEnableDecoding Lpc IO enable decoding bit settings.
@retval EFI_SUCCESS Successfully completed.
@retval EFI_UNSUPPORTED DMIC.SRL is set.
**/
EFI_STATUS
EFIAPI
PchLpcIoEnableDecodingSet (
IN UINT16 LpcIoEnableDecoding
, IN UINT8 SlaveDevice
);
/**
Set PCH IO port 80h cycle decoding to PCIE root port.
System BIOS is likely to do this very soon after reset before PCI bus enumeration, it must ensure that
the IO Base Address field (PCIe:1Ch[7:4]) contains a value greater than the IO Limit field (PCIe:1Ch[15:12])
before setting the IOSE bit. Otherwise the bridge will positively decode IO range 000h - FFFh by its default
IO range values.
This cycle decoding is allowed to set when DMIC.SRL is 0.
Programming steps:
1. Program "RPR Destination ID", PCR[DMI] + 274Ch[31:16] to the Dest ID of RP.
2. Program "Reserved Page Route", PCR[DMI] + 274Ch[11] to '1'. Use byte write on GCS+1 and leave the BILD bit which is RWO.
3. Program IOSE bit of PCIE:Reg04h[0] to '1' for PCH to send such IO cycles to PCIe bus for subtractive decoding.
@param[in] RpPhyNumber PCIE root port physical number.
@retval EFI_SUCCESS Successfully completed.
**/
EFI_STATUS
EFIAPI
PchIoPort80DecodeSet (
IN UINTN RpPhyNumber
);
/**
Get IO APIC regsiters base address.
It returns IO APIC INDEX, DATA, and EOI regsiter address once the parameter is not NULL.
This function will be unavailable after P2SB is hidden by PSF.
@param[out] IoApicIndex Buffer of IO APIC INDEX regsiter address
@param[out] IoApicData Buffer of IO APIC DATA regsiter address
@retval EFI_SUCCESS Successfully completed.
**/
EFI_STATUS
PchIoApicBaseGet (
OPTIONAL OUT UINT32 *IoApicIndex,
OPTIONAL OUT UINT32 *IoApicData
);
/**
Get HPET base address.
This function will be unavailable after P2SB is hidden by PSF.
@param[out] HpetBase Buffer of HPET base address
@retval EFI_SUCCESS Successfully completed.
@retval EFI_INVALID_PARAMETER Invalid offset passed.
**/
EFI_STATUS
PchHpetBaseGet (
OUT UINT32 *HpetBase
);
#endif // _PCH_CYCLE_DECODING_LIB_H_
|