]>
Commit | Line | Data |
---|---|---|
c5bd6537 BM |
1 | /****************************************************************************** |
2 | * | |
3 | * Name: actbl3.h - ACPI Table Definitions | |
4 | * | |
5 | *****************************************************************************/ | |
6 | ||
7 | /* | |
8 | * Copyright (C) 2000 - 2011, Intel Corp. | |
9 | * All rights reserved. | |
10 | * | |
11 | * Redistribution and use in source and binary forms, with or without | |
12 | * modification, are permitted provided that the following conditions | |
13 | * are met: | |
14 | * 1. Redistributions of source code must retain the above copyright | |
15 | * notice, this list of conditions, and the following disclaimer, | |
16 | * without modification. | |
17 | * 2. Redistributions in binary form must reproduce at minimum a disclaimer | |
18 | * substantially similar to the "NO WARRANTY" disclaimer below | |
19 | * ("Disclaimer") and any redistribution must be conditioned upon | |
20 | * including a substantially similar Disclaimer requirement for further | |
21 | * binary redistribution. | |
22 | * 3. Neither the names of the above-listed copyright holders nor the names | |
23 | * of any contributors may be used to endorse or promote products derived | |
24 | * from this software without specific prior written permission. | |
25 | * | |
26 | * Alternatively, this software may be distributed under the terms of the | |
27 | * GNU General Public License ("GPL") version 2 as published by the Free | |
28 | * Software Foundation. | |
29 | * | |
30 | * NO WARRANTY | |
31 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | |
32 | * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | |
33 | * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR | |
34 | * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | |
35 | * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
36 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
37 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
38 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, | |
39 | * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING | |
40 | * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | |
41 | * POSSIBILITY OF SUCH DAMAGES. | |
42 | */ | |
43 | ||
44 | #ifndef __ACTBL3_H__ | |
45 | #define __ACTBL3_H__ | |
46 | ||
47 | /******************************************************************************* | |
48 | * | |
49 | * Additional ACPI Tables (3) | |
50 | * | |
51 | * These tables are not consumed directly by the ACPICA subsystem, but are | |
52 | * included here to support device drivers and the AML disassembler. | |
53 | * | |
54 | * The tables in this file are fully defined within the ACPI specification. | |
55 | * | |
56 | ******************************************************************************/ | |
57 | ||
58 | /* | |
59 | * Values for description table header signatures for tables defined in this | |
60 | * file. Useful because they make it more difficult to inadvertently type in | |
61 | * the wrong signature. | |
62 | */ | |
63 | #define ACPI_SIG_BGRT "BGRT" /* Boot Graphics Resource Table */ | |
64 | #define ACPI_SIG_DRTM "DRTM" /* Dynamic Root of Trust for Measurement table */ | |
65 | #define ACPI_SIG_FPDT "FPDT" /* Firmware Performance Data Table */ | |
66 | #define ACPI_SIG_GTDT "GTDT" /* Generic Timer Description Table */ | |
67 | #define ACPI_SIG_MPST "MPST" /* Memory Power State Table */ | |
68 | #define ACPI_SIG_PCCT "PCCT" /* Platform Communications Channel Table */ | |
69 | #define ACPI_SIG_PMTT "PMTT" /* Platform Memory Topology Table */ | |
70 | #define ACPI_SIG_RASF "RASF" /* RAS Feature table */ | |
71 | ||
72 | #define ACPI_SIG_S3PT "S3PT" /* S3 Performance (sub)Table */ | |
73 | #define ACPI_SIG_PCCS "PCC" /* PCC Shared Memory Region */ | |
74 | ||
75 | /* Reserved table signatures */ | |
76 | ||
77 | #define ACPI_SIG_CSRT "CSRT" /* Core System Resources Table */ | |
78 | #define ACPI_SIG_DBG2 "DBG2" /* Debug Port table 2 */ | |
79 | #define ACPI_SIG_MATR "MATR" /* Memory Address Translation Table */ | |
80 | #define ACPI_SIG_MSDM "MSDM" /* Microsoft Data Management Table */ | |
81 | #define ACPI_SIG_WPBT "WPBT" /* Windows Platform Binary Table */ | |
82 | ||
83 | /* | |
84 | * All tables must be byte-packed to match the ACPI specification, since | |
85 | * the tables are provided by the system BIOS. | |
86 | */ | |
87 | #pragma pack(1) | |
88 | ||
89 | /* | |
90 | * Note about bitfields: The u8 type is used for bitfields in ACPI tables. | |
91 | * This is the only type that is even remotely portable. Anything else is not | |
92 | * portable, so do not use any other bitfield types. | |
93 | */ | |
94 | ||
95 | /******************************************************************************* | |
96 | * | |
97 | * BGRT - Boot Graphics Resource Table (ACPI 5.0) | |
98 | * Version 1 | |
99 | * | |
100 | ******************************************************************************/ | |
101 | ||
102 | struct acpi_table_bgrt { | |
103 | struct acpi_table_header header; /* Common ACPI table header */ | |
104 | u16 version; | |
105 | u8 status; | |
106 | u8 image_type; | |
107 | u64 image_address; | |
108 | u32 image_offset_x; | |
109 | u32 image_offset_y; | |
110 | }; | |
111 | ||
112 | /******************************************************************************* | |
113 | * | |
114 | * DRTM - Dynamic Root of Trust for Measurement table | |
115 | * | |
116 | ******************************************************************************/ | |
117 | ||
118 | struct acpi_table_drtm { | |
119 | struct acpi_table_header header; /* Common ACPI table header */ | |
120 | u64 entry_base_address; | |
121 | u64 entry_length; | |
122 | u32 entry_address32; | |
123 | u64 entry_address64; | |
124 | u64 exit_address; | |
125 | u64 log_area_address; | |
126 | u32 log_area_length; | |
127 | u64 arch_dependent_address; | |
128 | u32 flags; | |
129 | }; | |
130 | ||
131 | /* 1) Validated Tables List */ | |
132 | ||
133 | struct acpi_drtm_vtl_list { | |
134 | u32 validated_table_list_count; | |
135 | }; | |
136 | ||
137 | /* 2) Resources List */ | |
138 | ||
139 | struct acpi_drtm_resource_list { | |
140 | u32 resource_list_count; | |
141 | }; | |
142 | ||
143 | /* 3) Platform-specific Identifiers List */ | |
144 | ||
145 | struct acpi_drtm_id_list { | |
146 | u32 id_list_count; | |
147 | }; | |
148 | ||
149 | /******************************************************************************* | |
150 | * | |
151 | * FPDT - Firmware Performance Data Table (ACPI 5.0) | |
152 | * Version 1 | |
153 | * | |
154 | ******************************************************************************/ | |
155 | ||
156 | struct acpi_table_fpdt { | |
157 | struct acpi_table_header header; /* Common ACPI table header */ | |
158 | }; | |
159 | ||
160 | /* FPDT subtable header */ | |
161 | ||
162 | struct acpi_fpdt_header { | |
163 | u16 type; | |
164 | u8 length; | |
165 | u8 revision; | |
166 | }; | |
167 | ||
168 | /* Values for Type field above */ | |
169 | ||
170 | enum acpi_fpdt_type { | |
171 | ACPI_FPDT_TYPE_BOOT = 0, | |
172 | ACPI_FPDT_TYPE_S3PERF = 1, | |
173 | }; | |
174 | ||
175 | /* | |
176 | * FPDT subtables | |
177 | */ | |
178 | ||
179 | /* 0: Firmware Basic Boot Performance Record */ | |
180 | ||
181 | struct acpi_fpdt_boot { | |
182 | struct acpi_fpdt_header header; | |
183 | u8 reserved[4]; | |
184 | u64 reset_end; | |
185 | u64 load_start; | |
186 | u64 startup_start; | |
187 | u64 exit_services_entry; | |
188 | u64 exit_services_exit; | |
189 | }; | |
190 | ||
191 | /* 1: S3 Performance Table Pointer Record */ | |
192 | ||
193 | struct acpi_fpdt_s3pt_ptr { | |
194 | struct acpi_fpdt_header header; | |
195 | u8 reserved[4]; | |
196 | u64 address; | |
197 | }; | |
198 | ||
199 | /* | |
200 | * S3PT - S3 Performance Table. This table is pointed to by the | |
201 | * FPDT S3 Pointer Record above. | |
202 | */ | |
203 | struct acpi_table_s3pt { | |
204 | u8 signature[4]; /* "S3PT" */ | |
205 | u32 length; | |
206 | }; | |
207 | ||
208 | /* | |
209 | * S3PT Subtables | |
210 | */ | |
211 | struct acpi_s3pt_header { | |
212 | u16 type; | |
213 | u8 length; | |
214 | u8 revision; | |
215 | }; | |
216 | ||
217 | /* Values for Type field above */ | |
218 | ||
219 | enum acpi_s3pt_type { | |
220 | ACPI_S3PT_TYPE_RESUME = 0, | |
221 | ACPI_S3PT_TYPE_SUSPEND = 1, | |
222 | }; | |
223 | ||
224 | struct acpi_s3pt_resume { | |
225 | struct acpi_s3pt_header header; | |
226 | u32 resume_count; | |
227 | u64 full_resume; | |
228 | u64 average_resume; | |
229 | }; | |
230 | ||
231 | struct acpi_s3pt_suspend { | |
232 | struct acpi_s3pt_header header; | |
233 | u64 suspend_start; | |
234 | u64 suspend_end; | |
235 | }; | |
236 | ||
237 | /******************************************************************************* | |
238 | * | |
239 | * GTDT - Generic Timer Description Table (ACPI 5.0) | |
240 | * Version 1 | |
241 | * | |
242 | ******************************************************************************/ | |
243 | ||
244 | struct acpi_table_gtdt { | |
245 | struct acpi_table_header header; /* Common ACPI table header */ | |
246 | u64 address; | |
247 | u32 flags; | |
248 | u32 secure_pl1_interrupt; | |
249 | u32 secure_pl1_flags; | |
250 | u32 non_secure_pl1_interrupt; | |
251 | u32 non_secure_pl1_flags; | |
252 | u32 virtual_timer_interrupt; | |
253 | u32 virtual_timer_flags; | |
254 | u32 non_secure_pl2_interrupt; | |
255 | u32 non_secure_pl2_flags; | |
256 | }; | |
257 | ||
258 | /* Values for Flags field above */ | |
259 | ||
260 | #define ACPI_GTDT_MAPPED_BLOCK_PRESENT 1 | |
261 | ||
262 | /* Values for all "TimerFlags" fields above */ | |
263 | ||
264 | #define ACPI_GTDT_INTERRUPT_MODE 1 | |
265 | #define ACPI_GTDT_INTERRUPT_POLARITY 2 | |
266 | ||
267 | /******************************************************************************* | |
268 | * | |
269 | * MPST - Memory Power State Table (ACPI 5.0) | |
270 | * Version 1 | |
271 | * | |
272 | ******************************************************************************/ | |
273 | ||
274 | #define ACPI_MPST_CHANNEL_INFO \ | |
275 | u16 reserved1; \ | |
276 | u8 channel_id; \ | |
277 | u8 reserved2; \ | |
278 | u16 power_node_count; | |
279 | ||
280 | /* Main table */ | |
281 | ||
282 | struct acpi_table_mpst { | |
283 | struct acpi_table_header header; /* Common ACPI table header */ | |
284 | ACPI_MPST_CHANNEL_INFO /* Platform Communication Channel */ | |
285 | }; | |
286 | ||
287 | /* Memory Platform Communication Channel Info */ | |
288 | ||
289 | struct acpi_mpst_channel { | |
290 | ACPI_MPST_CHANNEL_INFO /* Platform Communication Channel */ | |
291 | }; | |
292 | ||
293 | /* Memory Power Node Structure */ | |
294 | ||
295 | struct acpi_mpst_power_node { | |
296 | u8 flags; | |
297 | u8 reserved1; | |
298 | u16 node_id; | |
299 | u32 length; | |
300 | u64 range_address; | |
301 | u64 range_length; | |
302 | u8 num_power_states; | |
303 | u8 num_physical_components; | |
304 | u16 reserved2; | |
305 | }; | |
306 | ||
307 | /* Values for Flags field above */ | |
308 | ||
309 | #define ACPI_MPST_ENABLED 1 | |
310 | #define ACPI_MPST_POWER_MANAGED 2 | |
311 | #define ACPI_MPST_HOT_PLUG_CAPABLE 4 | |
312 | ||
313 | /* Memory Power State Structure (follows POWER_NODE above) */ | |
314 | ||
315 | struct acpi_mpst_power_state { | |
316 | u8 power_state; | |
317 | u8 info_index; | |
318 | }; | |
319 | ||
320 | /* Physical Component ID Structure (follows POWER_STATE above) */ | |
321 | ||
322 | struct acpi_mpst_component { | |
323 | u16 component_id; | |
324 | }; | |
325 | ||
326 | /* Memory Power State Characteristics Structure (follows all POWER_NODEs) */ | |
327 | ||
328 | struct acpi_mpst_data_hdr { | |
329 | u16 characteristics_count; | |
330 | }; | |
331 | ||
332 | struct acpi_mpst_power_data { | |
333 | u8 revision; | |
334 | u8 flags; | |
335 | u16 reserved1; | |
336 | u32 average_power; | |
337 | u32 power_saving; | |
338 | u64 exit_latency; | |
339 | u64 reserved2; | |
340 | }; | |
341 | ||
342 | /* Values for Flags field above */ | |
343 | ||
344 | #define ACPI_MPST_PRESERVE 1 | |
345 | #define ACPI_MPST_AUTOENTRY 2 | |
346 | #define ACPI_MPST_AUTOEXIT 4 | |
347 | ||
348 | /* Shared Memory Region (not part of an ACPI table) */ | |
349 | ||
350 | struct acpi_mpst_shared { | |
351 | u32 signature; | |
352 | u16 pcc_command; | |
353 | u16 pcc_status; | |
354 | u16 command_register; | |
355 | u16 status_register; | |
356 | u16 power_state_id; | |
357 | u16 power_node_id; | |
358 | u64 energy_consumed; | |
359 | u64 average_power; | |
360 | }; | |
361 | ||
362 | /******************************************************************************* | |
363 | * | |
364 | * PCCT - Platform Communications Channel Table (ACPI 5.0) | |
365 | * Version 1 | |
366 | * | |
367 | ******************************************************************************/ | |
368 | ||
369 | struct acpi_table_pcct { | |
370 | struct acpi_table_header header; /* Common ACPI table header */ | |
371 | u32 flags; | |
372 | u32 latency; | |
373 | u32 reserved; | |
374 | }; | |
375 | ||
376 | /* Values for Flags field above */ | |
377 | ||
378 | #define ACPI_PCCT_DOORBELL 1 | |
379 | ||
380 | /* | |
381 | * PCCT subtables | |
382 | */ | |
383 | ||
384 | /* 0: Generic Communications Subspace */ | |
385 | ||
386 | struct acpi_pcct_subspace { | |
387 | struct acpi_subtable_header header; | |
388 | u8 reserved[6]; | |
389 | u64 base_address; | |
390 | u64 length; | |
391 | struct acpi_generic_address doorbell_register; | |
392 | u64 preserve_mask; | |
393 | u64 write_mask; | |
394 | }; | |
395 | ||
396 | /* | |
397 | * PCC memory structures (not part of the ACPI table) | |
398 | */ | |
399 | ||
400 | /* Shared Memory Region */ | |
401 | ||
402 | struct acpi_pcct_shared_memory { | |
403 | u32 signature; | |
404 | u16 command; | |
405 | u16 status; | |
406 | }; | |
407 | ||
408 | /******************************************************************************* | |
409 | * | |
410 | * PMTT - Platform Memory Topology Table (ACPI 5.0) | |
411 | * Version 1 | |
412 | * | |
413 | ******************************************************************************/ | |
414 | ||
415 | struct acpi_table_pmtt { | |
416 | struct acpi_table_header header; /* Common ACPI table header */ | |
417 | u32 reserved; | |
418 | }; | |
419 | ||
420 | /* Common header for PMTT subtables that follow main table */ | |
421 | ||
422 | struct acpi_pmtt_header { | |
423 | u8 type; | |
424 | u8 reserved1; | |
425 | u16 length; | |
426 | u16 flags; | |
427 | u16 reserved2; | |
428 | }; | |
429 | ||
430 | /* Values for Type field above */ | |
431 | ||
432 | #define ACPI_PMTT_TYPE_SOCKET 0 | |
433 | #define ACPI_PMTT_TYPE_CONTROLLER 1 | |
434 | #define ACPI_PMTT_TYPE_DIMM 2 | |
435 | #define ACPI_PMTT_TYPE_RESERVED 3 /* 0x03-0xFF are reserved */ | |
436 | ||
437 | /* Values for Flags field above */ | |
438 | ||
439 | #define ACPI_PMTT_TOP_LEVEL 0x0001 | |
440 | #define ACPI_PMTT_PHYSICAL 0x0002 | |
441 | #define ACPI_PMTT_MEMORY_TYPE 0x000C | |
442 | ||
443 | /* | |
444 | * PMTT subtables, correspond to Type in struct acpi_pmtt_header | |
445 | */ | |
446 | ||
447 | /* 0: Socket Structure */ | |
448 | ||
449 | struct acpi_pmtt_socket { | |
450 | struct acpi_pmtt_header header; | |
451 | u16 socket_id; | |
452 | u16 reserved; | |
453 | }; | |
454 | ||
455 | /* 1: Memory Controller subtable */ | |
456 | ||
457 | struct acpi_pmtt_controller { | |
458 | struct acpi_pmtt_header header; | |
459 | u32 read_latency; | |
460 | u32 write_latency; | |
461 | u32 read_bandwidth; | |
462 | u32 write_bandwidth; | |
463 | u16 access_width; | |
464 | u16 alignment; | |
465 | u16 reserved; | |
466 | u16 domain_count; | |
467 | }; | |
468 | ||
469 | /* 1a: Proximity Domain substructure */ | |
470 | ||
471 | struct acpi_pmtt_domain { | |
472 | u32 proximity_domain; | |
473 | }; | |
474 | ||
475 | /* 2: Physical Component Identifier (DIMM) */ | |
476 | ||
477 | struct acpi_pmtt_physical_component { | |
478 | struct acpi_pmtt_header header; | |
479 | u16 component_id; | |
480 | u16 reserved; | |
481 | u32 memory_size; | |
482 | u32 bios_handle; | |
483 | }; | |
484 | ||
485 | /******************************************************************************* | |
486 | * | |
487 | * RASF - RAS Feature Table (ACPI 5.0) | |
488 | * Version 1 | |
489 | * | |
490 | ******************************************************************************/ | |
491 | ||
492 | struct acpi_table_rasf { | |
493 | struct acpi_table_header header; /* Common ACPI table header */ | |
494 | u8 channel_id[12]; | |
495 | }; | |
496 | ||
497 | /* RASF Platform Communication Channel Shared Memory Region */ | |
498 | ||
499 | struct acpi_rasf_shared_memory { | |
500 | u32 signature; | |
501 | u16 command; | |
502 | u16 status; | |
503 | u64 requested_address; | |
504 | u64 requested_length; | |
505 | u64 actual_address; | |
506 | u64 actual_length; | |
507 | u16 flags; | |
508 | u8 speed; | |
509 | }; | |
510 | ||
511 | /* Masks for Flags and Speed fields above */ | |
512 | ||
513 | #define ACPI_RASF_SCRUBBER_RUNNING 1 | |
514 | #define ACPI_RASF_SPEED (7<<1) | |
515 | ||
516 | /* Channel Commands */ | |
517 | ||
518 | enum acpi_rasf_commands { | |
519 | ACPI_RASF_GET_RAS_CAPABILITIES = 1, | |
520 | ACPI_RASF_GET_PATROL_PARAMETERS = 2, | |
521 | ACPI_RASF_START_PATROL_SCRUBBER = 3, | |
522 | ACPI_RASF_STOP_PATROL_SCRUBBER = 4 | |
523 | }; | |
524 | ||
525 | /* Channel Command flags */ | |
526 | ||
527 | #define ACPI_RASF_GENERATE_SCI (1<<15) | |
528 | ||
529 | /* Status values */ | |
530 | ||
531 | enum acpi_rasf_status { | |
532 | ACPI_RASF_SUCCESS = 0, | |
533 | ACPI_RASF_NOT_VALID = 1, | |
534 | ACPI_RASF_NOT_SUPPORTED = 2, | |
535 | ACPI_RASF_BUSY = 3, | |
536 | ACPI_RASF_FAILED = 4, | |
537 | ACPI_RASF_ABORTED = 5, | |
538 | ACPI_RASF_INVALID_DATA = 6 | |
539 | }; | |
540 | ||
541 | /* Status flags */ | |
542 | ||
543 | #define ACPI_RASF_COMMAND_COMPLETE (1) | |
544 | #define ACPI_RASF_SCI_DOORBELL (1<<1) | |
545 | #define ACPI_RASF_ERROR (1<<2) | |
546 | #define ACPI_RASF_STATUS (0x1F<<3) | |
547 | ||
548 | /* Reset to default packing */ | |
549 | ||
550 | #pragma pack() | |
551 | ||
552 | #endif /* __ACTBL3_H__ */ |