1 /*******************************************************************************
   2  *
   3  * Module Name: dmresrcl.c - "Large" Resource Descriptor disassembly
   4  *
   5  ******************************************************************************/
   6 
   7 /*
   8  * Copyright (C) 2000 - 2013, 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 
  45 #include "acpi.h"
  46 #include "accommon.h"
  47 #include "acdisasm.h"
  48 
  49 
  50 #ifdef ACPI_DISASSEMBLER
  51 
  52 #define _COMPONENT          ACPI_CA_DEBUGGER
  53         ACPI_MODULE_NAME    ("dbresrcl")
  54 
  55 
  56 /* Common names for address and memory descriptors */
  57 
  58 static char                 *AcpiDmAddressNames[] =
  59 {
  60     "Granularity",
  61     "Range Minimum",
  62     "Range Maximum",
  63     "Translation Offset",
  64     "Length"
  65 };
  66 
  67 static char                 *AcpiDmMemoryNames[] =
  68 {
  69     "Range Minimum",
  70     "Range Maximum",
  71     "Alignment",
  72     "Length"
  73 };
  74 
  75 
  76 /* Local prototypes */
  77 
  78 static void
  79 AcpiDmSpaceFlags (
  80         UINT8               Flags);
  81 
  82 static void
  83 AcpiDmIoFlags (
  84         UINT8               Flags);
  85 
  86 static void
  87 AcpiDmIoFlags2 (
  88         UINT8               SpecificFlags);
  89 
  90 static void
  91 AcpiDmMemoryFlags (
  92     UINT8                   Flags,
  93     UINT8                   SpecificFlags);
  94 
  95 static void
  96 AcpiDmMemoryFlags2 (
  97     UINT8                   SpecificFlags);
  98 
  99 static void
 100 AcpiDmResourceSource (
 101     AML_RESOURCE            *Resource,
 102     ACPI_SIZE               MinimumLength,
 103     UINT32                  Length);
 104 
 105 static void
 106 AcpiDmAddressFields (
 107     void                    *Source,
 108     UINT8                   Type,
 109     UINT32                  Level);
 110 
 111 static void
 112 AcpiDmAddressPrefix (
 113     UINT8                   Type);
 114 
 115 static void
 116 AcpiDmAddressCommon (
 117     AML_RESOURCE            *Resource,
 118     UINT8                   Type,
 119     UINT32                  Level);
 120 
 121 static void
 122 AcpiDmAddressFlags (
 123     AML_RESOURCE            *Resource);
 124 
 125 
 126 /*******************************************************************************
 127  *
 128  * FUNCTION:    AcpiDmMemoryFields
 129  *
 130  * PARAMETERS:  Source              - Pointer to the contiguous data fields
 131  *              Type                - 16 or 32 (bit)
 132  *              Level               - Current source code indentation level
 133  *
 134  * RETURN:      None
 135  *
 136  * DESCRIPTION: Decode fields common to Memory24 and Memory32 descriptors
 137  *
 138  ******************************************************************************/
 139 
 140 static void
 141 AcpiDmMemoryFields (
 142     void                    *Source,
 143     UINT8                   Type,
 144     UINT32                  Level)
 145 {
 146     UINT32                  i;
 147 
 148 
 149     for (i = 0; i < 4; i++)
 150     {
 151         AcpiDmIndent (Level + 1);
 152 
 153         switch (Type)
 154         {
 155         case 16:
 156 
 157             AcpiDmDumpInteger16 (ACPI_CAST_PTR (UINT16, Source)[i],
 158                 AcpiDmMemoryNames[i]);
 159             break;
 160 
 161         case 32:
 162 
 163             AcpiDmDumpInteger32 (ACPI_CAST_PTR (UINT32, Source)[i],
 164                 AcpiDmMemoryNames[i]);
 165             break;
 166 
 167         default:
 168 
 169             return;
 170         }
 171     }
 172 }
 173 
 174 
 175 /*******************************************************************************
 176  *
 177  * FUNCTION:    AcpiDmAddressFields
 178  *
 179  * PARAMETERS:  Source              - Pointer to the contiguous data fields
 180  *              Type                - 16, 32, or 64 (bit)
 181  *              Level               - Current source code indentation level
 182  *
 183  * RETURN:      None
 184  *
 185  * DESCRIPTION: Decode fields common to address descriptors
 186  *
 187  ******************************************************************************/
 188 
 189 static void
 190 AcpiDmAddressFields (
 191     void                    *Source,
 192     UINT8                   Type,
 193     UINT32                  Level)
 194 {
 195     UINT32                  i;
 196 
 197 
 198     AcpiOsPrintf ("\n");
 199 
 200     for (i = 0; i < 5; i++)
 201     {
 202         AcpiDmIndent (Level + 1);
 203 
 204         switch (Type)
 205         {
 206         case 16:
 207 
 208             AcpiDmDumpInteger16 (ACPI_CAST_PTR (UINT16, Source)[i],
 209                 AcpiDmAddressNames[i]);
 210             break;
 211 
 212         case 32:
 213 
 214             AcpiDmDumpInteger32 (ACPI_CAST_PTR (UINT32, Source)[i],
 215                 AcpiDmAddressNames[i]);
 216             break;
 217 
 218         case 64:
 219 
 220             AcpiDmDumpInteger64 (ACPI_CAST_PTR (UINT64, Source)[i],
 221                 AcpiDmAddressNames[i]);
 222             break;
 223 
 224         default:
 225 
 226             return;
 227         }
 228     }
 229 }
 230 
 231 
 232 /*******************************************************************************
 233  *
 234  * FUNCTION:    AcpiDmAddressPrefix
 235  *
 236  * PARAMETERS:  Type                - Descriptor type
 237  *
 238  * RETURN:      None
 239  *
 240  * DESCRIPTION: Emit name prefix representing the address descriptor type
 241  *
 242  ******************************************************************************/
 243 
 244 static void
 245 AcpiDmAddressPrefix (
 246     UINT8                   Type)
 247 {
 248 
 249     switch (Type)
 250     {
 251     case ACPI_RESOURCE_TYPE_ADDRESS16:
 252 
 253         AcpiOsPrintf ("Word");
 254         break;
 255 
 256     case ACPI_RESOURCE_TYPE_ADDRESS32:
 257 
 258         AcpiOsPrintf ("DWord");
 259         break;
 260 
 261     case ACPI_RESOURCE_TYPE_ADDRESS64:
 262 
 263         AcpiOsPrintf ("QWord");
 264         break;
 265 
 266     case ACPI_RESOURCE_TYPE_EXTENDED_ADDRESS64:
 267 
 268         AcpiOsPrintf ("Extended");
 269         break;
 270 
 271     default:
 272 
 273         return;
 274     }
 275 }
 276 
 277 
 278 /*******************************************************************************
 279  *
 280  * FUNCTION:    AcpiDmAddressCommon
 281  *
 282  * PARAMETERS:  Resource            - Raw AML descriptor
 283  *              Type                - Descriptor type
 284  *              Level               - Current source code indentation level
 285  *
 286  * RETURN:      None
 287  *
 288  * DESCRIPTION: Emit common name and flag fields common to address descriptors
 289  *
 290  ******************************************************************************/
 291 
 292 static void
 293 AcpiDmAddressCommon (
 294     AML_RESOURCE            *Resource,
 295     UINT8                   Type,
 296     UINT32                  Level)
 297 {
 298     UINT8                   ResourceType;
 299     UINT8                   SpecificFlags;
 300     UINT8                   Flags;
 301 
 302 
 303     ResourceType = Resource->Address.ResourceType;
 304     SpecificFlags = Resource->Address.SpecificFlags;
 305     Flags = Resource->Address.Flags;
 306 
 307     AcpiDmIndent (Level);
 308 
 309     /* Validate ResourceType */
 310 
 311     if ((ResourceType > 2) && (ResourceType < 0xC0))
 312     {
 313         AcpiOsPrintf ("/**** Invalid Resource Type: 0x%X ****/", ResourceType);
 314         return;
 315     }
 316 
 317     /* Prefix is either Word, DWord, QWord, or Extended */
 318 
 319     AcpiDmAddressPrefix (Type);
 320 
 321     /* Resource Types above 0xC0 are vendor-defined */
 322 
 323     if (ResourceType > 2)
 324     {
 325         AcpiOsPrintf ("Space (0x%2.2X, ", ResourceType);
 326         AcpiDmSpaceFlags (Flags);
 327         AcpiOsPrintf (" 0x%2.2X,", SpecificFlags);
 328         return;
 329     }
 330 
 331     /* This is either a Memory, IO, or BusNumber descriptor (0,1,2) */
 332 
 333     AcpiOsPrintf ("%s (", AcpiGbl_WordDecode [ACPI_GET_2BIT_FLAG (ResourceType)]);
 334 
 335     /* Decode the general and type-specific flags */
 336 
 337     if (ResourceType == ACPI_MEMORY_RANGE)
 338     {
 339         AcpiDmMemoryFlags (Flags, SpecificFlags);
 340     }
 341     else /* IO range or BusNumberRange */
 342     {
 343         AcpiDmIoFlags (Flags);
 344         if (ResourceType == ACPI_IO_RANGE)
 345         {
 346             AcpiOsPrintf (" %s,", AcpiGbl_RngDecode [ACPI_GET_2BIT_FLAG (SpecificFlags)]);
 347         }
 348     }
 349 }
 350 
 351 
 352 /*******************************************************************************
 353  *
 354  * FUNCTION:    AcpiDmAddressFlags
 355  *
 356  * PARAMETERS:  Resource        - Raw AML descriptor
 357  *
 358  * RETURN:      None
 359  *
 360  * DESCRIPTION: Emit flags common to address descriptors
 361  *
 362  ******************************************************************************/
 363 
 364 static void
 365 AcpiDmAddressFlags (
 366     AML_RESOURCE            *Resource)
 367 {
 368 
 369     if (Resource->Address.ResourceType == ACPI_IO_RANGE)
 370     {
 371         AcpiDmIoFlags2 (Resource->Address.SpecificFlags);
 372     }
 373     else if (Resource->Address.ResourceType == ACPI_MEMORY_RANGE)
 374     {
 375         AcpiDmMemoryFlags2 (Resource->Address.SpecificFlags);
 376     }
 377 }
 378 
 379 
 380 /*******************************************************************************
 381  *
 382  * FUNCTION:    AcpiDmSpaceFlags
 383  *
 384  * PARAMETERS:  Flags               - Flag byte to be decoded
 385  *
 386  * RETURN:      None
 387  *
 388  * DESCRIPTION: Decode the flags specific to Space Address space descriptors
 389  *
 390  ******************************************************************************/
 391 
 392 static void
 393 AcpiDmSpaceFlags (
 394     UINT8                   Flags)
 395 {
 396 
 397     AcpiOsPrintf ("%s, %s, %s, %s,",
 398         AcpiGbl_ConsumeDecode [ACPI_GET_1BIT_FLAG (Flags)],
 399         AcpiGbl_DecDecode [ACPI_EXTRACT_1BIT_FLAG (Flags, 1)],
 400         AcpiGbl_MinDecode [ACPI_EXTRACT_1BIT_FLAG (Flags, 2)],
 401         AcpiGbl_MaxDecode [ACPI_EXTRACT_1BIT_FLAG (Flags, 3)]);
 402 }
 403 
 404 
 405 /*******************************************************************************
 406  *
 407  * FUNCTION:    AcpiDmIoFlags
 408  *
 409  * PARAMETERS:  Flags               - Flag byte to be decoded
 410  *
 411  * RETURN:      None
 412  *
 413  * DESCRIPTION: Decode the flags specific to IO Address space descriptors
 414  *
 415  ******************************************************************************/
 416 
 417 static void
 418 AcpiDmIoFlags (
 419         UINT8               Flags)
 420 {
 421     AcpiOsPrintf ("%s, %s, %s, %s,",
 422         AcpiGbl_ConsumeDecode [ACPI_GET_1BIT_FLAG (Flags)],
 423         AcpiGbl_MinDecode [ACPI_EXTRACT_1BIT_FLAG (Flags, 2)],
 424         AcpiGbl_MaxDecode [ACPI_EXTRACT_1BIT_FLAG (Flags, 3)],
 425         AcpiGbl_DecDecode [ACPI_EXTRACT_1BIT_FLAG (Flags, 1)]);
 426 }
 427 
 428 
 429 /*******************************************************************************
 430  *
 431  * FUNCTION:    AcpiDmIoFlags2
 432  *
 433  * PARAMETERS:  SpecificFlags       - "Specific" flag byte to be decoded
 434  *
 435  * RETURN:      None
 436  *
 437  * DESCRIPTION: Decode the flags specific to IO Address space descriptors
 438  *
 439  ******************************************************************************/
 440 
 441 static void
 442 AcpiDmIoFlags2 (
 443         UINT8               SpecificFlags)
 444 {
 445 
 446     AcpiOsPrintf (", %s",
 447         AcpiGbl_TtpDecode [ACPI_EXTRACT_1BIT_FLAG (SpecificFlags, 4)]);
 448 
 449     /* TRS is only used if TTP is TypeTranslation */
 450 
 451     if (SpecificFlags & 0x10)
 452     {
 453         AcpiOsPrintf (", %s",
 454             AcpiGbl_TrsDecode [ACPI_EXTRACT_1BIT_FLAG (SpecificFlags, 5)]);
 455     }
 456 }
 457 
 458 
 459 /*******************************************************************************
 460  *
 461  * FUNCTION:    AcpiDmMemoryFlags
 462  *
 463  * PARAMETERS:  Flags               - Flag byte to be decoded
 464  *              SpecificFlags       - "Specific" flag byte to be decoded
 465  *
 466  * RETURN:      None
 467  *
 468  * DESCRIPTION: Decode flags specific to Memory Address Space descriptors
 469  *
 470  ******************************************************************************/
 471 
 472 static void
 473 AcpiDmMemoryFlags (
 474     UINT8                   Flags,
 475     UINT8                   SpecificFlags)
 476 {
 477 
 478     AcpiOsPrintf ("%s, %s, %s, %s, %s, %s,",
 479         AcpiGbl_ConsumeDecode [ACPI_GET_1BIT_FLAG (Flags)],
 480         AcpiGbl_DecDecode [ACPI_EXTRACT_1BIT_FLAG (Flags, 1)],
 481         AcpiGbl_MinDecode [ACPI_EXTRACT_1BIT_FLAG (Flags, 2)],
 482         AcpiGbl_MaxDecode [ACPI_EXTRACT_1BIT_FLAG (Flags, 3)],
 483         AcpiGbl_MemDecode [ACPI_EXTRACT_2BIT_FLAG (SpecificFlags, 1)],
 484         AcpiGbl_RwDecode [ACPI_GET_1BIT_FLAG (SpecificFlags)]);
 485 }
 486 
 487 
 488 /*******************************************************************************
 489  *
 490  * FUNCTION:    AcpiDmMemoryFlags2
 491  *
 492  * PARAMETERS:  SpecificFlags       - "Specific" flag byte to be decoded
 493  *
 494  * RETURN:      None
 495  *
 496  * DESCRIPTION: Decode flags specific to Memory Address Space descriptors
 497  *
 498  ******************************************************************************/
 499 
 500 static void
 501 AcpiDmMemoryFlags2 (
 502     UINT8                   SpecificFlags)
 503 {
 504 
 505     AcpiOsPrintf (", %s, %s",
 506         AcpiGbl_MtpDecode [ACPI_EXTRACT_2BIT_FLAG (SpecificFlags, 3)],
 507         AcpiGbl_TtpDecode [ACPI_EXTRACT_1BIT_FLAG (SpecificFlags, 5)]);
 508 }
 509 
 510 
 511 /*******************************************************************************
 512  *
 513  * FUNCTION:    AcpiDmResourceSource
 514  *
 515  * PARAMETERS:  Resource        - Raw AML descriptor
 516  *              MinimumLength   - descriptor length without optional fields
 517  *              ResourceLength
 518  *
 519  * RETURN:      None
 520  *
 521  * DESCRIPTION: Dump optional ResourceSource fields of an address descriptor
 522  *
 523  ******************************************************************************/
 524 
 525 static void
 526 AcpiDmResourceSource (
 527     AML_RESOURCE            *Resource,
 528     ACPI_SIZE               MinimumTotalLength,
 529     UINT32                  ResourceLength)
 530 {
 531     UINT8                   *AmlResourceSource;
 532     UINT32                  TotalLength;
 533 
 534 
 535     TotalLength = ResourceLength + sizeof (AML_RESOURCE_LARGE_HEADER);
 536 
 537     /* Check if the optional ResourceSource fields are present */
 538 
 539     if (TotalLength <= MinimumTotalLength)
 540     {
 541         /* The two optional fields are not used */
 542 
 543         AcpiOsPrintf (",, ");
 544         return;
 545     }
 546 
 547     /* Get a pointer to the ResourceSource */
 548 
 549     AmlResourceSource = ACPI_ADD_PTR (UINT8, Resource, MinimumTotalLength);
 550 
 551     /*
 552      * Always emit the ResourceSourceIndex (Byte)
 553      *
 554      * NOTE: Some ASL compilers always create a 0 byte (in the AML) for the
 555      * Index even if the String does not exist. Although this is in violation
 556      * of the ACPI specification, it is very important to emit ASL code that
 557      * can be compiled back to the identical AML. There may be fields and/or
 558      * indexes into the resource template buffer that are compiled to absolute
 559      * offsets, and these will be broken if the AML length is changed.
 560      */
 561     AcpiOsPrintf ("0x%2.2X,", (UINT32) AmlResourceSource[0]);
 562 
 563     /* Make sure that the ResourceSource string exists before dumping it */
 564 
 565     if (TotalLength > (MinimumTotalLength + 1))
 566     {
 567         AcpiOsPrintf (" ");
 568         AcpiUtPrintString ((char *) &AmlResourceSource[1], ACPI_UINT16_MAX);
 569     }
 570 
 571     AcpiOsPrintf (", ");
 572 }
 573 
 574 
 575 /*******************************************************************************
 576  *
 577  * FUNCTION:    AcpiDmWordDescriptor
 578  *
 579  * PARAMETERS:  Resource            - Pointer to the resource descriptor
 580  *              Length              - Length of the descriptor in bytes
 581  *              Level               - Current source code indentation level
 582  *
 583  * RETURN:      None
 584  *
 585  * DESCRIPTION: Decode a Word Address Space descriptor
 586  *
 587  ******************************************************************************/
 588 
 589 void
 590 AcpiDmWordDescriptor (
 591     AML_RESOURCE            *Resource,
 592     UINT32                  Length,
 593     UINT32                  Level)
 594 {
 595 
 596     /* Dump resource name and flags */
 597 
 598     AcpiDmAddressCommon (Resource, ACPI_RESOURCE_TYPE_ADDRESS16, Level);
 599 
 600     /* Dump the 5 contiguous WORD values */
 601 
 602     AcpiDmAddressFields (&Resource->Address16.Granularity, 16, Level);
 603 
 604     /* The ResourceSource fields are optional */
 605 
 606     AcpiDmIndent (Level + 1);
 607     AcpiDmResourceSource (Resource, sizeof (AML_RESOURCE_ADDRESS16), Length);
 608 
 609     /* Insert a descriptor name */
 610 
 611     AcpiDmDescriptorName ();
 612 
 613     /* Type-specific flags */
 614 
 615     AcpiDmAddressFlags (Resource);
 616     AcpiOsPrintf (")\n");
 617 }
 618 
 619 
 620 /*******************************************************************************
 621  *
 622  * FUNCTION:    AcpiDmDwordDescriptor
 623  *
 624  * PARAMETERS:  Resource            - Pointer to the resource descriptor
 625  *              Length              - Length of the descriptor in bytes
 626  *              Level               - Current source code indentation level
 627  *
 628  * RETURN:      None
 629  *
 630  * DESCRIPTION: Decode a DWord Address Space descriptor
 631  *
 632  ******************************************************************************/
 633 
 634 void
 635 AcpiDmDwordDescriptor (
 636     AML_RESOURCE            *Resource,
 637     UINT32                  Length,
 638     UINT32                  Level)
 639 {
 640 
 641     /* Dump resource name and flags */
 642 
 643     AcpiDmAddressCommon (Resource, ACPI_RESOURCE_TYPE_ADDRESS32, Level);
 644 
 645     /* Dump the 5 contiguous DWORD values */
 646 
 647     AcpiDmAddressFields (&Resource->Address32.Granularity, 32, Level);
 648 
 649     /* The ResourceSource fields are optional */
 650 
 651     AcpiDmIndent (Level + 1);
 652     AcpiDmResourceSource (Resource, sizeof (AML_RESOURCE_ADDRESS32), Length);
 653 
 654     /* Insert a descriptor name */
 655 
 656     AcpiDmDescriptorName ();
 657 
 658     /* Type-specific flags */
 659 
 660     AcpiDmAddressFlags (Resource);
 661     AcpiOsPrintf (")\n");
 662 }
 663 
 664 
 665 /*******************************************************************************
 666  *
 667  * FUNCTION:    AcpiDmQwordDescriptor
 668  *
 669  * PARAMETERS:  Resource            - Pointer to the resource descriptor
 670  *              Length              - Length of the descriptor in bytes
 671  *              Level               - Current source code indentation level
 672  *
 673  * RETURN:      None
 674  *
 675  * DESCRIPTION: Decode a QWord Address Space descriptor
 676  *
 677  ******************************************************************************/
 678 
 679 void
 680 AcpiDmQwordDescriptor (
 681     AML_RESOURCE            *Resource,
 682     UINT32                  Length,
 683     UINT32                  Level)
 684 {
 685 
 686     /* Dump resource name and flags */
 687 
 688     AcpiDmAddressCommon (Resource, ACPI_RESOURCE_TYPE_ADDRESS64, Level);
 689 
 690     /* Dump the 5 contiguous QWORD values */
 691 
 692     AcpiDmAddressFields (&Resource->Address64.Granularity, 64, Level);
 693 
 694     /* The ResourceSource fields are optional */
 695 
 696     AcpiDmIndent (Level + 1);
 697     AcpiDmResourceSource (Resource, sizeof (AML_RESOURCE_ADDRESS64), Length);
 698 
 699     /* Insert a descriptor name */
 700 
 701     AcpiDmDescriptorName ();
 702 
 703     /* Type-specific flags */
 704 
 705     AcpiDmAddressFlags (Resource);
 706     AcpiOsPrintf (")\n");
 707 }
 708 
 709 
 710 /*******************************************************************************
 711  *
 712  * FUNCTION:    AcpiDmExtendedDescriptor
 713  *
 714  * PARAMETERS:  Resource            - Pointer to the resource descriptor
 715  *              Length              - Length of the descriptor in bytes
 716  *              Level               - Current source code indentation level
 717  *
 718  * RETURN:      None
 719  *
 720  * DESCRIPTION: Decode a Extended Address Space descriptor
 721  *
 722  ******************************************************************************/
 723 
 724 void
 725 AcpiDmExtendedDescriptor (
 726     AML_RESOURCE            *Resource,
 727     UINT32                  Length,
 728     UINT32                  Level)
 729 {
 730 
 731     /* Dump resource name and flags */
 732 
 733     AcpiDmAddressCommon (Resource, ACPI_RESOURCE_TYPE_EXTENDED_ADDRESS64, Level);
 734 
 735     /* Dump the 5 contiguous QWORD values */
 736 
 737     AcpiDmAddressFields (&Resource->ExtAddress64.Granularity, 64, Level);
 738 
 739     /* Extra field for this descriptor only */
 740 
 741     AcpiDmIndent (Level + 1);
 742     AcpiDmDumpInteger64 (Resource->ExtAddress64.TypeSpecific,
 743         "Type-Specific Attributes");
 744 
 745     /* Insert a descriptor name */
 746 
 747     AcpiDmIndent (Level + 1);
 748     AcpiDmDescriptorName ();
 749 
 750     /* Type-specific flags */
 751 
 752     AcpiDmAddressFlags (Resource);
 753     AcpiOsPrintf (")\n");
 754 }
 755 
 756 
 757 /*******************************************************************************
 758  *
 759  * FUNCTION:    AcpiDmMemory24Descriptor
 760  *
 761  * PARAMETERS:  Resource            - Pointer to the resource descriptor
 762  *              Length              - Length of the descriptor in bytes
 763  *              Level               - Current source code indentation level
 764  *
 765  * RETURN:      None
 766  *
 767  * DESCRIPTION: Decode a Memory24 descriptor
 768  *
 769  ******************************************************************************/
 770 
 771 void
 772 AcpiDmMemory24Descriptor (
 773     AML_RESOURCE            *Resource,
 774     UINT32                  Length,
 775     UINT32                  Level)
 776 {
 777 
 778     /* Dump name and read/write flag */
 779 
 780     AcpiDmIndent (Level);
 781     AcpiOsPrintf ("Memory24 (%s,\n",
 782         AcpiGbl_RwDecode [ACPI_GET_1BIT_FLAG (Resource->Memory24.Flags)]);
 783 
 784     /* Dump the 4 contiguous WORD values */
 785 
 786     AcpiDmMemoryFields (&Resource->Memory24.Minimum, 16, Level);
 787 
 788     /* Insert a descriptor name */
 789 
 790     AcpiDmIndent (Level + 1);
 791     AcpiDmDescriptorName ();
 792     AcpiOsPrintf (")\n");
 793 }
 794 
 795 
 796 /*******************************************************************************
 797  *
 798  * FUNCTION:    AcpiDmMemory32Descriptor
 799  *
 800  * PARAMETERS:  Resource            - Pointer to the resource descriptor
 801  *              Length              - Length of the descriptor in bytes
 802  *              Level               - Current source code indentation level
 803  *
 804  * RETURN:      None
 805  *
 806  * DESCRIPTION: Decode a Memory32 descriptor
 807  *
 808  ******************************************************************************/
 809 
 810 void
 811 AcpiDmMemory32Descriptor (
 812     AML_RESOURCE            *Resource,
 813     UINT32                  Length,
 814     UINT32                  Level)
 815 {
 816 
 817     /* Dump name and read/write flag */
 818 
 819     AcpiDmIndent (Level);
 820     AcpiOsPrintf ("Memory32 (%s,\n",
 821         AcpiGbl_RwDecode [ACPI_GET_1BIT_FLAG (Resource->Memory32.Flags)]);
 822 
 823     /* Dump the 4 contiguous DWORD values */
 824 
 825     AcpiDmMemoryFields (&Resource->Memory32.Minimum, 32, Level);
 826 
 827     /* Insert a descriptor name */
 828 
 829     AcpiDmIndent (Level + 1);
 830     AcpiDmDescriptorName ();
 831     AcpiOsPrintf (")\n");
 832 }
 833 
 834 
 835 /*******************************************************************************
 836  *
 837  * FUNCTION:    AcpiDmFixedMemory32Descriptor
 838  *
 839  * PARAMETERS:  Resource            - Pointer to the resource descriptor
 840  *              Length              - Length of the descriptor in bytes
 841  *              Level               - Current source code indentation level
 842  *
 843  * RETURN:      None
 844  *
 845  * DESCRIPTION: Decode a Fixed Memory32 descriptor
 846  *
 847  ******************************************************************************/
 848 
 849 void
 850 AcpiDmFixedMemory32Descriptor (
 851     AML_RESOURCE            *Resource,
 852     UINT32                  Length,
 853     UINT32                  Level)
 854 {
 855 
 856     /* Dump name and read/write flag */
 857 
 858     AcpiDmIndent (Level);
 859     AcpiOsPrintf ("Memory32Fixed (%s,\n",
 860         AcpiGbl_RwDecode [ACPI_GET_1BIT_FLAG (Resource->FixedMemory32.Flags)]);
 861 
 862     AcpiDmIndent (Level + 1);
 863     AcpiDmDumpInteger32 (Resource->FixedMemory32.Address, "Address Base");
 864 
 865     AcpiDmIndent (Level + 1);
 866     AcpiDmDumpInteger32 (Resource->FixedMemory32.AddressLength, "Address Length");
 867 
 868     /* Insert a descriptor name */
 869 
 870     AcpiDmIndent (Level + 1);
 871     AcpiDmDescriptorName ();
 872     AcpiOsPrintf (")\n");
 873 }
 874 
 875 
 876 /*******************************************************************************
 877  *
 878  * FUNCTION:    AcpiDmGenericRegisterDescriptor
 879  *
 880  * PARAMETERS:  Resource            - Pointer to the resource descriptor
 881  *              Length              - Length of the descriptor in bytes
 882  *              Level               - Current source code indentation level
 883  *
 884  * RETURN:      None
 885  *
 886  * DESCRIPTION: Decode a Generic Register descriptor
 887  *
 888  ******************************************************************************/
 889 
 890 void
 891 AcpiDmGenericRegisterDescriptor (
 892     AML_RESOURCE            *Resource,
 893     UINT32                  Length,
 894     UINT32                  Level)
 895 {
 896 
 897     AcpiDmIndent (Level);
 898     AcpiOsPrintf ("Register (");
 899     AcpiDmAddressSpace (Resource->GenericReg.AddressSpaceId);
 900     AcpiOsPrintf ("\n");
 901 
 902     AcpiDmIndent (Level + 1);
 903     AcpiDmDumpInteger8 (Resource->GenericReg.BitWidth, "Bit Width");
 904 
 905     AcpiDmIndent (Level + 1);
 906     AcpiDmDumpInteger8 (Resource->GenericReg.BitOffset, "Bit Offset");
 907 
 908     AcpiDmIndent (Level + 1);
 909     AcpiDmDumpInteger64 (Resource->GenericReg.Address, "Address");
 910 
 911     /* Optional field for ACPI 3.0 */
 912 
 913     AcpiDmIndent (Level + 1);
 914     if (Resource->GenericReg.AccessSize)
 915     {
 916         AcpiOsPrintf ("0x%2.2X,               // %s\n",
 917             Resource->GenericReg.AccessSize, "Access Size");
 918         AcpiDmIndent (Level + 1);
 919     }
 920     else
 921     {
 922         AcpiOsPrintf (",");
 923     }
 924 
 925     /* DescriptorName was added for ACPI 3.0+ */
 926 
 927     AcpiDmDescriptorName ();
 928     AcpiOsPrintf (")\n");
 929 }
 930 
 931 
 932 /*******************************************************************************
 933  *
 934  * FUNCTION:    AcpiDmInterruptDescriptor
 935  *
 936  * PARAMETERS:  Resource            - Pointer to the resource descriptor
 937  *              Length              - Length of the descriptor in bytes
 938  *              Level               - Current source code indentation level
 939  *
 940  * RETURN:      None
 941  *
 942  * DESCRIPTION: Decode a extended Interrupt descriptor
 943  *
 944  ******************************************************************************/
 945 
 946 void
 947 AcpiDmInterruptDescriptor (
 948     AML_RESOURCE            *Resource,
 949     UINT32                  Length,
 950     UINT32                  Level)
 951 {
 952     UINT32                  i;
 953 
 954 
 955     AcpiDmIndent (Level);
 956     AcpiOsPrintf ("Interrupt (%s, %s, %s, %s, ",
 957         AcpiGbl_ConsumeDecode [ACPI_GET_1BIT_FLAG (Resource->ExtendedIrq.Flags)],
 958         AcpiGbl_HeDecode [ACPI_EXTRACT_1BIT_FLAG (Resource->ExtendedIrq.Flags, 1)],
 959         AcpiGbl_LlDecode [ACPI_EXTRACT_1BIT_FLAG (Resource->ExtendedIrq.Flags, 2)],
 960         AcpiGbl_ShrDecode [ACPI_EXTRACT_2BIT_FLAG (Resource->ExtendedIrq.Flags, 3)]);
 961 
 962     /*
 963      * The ResourceSource fields are optional and appear after the interrupt
 964      * list. Must compute length based on length of the list. First xrupt
 965      * is included in the struct (reason for -1 below)
 966      */
 967     AcpiDmResourceSource (Resource,
 968         sizeof (AML_RESOURCE_EXTENDED_IRQ) +
 969             ((UINT32) Resource->ExtendedIrq.InterruptCount - 1) * sizeof (UINT32),
 970         Resource->ExtendedIrq.ResourceLength);
 971 
 972     /* Insert a descriptor name */
 973 
 974     AcpiDmDescriptorName ();
 975     AcpiOsPrintf (")\n");
 976 
 977     /* Dump the interrupt list */
 978 
 979     AcpiDmIndent (Level);
 980     AcpiOsPrintf ("{\n");
 981     for (i = 0; i < Resource->ExtendedIrq.InterruptCount; i++)
 982     {
 983         AcpiDmIndent (Level + 1);
 984         AcpiOsPrintf ("0x%8.8X,\n",
 985             (UINT32) Resource->ExtendedIrq.Interrupts[i]);
 986     }
 987 
 988     AcpiDmIndent (Level);
 989     AcpiOsPrintf ("}\n");
 990 }
 991 
 992 
 993 /*******************************************************************************
 994  *
 995  * FUNCTION:    AcpiDmVendorCommon
 996  *
 997  * PARAMETERS:  Name                - Descriptor name suffix
 998  *              ByteData            - Pointer to the vendor byte data
 999  *              Length              - Length of the byte data
1000  *              Level               - Current source code indentation level
1001  *
1002  * RETURN:      None
1003  *
1004  * DESCRIPTION: Decode a Vendor descriptor, both Large and Small
1005  *
1006  ******************************************************************************/
1007 
1008 void
1009 AcpiDmVendorCommon (
1010     char                    *Name,
1011     UINT8                   *ByteData,
1012     UINT32                  Length,
1013     UINT32                  Level)
1014 {
1015 
1016     /* Dump macro name */
1017 
1018     AcpiDmIndent (Level);
1019     AcpiOsPrintf ("Vendor%s (", Name);
1020 
1021     /* Insert a descriptor name */
1022 
1023     AcpiDmDescriptorName ();
1024     AcpiOsPrintf (")      // Length = 0x%.2X\n", Length);
1025 
1026     /* Dump the vendor bytes */
1027 
1028     AcpiDmIndent (Level);
1029     AcpiOsPrintf ("{\n");
1030 
1031     AcpiDmDisasmByteList (Level + 1, ByteData, Length);
1032 
1033     AcpiDmIndent (Level);
1034     AcpiOsPrintf ("}\n");
1035 }
1036 
1037 
1038 /*******************************************************************************
1039  *
1040  * FUNCTION:    AcpiDmVendorLargeDescriptor
1041  *
1042  * PARAMETERS:  Resource            - Pointer to the resource descriptor
1043  *              Length              - Length of the descriptor in bytes
1044  *              Level               - Current source code indentation level
1045  *
1046  * RETURN:      None
1047  *
1048  * DESCRIPTION: Decode a Vendor Large descriptor
1049  *
1050  ******************************************************************************/
1051 
1052 void
1053 AcpiDmVendorLargeDescriptor (
1054     AML_RESOURCE            *Resource,
1055     UINT32                  Length,
1056     UINT32                  Level)
1057 {
1058 
1059     AcpiDmVendorCommon ("Long ",
1060         ACPI_ADD_PTR (UINT8, Resource, sizeof (AML_RESOURCE_LARGE_HEADER)),
1061         Length, Level);
1062 }
1063 
1064 #endif