1 /*******************************************************************************
3 * Module Name: dmresrcl.c - "Large" Resource Descriptor disassembly
6 ******************************************************************************/
8 /******************************************************************************
12 * Some or all of this work - Copyright (c) 1999 - 2004, Intel Corp.
13 * All rights reserved.
17 * 2.1. This is your license from Intel Corp. under its intellectual property
18 * rights. You may have additional license terms from the party that provided
19 * you this software, covering your right to use that party's intellectual
22 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
23 * copy of the source code appearing in this file ("Covered Code") an
24 * irrevocable, perpetual, worldwide license under Intel's copyrights in the
25 * base code distributed originally by Intel ("Original Intel Code") to copy,
26 * make derivatives, distribute, use and display any portion of the Covered
27 * Code in any form, with the right to sublicense such rights; and
29 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
30 * license (with the right to sublicense), under only those claims of Intel
31 * patents that are infringed by the Original Intel Code, to make, use, sell,
32 * offer to sell, and import the Covered Code and derivative works thereof
33 * solely to the minimum extent necessary to exercise the above copyright
34 * license, and in no event shall the patent license extend to any additions
35 * to or modifications of the Original Intel Code. No other license or right
36 * is granted directly or by implication, estoppel or otherwise;
38 * The above copyright and patent license is granted only if the following
43 * 3.1. Redistribution of Source with Rights to Further Distribute Source.
44 * Redistribution of source code of any substantial portion of the Covered
45 * Code or modification with rights to further distribute source must include
46 * the above Copyright Notice, the above License, this list of Conditions,
47 * and the following Disclaimer and Export Compliance provision. In addition,
48 * Licensee must cause all Covered Code to which Licensee contributes to
49 * contain a file documenting the changes Licensee made to create that Covered
50 * Code and the date of any change. Licensee must include in that file the
51 * documentation of any changes made by any predecessor Licensee. Licensee
52 * must include a prominent statement that the modification is derived,
53 * directly or indirectly, from Original Intel Code.
55 * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
56 * Redistribution of source code of any substantial portion of the Covered
57 * Code or modification without rights to further distribute source must
58 * include the following Disclaimer and Export Compliance provision in the
59 * documentation and/or other materials provided with distribution. In
60 * addition, Licensee may not authorize further sublicense of source of any
61 * portion of the Covered Code, and must include terms to the effect that the
62 * license from Licensee to its licensee is limited to the intellectual
63 * property embodied in the software Licensee provides to its licensee, and
64 * not to intellectual property embodied in modifications its licensee may
67 * 3.3. Redistribution of Executable. Redistribution in executable form of any
68 * substantial portion of the Covered Code or modification must reproduce the
69 * above Copyright Notice, and the following Disclaimer and Export Compliance
70 * provision in the documentation and/or other materials provided with the
73 * 3.4. Intel retains all right, title, and interest in and to the Original
76 * 3.5. Neither the name Intel nor any other trademark owned or controlled by
77 * Intel shall be used in advertising or otherwise to promote the sale, use or
78 * other dealings in products derived from or relating to the Covered Code
79 * without prior written authorization from Intel.
81 * 4. Disclaimer and Export Compliance
83 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
84 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
85 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
86 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
87 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
88 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
91 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
92 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
93 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
94 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
95 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
96 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
97 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
100 * 4.3. Licensee shall not export, either directly or indirectly, any of this
101 * software or system incorporating such software without first obtaining any
102 * required license or other approval from the U. S. Department of Commerce or
103 * any other agency or department of the United States Government. In the
104 * event Licensee exports any such software from the United States or
105 * re-exports any such software from a foreign destination, Licensee shall
106 * ensure that the distribution and export/re-export of the software is in
107 * compliance with all laws, regulations, orders, or other restrictions of the
108 * U.S. Export Administration Regulations. Licensee agrees that neither it nor
109 * any of its subsidiaries will export/re-export any technical data, process,
110 * software, or service, directly or indirectly, to any country for which the
111 * United States government or any agency thereof requires an export license,
112 * other governmental approval, or letter of assurance, without first obtaining
113 * such license, approval or letter.
115 *****************************************************************************/
119 #include "acdisasm.h"
122 #ifdef ACPI_DISASSEMBLER
124 #define _COMPONENT ACPI_CA_DEBUGGER
125 ACPI_MODULE_NAME ("dbresrcl")
128 /*******************************************************************************
130 * FUNCTION: AcpiDmIoFlags
132 * PARAMETERS: Flags - Flag byte to be decoded
136 * DESCRIPTION: Decode the flags specific to IO Address space descriptors
138 ******************************************************************************/
144 AcpiOsPrintf ("%s, %s, %s, %s,",
145 AcpiGbl_ConsumeDecode [(Flags & 1)],
146 AcpiGbl_MinDecode [(Flags & 0x4) >> 2],
147 AcpiGbl_MaxDecode [(Flags & 0x8) >> 3],
148 AcpiGbl_DECDecode [(Flags & 0x2) >> 1]);
152 /*******************************************************************************
154 * FUNCTION: AcpiDmMemoryFlags
156 * PARAMETERS: Flags - Flag byte to be decoded
157 * SpecificFlags - "Specific" flag byte to be decoded
161 * DESCRIPTION: Decode flags specific to Memory Address Space descriptors
163 ******************************************************************************/
170 AcpiOsPrintf ("%s, %s, %s, %s, %s, %s,",
171 AcpiGbl_ConsumeDecode [(Flags & 1)],
172 AcpiGbl_DECDecode [(Flags & 0x2) >> 1],
173 AcpiGbl_MinDecode [(Flags & 0x4) >> 2],
174 AcpiGbl_MaxDecode [(Flags & 0x8) >> 3],
175 AcpiGbl_MEMDecode [(SpecificFlags & 0x6) >> 1],
176 AcpiGbl_RWDecode [(SpecificFlags & 0x1)]);
180 /*******************************************************************************
182 * FUNCTION: AcpiDmWordDescriptor
184 * PARAMETERS: Resource - Pointer to the resource descriptor
185 * Length - Length of the descriptor in bytes
186 * Level - Current source code indentation level
190 * DESCRIPTION: Decode a Word Address Space descriptor
192 ******************************************************************************/
195 AcpiDmWordDescriptor (
196 ASL_WORD_ADDRESS_DESC *Resource,
201 AcpiDmIndent (Level);
202 AcpiOsPrintf ("%s (",
203 AcpiGbl_WordDecode [(Resource->ResourceType & 3)]);
205 AcpiDmIoFlags (Resource->Flags);
207 if ((Resource->ResourceType & 0x3) == 1)
209 AcpiOsPrintf (" %s,",
210 AcpiGbl_RNGDecode [(Resource->SpecificFlags & 0x3)]);
213 /* The WORD values */
216 AcpiDmIndent (Level + 1);
217 AcpiOsPrintf ("0x%4.4X,\n",
218 (UINT32) Resource->Granularity);
219 AcpiDmIndent (Level + 1);
220 AcpiOsPrintf ("0x%4.4X,\n",
221 (UINT32) Resource->AddressMin);
222 AcpiDmIndent (Level + 1);
223 AcpiOsPrintf ("0x%4.4X,\n",
224 (UINT32) Resource->AddressMax);
225 AcpiDmIndent (Level + 1);
226 AcpiOsPrintf ("0x%4.4X,\n",
227 (UINT32) Resource->TranslationOffset);
228 AcpiDmIndent (Level + 1);
229 AcpiOsPrintf ("0x%4.4X",
230 (UINT32) Resource->AddressLength);
232 /* Optional fields */
236 AcpiOsPrintf (", 0x%2.2X",
237 (UINT32) Resource->OptionalFields[0]);
242 AcpiOsPrintf (", %s",
243 &Resource->OptionalFields[1]);
245 AcpiOsPrintf (")\n");
249 /*******************************************************************************
251 * FUNCTION: AcpiDmDwordDescriptor
253 * PARAMETERS: Resource - Pointer to the resource descriptor
254 * Length - Length of the descriptor in bytes
255 * Level - Current source code indentation level
259 * DESCRIPTION: Decode a DWord Address Space descriptor
261 ******************************************************************************/
264 AcpiDmDwordDescriptor (
265 ASL_DWORD_ADDRESS_DESC *Resource,
270 AcpiDmIndent (Level);
271 AcpiOsPrintf ("D%s (",
272 AcpiGbl_WordDecode [(Resource->ResourceType & 3)]);
274 if ((Resource->ResourceType & 0x3) == 1)
276 AcpiDmIoFlags (Resource->Flags);
277 AcpiOsPrintf (" %s,",
278 AcpiGbl_RNGDecode [(Resource->SpecificFlags & 0x3)]);
282 AcpiDmMemoryFlags (Resource->Flags, Resource->SpecificFlags);
285 /* The DWORD values */
288 AcpiDmIndent (Level + 1);
289 AcpiOsPrintf ("0x%8.8X,\n",
290 Resource->Granularity);
291 AcpiDmIndent (Level + 1);
292 AcpiOsPrintf ("0x%8.8X,\n",
293 Resource->AddressMin);
294 AcpiDmIndent (Level + 1);
295 AcpiOsPrintf ("0x%8.8X,\n",
296 Resource->AddressMax);
297 AcpiDmIndent (Level + 1);
298 AcpiOsPrintf ("0x%8.8X,\n",
299 Resource->TranslationOffset);
300 AcpiDmIndent (Level + 1);
301 AcpiOsPrintf ("0x%8.8X",
302 Resource->AddressLength);
304 /* Optional fields */
308 AcpiOsPrintf (", 0x%2.2X",
309 Resource->OptionalFields[0]);
313 AcpiOsPrintf (", %s",
314 &Resource->OptionalFields[1]);
316 AcpiOsPrintf (")\n");
320 /*******************************************************************************
322 * FUNCTION: AcpiDmQwordDescriptor
324 * PARAMETERS: Resource - Pointer to the resource descriptor
325 * Length - Length of the descriptor in bytes
326 * Level - Current source code indentation level
330 * DESCRIPTION: Decode a QWord Address Space descriptor
332 ******************************************************************************/
335 AcpiDmQwordDescriptor (
336 ASL_QWORD_ADDRESS_DESC *Resource,
341 AcpiDmIndent (Level);
342 AcpiOsPrintf ("Q%s (",
343 AcpiGbl_WordDecode [(Resource->ResourceType & 3)]);
345 if ((Resource->ResourceType & 0x3) == 1)
347 AcpiDmIoFlags (Resource->Flags);
348 AcpiOsPrintf (" %s,",
349 AcpiGbl_RNGDecode [(Resource->SpecificFlags & 0x3)]);
353 AcpiDmMemoryFlags (Resource->Flags, Resource->SpecificFlags);
356 /* The QWORD values */
359 AcpiDmIndent (Level + 1);
360 AcpiOsPrintf ("0x%8.8X%8.8X,\n",
361 ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Resource->Granularity)));
363 AcpiDmIndent (Level + 1);
364 AcpiOsPrintf ("0x%8.8X%8.8X,\n",
365 ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Resource->AddressMin)));
367 AcpiDmIndent (Level + 1);
368 AcpiOsPrintf ("0x%8.8X%8.8X,\n",
369 ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Resource->AddressMax)));
371 AcpiDmIndent (Level + 1);
372 AcpiOsPrintf ("0x%8.8X%8.8X,\n",
373 ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Resource->TranslationOffset)));
375 AcpiDmIndent (Level + 1);
376 AcpiOsPrintf ("0x%8.8X%8.8X",
377 ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Resource->AddressLength)));
379 /* Optional fields */
383 AcpiOsPrintf (", 0x%2.2X",
384 Resource->OptionalFields[0]);
388 AcpiOsPrintf (", %s",
389 &Resource->OptionalFields[1]);
392 AcpiOsPrintf (")\n");
396 /*******************************************************************************
398 * FUNCTION: AcpiDmMemory24Descriptor
400 * PARAMETERS: Resource - Pointer to the resource descriptor
401 * Length - Length of the descriptor in bytes
402 * Level - Current source code indentation level
406 * DESCRIPTION: Decode a Memory24 descriptor
408 ******************************************************************************/
411 AcpiDmMemory24Descriptor (
412 ASL_MEMORY_24_DESC *Resource,
417 AcpiDmIndent (Level);
418 AcpiOsPrintf ("Memory24 (%s, 0x%4.4X, 0x%4.4X, 0x%4.4X, 0x%4.4X)\n",
419 AcpiGbl_RWDecode [Resource->Information & 1],
420 (UINT32) Resource->AddressMin,
421 (UINT32) Resource->AddressMax,
422 (UINT32) Resource->Alignment,
423 (UINT32) Resource->RangeLength);
427 /*******************************************************************************
429 * FUNCTION: AcpiDmMemory32Descriptor
431 * PARAMETERS: Resource - Pointer to the resource descriptor
432 * Length - Length of the descriptor in bytes
433 * Level - Current source code indentation level
437 * DESCRIPTION: Decode a Memory32 descriptor
439 ******************************************************************************/
442 AcpiDmMemory32Descriptor (
443 ASL_MEMORY_32_DESC *Resource,
448 AcpiDmIndent (Level);
449 AcpiOsPrintf ("Memory32 (%s, 0x%8.8X, 0x%8.8X, 0x%8.8X, 0x%8.8X)\n",
450 AcpiGbl_RWDecode [Resource->Information & 1],
451 Resource->AddressMin,
452 Resource->AddressMax,
454 Resource->RangeLength);
458 /*******************************************************************************
460 * FUNCTION: AcpiDmFixedMem32Descriptor
462 * PARAMETERS: Resource - Pointer to the resource descriptor
463 * Length - Length of the descriptor in bytes
464 * Level - Current source code indentation level
468 * DESCRIPTION: Decode a Fixed Memory32 descriptor
470 ******************************************************************************/
473 AcpiDmFixedMem32Descriptor (
474 ASL_FIXED_MEMORY_32_DESC *Resource,
479 AcpiDmIndent (Level);
480 AcpiOsPrintf ("Memory32Fixed (%s, 0x%8.8X, 0x%8.8X)\n",
481 AcpiGbl_RWDecode [Resource->Information & 1],
482 Resource->BaseAddress,
483 Resource->RangeLength);
487 /*******************************************************************************
489 * FUNCTION: AcpiDmGenericRegisterDescriptor
491 * PARAMETERS: Resource - Pointer to the resource descriptor
492 * Length - Length of the descriptor in bytes
493 * Level - Current source code indentation level
497 * DESCRIPTION: Decode a Generic Register descriptor
499 ******************************************************************************/
502 AcpiDmGenericRegisterDescriptor (
503 ASL_GENERAL_REGISTER_DESC *Resource,
508 AcpiDmIndent (Level);
509 AcpiOsPrintf ("Register (");
511 AcpiDmAddressSpace (Resource->AddressSpaceId);
513 AcpiOsPrintf ("0x%2.2X, 0x%2.2X, 0x%8.8X%8.8X)\n",
514 (UINT32) Resource->BitWidth,
515 (UINT32) Resource->BitOffset,
516 ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Resource->Address)));
520 /*******************************************************************************
522 * FUNCTION: AcpiDmInterruptDescriptor
524 * PARAMETERS: Resource - Pointer to the resource descriptor
525 * Length - Length of the descriptor in bytes
526 * Level - Current source code indentation level
530 * DESCRIPTION: Decode a extended Interrupt descriptor
532 ******************************************************************************/
535 AcpiDmInterruptDescriptor (
536 ASL_EXTENDED_XRUPT_DESC *Resource,
544 AcpiDmIndent (Level);
545 AcpiOsPrintf ("Interrupt (%s, %s, %s, %s",
546 AcpiGbl_ConsumeDecode [(Resource->Flags & 1)],
547 AcpiGbl_HEDecode [(Resource->Flags >> 1) & 1],
548 AcpiGbl_LLDecode [(Resource->Flags >> 2) & 1],
549 AcpiGbl_SHRDecode [(Resource->Flags >> 3) & 1]);
551 /* Resource Index/Source, optional -- at end of descriptor */
553 if (Resource->Length > (UINT16) (4 * Resource->TableLength) + 2)
555 /* Get a pointer past the interrupt values */
557 Rover = ((UINT8 *) Resource) + ((4 * Resource->TableLength) + 5);
560 /* Resource Source */
562 AcpiOsPrintf (", 0x%X, \"%s\"", (UINT32) Rover[0], (char *) &Rover[1]);
565 AcpiOsPrintf (")\n");
566 AcpiDmIndent (Level);
567 AcpiOsPrintf ("{\n");
568 for (i = 0; i < Resource->TableLength; i++)
570 AcpiDmIndent (Level + 1);
571 AcpiOsPrintf ("0x%8.8X,\n", (UINT32) Resource->InterruptNumber[i]);
574 AcpiDmIndent (Level);
575 AcpiOsPrintf ("}\n");
579 /*******************************************************************************
581 * FUNCTION: AcpiDmVendorLargeDescriptor
583 * PARAMETERS: Resource - Pointer to the resource descriptor
584 * Length - Length of the descriptor in bytes
585 * Level - Current source code indentation level
589 * DESCRIPTION: Decode a Vendor Large descriptor
591 ******************************************************************************/
594 AcpiDmVendorLargeDescriptor (
595 ASL_LARGE_VENDOR_DESC *Resource,
600 AcpiDmIndent (Level);
601 AcpiOsPrintf ("VendorLong ()\n");
602 AcpiDmIndent (Level);
604 AcpiOsPrintf ("{\n");
606 AcpiDmDisasmByteList (Level + 1, (UINT8 *) Resource->VendorDefined, Length);
607 AcpiDmIndent (Level);
608 AcpiOsPrintf ("}\n");