1 /*******************************************************************************
3 * Module Name: dmopcode - AML disassembler, specific AML opcodes
5 ******************************************************************************/
7 /******************************************************************************
11 * Some or all of this work - Copyright (c) 1999 - 2010, Intel Corp.
12 * All rights reserved.
16 * 2.1. This is your license from Intel Corp. under its intellectual property
17 * rights. You may have additional license terms from the party that provided
18 * you this software, covering your right to use that party's intellectual
21 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
22 * copy of the source code appearing in this file ("Covered Code") an
23 * irrevocable, perpetual, worldwide license under Intel's copyrights in the
24 * base code distributed originally by Intel ("Original Intel Code") to copy,
25 * make derivatives, distribute, use and display any portion of the Covered
26 * Code in any form, with the right to sublicense such rights; and
28 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
29 * license (with the right to sublicense), under only those claims of Intel
30 * patents that are infringed by the Original Intel Code, to make, use, sell,
31 * offer to sell, and import the Covered Code and derivative works thereof
32 * solely to the minimum extent necessary to exercise the above copyright
33 * license, and in no event shall the patent license extend to any additions
34 * to or modifications of the Original Intel Code. No other license or right
35 * is granted directly or by implication, estoppel or otherwise;
37 * The above copyright and patent license is granted only if the following
42 * 3.1. Redistribution of Source with Rights to Further Distribute Source.
43 * Redistribution of source code of any substantial portion of the Covered
44 * Code or modification with rights to further distribute source must include
45 * the above Copyright Notice, the above License, this list of Conditions,
46 * and the following Disclaimer and Export Compliance provision. In addition,
47 * Licensee must cause all Covered Code to which Licensee contributes to
48 * contain a file documenting the changes Licensee made to create that Covered
49 * Code and the date of any change. Licensee must include in that file the
50 * documentation of any changes made by any predecessor Licensee. Licensee
51 * must include a prominent statement that the modification is derived,
52 * directly or indirectly, from Original Intel Code.
54 * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
55 * Redistribution of source code of any substantial portion of the Covered
56 * Code or modification without rights to further distribute source must
57 * include the following Disclaimer and Export Compliance provision in the
58 * documentation and/or other materials provided with distribution. In
59 * addition, Licensee may not authorize further sublicense of source of any
60 * portion of the Covered Code, and must include terms to the effect that the
61 * license from Licensee to its licensee is limited to the intellectual
62 * property embodied in the software Licensee provides to its licensee, and
63 * not to intellectual property embodied in modifications its licensee may
66 * 3.3. Redistribution of Executable. Redistribution in executable form of any
67 * substantial portion of the Covered Code or modification must reproduce the
68 * above Copyright Notice, and the following Disclaimer and Export Compliance
69 * provision in the documentation and/or other materials provided with the
72 * 3.4. Intel retains all right, title, and interest in and to the Original
75 * 3.5. Neither the name Intel nor any other trademark owned or controlled by
76 * Intel shall be used in advertising or otherwise to promote the sale, use or
77 * other dealings in products derived from or relating to the Covered Code
78 * without prior written authorization from Intel.
80 * 4. Disclaimer and Export Compliance
82 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
83 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
84 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
85 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
86 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
87 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
90 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
91 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
92 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
93 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
94 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
95 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
96 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
99 * 4.3. Licensee shall not export, either directly or indirectly, any of this
100 * software or system incorporating such software without first obtaining any
101 * required license or other approval from the U. S. Department of Commerce or
102 * any other agency or department of the United States Government. In the
103 * event Licensee exports any such software from the United States or
104 * re-exports any such software from a foreign destination, Licensee shall
105 * ensure that the distribution and export/re-export of the software is in
106 * compliance with all laws, regulations, orders, or other restrictions of the
107 * U.S. Export Administration Regulations. Licensee agrees that neither it nor
108 * any of its subsidiaries will export/re-export any technical data, process,
109 * software, or service, directly or indirectly, to any country for which the
110 * United States government or any agency thereof requires an export license,
111 * other governmental approval, or letter of assurance, without first obtaining
112 * such license, approval or letter.
114 *****************************************************************************/
116 #include <contrib/dev/acpica/include/acpi.h>
117 #include <contrib/dev/acpica/include/accommon.h>
118 #include <contrib/dev/acpica/include/acparser.h>
119 #include <contrib/dev/acpica/include/amlcode.h>
120 #include <contrib/dev/acpica/include/acdisasm.h>
122 #ifdef ACPI_DISASSEMBLER
124 #define _COMPONENT ACPI_CA_DEBUGGER
125 ACPI_MODULE_NAME ("dmopcode")
127 /* Local prototypes */
131 ACPI_PARSE_OBJECT *Op);
134 /*******************************************************************************
136 * FUNCTION: AcpiDmMethodFlags
138 * PARAMETERS: Op - Method Object to be examined
142 * DESCRIPTION: Decode control method flags
144 ******************************************************************************/
148 ACPI_PARSE_OBJECT *Op)
154 /* The next Op contains the flags */
156 Op = AcpiPsGetDepthNext (NULL, Op);
157 Flags = (UINT8) Op->Common.Value.Integer;
160 /* Mark the Op as completed */
162 Op->Common.DisasmFlags |= ACPI_PARSEOP_IGNORE;
164 /* 1) Method argument count */
166 AcpiOsPrintf (", %u, ", Args);
168 /* 2) Serialize rule */
172 AcpiOsPrintf ("Not");
175 AcpiOsPrintf ("Serialized");
181 AcpiOsPrintf (", %u", Flags >> 4);
186 /*******************************************************************************
188 * FUNCTION: AcpiDmFieldFlags
190 * PARAMETERS: Op - Field Object to be examined
194 * DESCRIPTION: Decode Field definition flags
196 ******************************************************************************/
200 ACPI_PARSE_OBJECT *Op)
205 Op = Op->Common.Next;
206 Flags = (UINT8) Op->Common.Value.Integer;
208 /* Mark the Op as completed */
210 Op->Common.DisasmFlags |= ACPI_PARSEOP_IGNORE;
212 AcpiOsPrintf ("%s, ", AcpiGbl_AccessTypes [Flags & 0x07]);
213 AcpiOsPrintf ("%s, ", AcpiGbl_LockRule [(Flags & 0x10) >> 4]);
214 AcpiOsPrintf ("%s)", AcpiGbl_UpdateRules [(Flags & 0x60) >> 5]);
218 /*******************************************************************************
220 * FUNCTION: AcpiDmAddressSpace
222 * PARAMETERS: SpaceId - ID to be translated
226 * DESCRIPTION: Decode a SpaceId to an AddressSpaceKeyword
228 ******************************************************************************/
235 if (SpaceId >= ACPI_NUM_PREDEFINED_REGIONS)
239 AcpiOsPrintf ("FFixedHW, ");
243 AcpiOsPrintf ("0x%.2X, ", SpaceId);
248 AcpiOsPrintf ("%s, ", AcpiGbl_RegionTypes [SpaceId]);
253 /*******************************************************************************
255 * FUNCTION: AcpiDmRegionFlags
257 * PARAMETERS: Op - Object to be examined
261 * DESCRIPTION: Decode OperationRegion flags
263 ******************************************************************************/
267 ACPI_PARSE_OBJECT *Op)
271 /* The next Op contains the SpaceId */
273 Op = AcpiPsGetDepthNext (NULL, Op);
275 /* Mark the Op as completed */
277 Op->Common.DisasmFlags |= ACPI_PARSEOP_IGNORE;
280 AcpiDmAddressSpace ((UINT8) Op->Common.Value.Integer);
284 /*******************************************************************************
286 * FUNCTION: AcpiDmMatchOp
288 * PARAMETERS: Op - Match Object to be examined
292 * DESCRIPTION: Decode Match opcode operands
294 ******************************************************************************/
298 ACPI_PARSE_OBJECT *Op)
300 ACPI_PARSE_OBJECT *NextOp;
303 NextOp = AcpiPsGetDepthNext (NULL, Op);
304 NextOp = NextOp->Common.Next;
308 /* Handle partial tree during single-step */
313 /* Mark the two nodes that contain the encoding for the match keywords */
315 NextOp->Common.DisasmOpcode = ACPI_DASM_MATCHOP;
317 NextOp = NextOp->Common.Next;
318 NextOp = NextOp->Common.Next;
319 NextOp->Common.DisasmOpcode = ACPI_DASM_MATCHOP;
323 /*******************************************************************************
325 * FUNCTION: AcpiDmMatchKeyword
327 * PARAMETERS: Op - Match Object to be examined
331 * DESCRIPTION: Decode Match opcode operands
333 ******************************************************************************/
337 ACPI_PARSE_OBJECT *Op)
341 if (((UINT32) Op->Common.Value.Integer) > ACPI_MAX_MATCH_OPCODE)
343 AcpiOsPrintf ("/* Unknown Match Keyword encoding */");
347 AcpiOsPrintf ("%s", ACPI_CAST_PTR (char,
348 AcpiGbl_MatchOps[(ACPI_SIZE) Op->Common.Value.Integer]));
353 /*******************************************************************************
355 * FUNCTION: AcpiDmDisassembleOneOp
357 * PARAMETERS: WalkState - Current walk info
358 * Info - Parse tree walk info
359 * Op - Op that is to be printed
363 * DESCRIPTION: Disassemble a single AML opcode
365 ******************************************************************************/
368 AcpiDmDisassembleOneOp (
369 ACPI_WALK_STATE *WalkState,
370 ACPI_OP_WALK_INFO *Info,
371 ACPI_PARSE_OBJECT *Op)
373 const ACPI_OPCODE_INFO *OpInfo = NULL;
376 ACPI_PARSE_OBJECT *Child;
382 AcpiOsPrintf ("<NULL OP PTR>");
386 switch (Op->Common.DisasmOpcode)
388 case ACPI_DASM_MATCHOP:
390 AcpiDmMatchKeyword (Op);
393 case ACPI_DASM_LNOT_SUFFIX:
394 switch (Op->Common.AmlOpcode)
397 AcpiOsPrintf ("LNotEqual");
400 case AML_LGREATER_OP:
401 AcpiOsPrintf ("LLessEqual");
405 AcpiOsPrintf ("LGreaterEqual");
411 Op->Common.DisasmOpcode = 0;
412 Op->Common.DisasmFlags |= ACPI_PARSEOP_IGNORE;
420 OpInfo = AcpiPsGetOpcodeInfo (Op->Common.AmlOpcode);
422 /* The op and arguments */
424 switch (Op->Common.AmlOpcode)
428 Child = Op->Common.Value.Arg;
429 if ((Child->Common.AmlOpcode == AML_LEQUAL_OP) ||
430 (Child->Common.AmlOpcode == AML_LGREATER_OP) ||
431 (Child->Common.AmlOpcode == AML_LLESS_OP))
433 Child->Common.DisasmOpcode = ACPI_DASM_LNOT_SUFFIX;
434 Op->Common.DisasmOpcode = ACPI_DASM_LNOT_PREFIX;
438 AcpiOsPrintf ("%s", OpInfo->Name);
444 AcpiOsPrintf ("0x%2.2X", (UINT32) Op->Common.Value.Integer);
450 if (Op->Common.DisasmOpcode == ACPI_DASM_EISAID)
452 AcpiDmEisaId ((UINT32) Op->Common.Value.Integer);
456 AcpiOsPrintf ("0x%4.4X", (UINT32) Op->Common.Value.Integer);
463 if (Op->Common.DisasmOpcode == ACPI_DASM_EISAID)
465 AcpiDmEisaId ((UINT32) Op->Common.Value.Integer);
469 AcpiOsPrintf ("0x%8.8X", (UINT32) Op->Common.Value.Integer);
476 AcpiOsPrintf ("0x%8.8X%8.8X",
477 ACPI_FORMAT_UINT64 (Op->Common.Value.Integer));
483 AcpiUtPrintString (Op->Common.Value.String, ACPI_UINT8_MAX);
490 * Determine the type of buffer. We can have one of the following:
492 * 1) ResourceTemplate containing Resource Descriptors.
493 * 2) Unicode String buffer
494 * 3) ASCII String buffer
495 * 4) Raw data buffer (if none of the above)
497 * Since there are no special AML opcodes to differentiate these
498 * types of buffers, we have to closely look at the data in the
499 * buffer to determine the type.
501 Status = AcpiDmIsResourceTemplate (Op);
502 if (ACPI_SUCCESS (Status))
504 Op->Common.DisasmOpcode = ACPI_DASM_RESOURCE;
505 AcpiOsPrintf ("ResourceTemplate");
508 else if (Status == AE_AML_NO_RESOURCE_END_TAG)
510 AcpiOsPrintf ("/**** Is ResourceTemplate, but EndTag not at buffer end ****/ ");
513 if (AcpiDmIsUnicodeBuffer (Op))
515 Op->Common.DisasmOpcode = ACPI_DASM_UNICODE;
516 AcpiOsPrintf ("Unicode (");
518 else if (AcpiDmIsStringBuffer (Op))
520 Op->Common.DisasmOpcode = ACPI_DASM_STRING;
521 AcpiOsPrintf ("Buffer");
525 Op->Common.DisasmOpcode = ACPI_DASM_BUFFER;
526 AcpiOsPrintf ("Buffer");
531 case AML_INT_STATICSTRING_OP:
533 if (Op->Common.Value.String)
535 AcpiOsPrintf ("%s", Op->Common.Value.String);
539 AcpiOsPrintf ("\"<NULL STATIC STRING PTR>\"");
544 case AML_INT_NAMEPATH_OP:
546 AcpiDmNamestring (Op->Common.Value.Name);
550 case AML_INT_NAMEDFIELD_OP:
552 Length = AcpiDmDumpName (Op->Named.Name);
553 AcpiOsPrintf (",%*.s %u", (unsigned) (5 - Length), " ",
554 (UINT32) Op->Common.Value.Integer);
555 AcpiDmCommaIfFieldMember (Op);
557 Info->BitOffset += (UINT32) Op->Common.Value.Integer;
561 case AML_INT_RESERVEDFIELD_OP:
563 /* Offset() -- Must account for previous offsets */
565 Offset = (UINT32) Op->Common.Value.Integer;
566 Info->BitOffset += Offset;
568 if (Info->BitOffset % 8 == 0)
570 AcpiOsPrintf (" Offset (0x%.2X)", ACPI_DIV_8 (Info->BitOffset));
574 AcpiOsPrintf (" , %u", Offset);
577 AcpiDmCommaIfFieldMember (Op);
581 case AML_INT_ACCESSFIELD_OP:
583 AcpiOsPrintf (" AccessAs (%s, ",
584 AcpiGbl_AccessTypes [(UINT32) (Op->Common.Value.Integer >> 8) & 0x7]);
586 AcpiDmDecodeAttribute ((UINT8) Op->Common.Value.Integer);
588 AcpiDmCommaIfFieldMember (Op);
592 case AML_INT_BYTELIST_OP:
594 AcpiDmByteList (Info, Op);
598 case AML_INT_METHODCALL_OP:
600 Op = AcpiPsGetDepthNext (NULL, Op);
601 Op->Common.DisasmFlags |= ACPI_PARSEOP_IGNORE;
603 AcpiDmNamestring (Op->Common.Value.Name);
609 /* Just get the opcode name and print it */
611 AcpiOsPrintf ("%s", OpInfo->Name);
616 if ((Op->Common.AmlOpcode == AML_INT_RETURN_VALUE_OP) &&
618 (WalkState->Results) &&
619 (WalkState->ResultCount))
621 AcpiDmDecodeInternalObject (
622 WalkState->Results->Results.ObjDesc [
623 (WalkState->ResultCount - 1) %
624 ACPI_RESULTS_FRAME_OBJ_NUM]);
632 #endif /* ACPI_DISASSEMBLER */