1 /*******************************************************************************
3 * Module Name: dmutils - AML disassembler utilities
5 ******************************************************************************/
8 * Copyright (C) 2000 - 2013, Intel Corp.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
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.
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.
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.
45 #include <contrib/dev/acpica/include/acpi.h>
46 #include <contrib/dev/acpica/include/accommon.h>
47 #include <contrib/dev/acpica/include/amlcode.h>
48 #include <contrib/dev/acpica/include/acdisasm.h>
50 #ifdef ACPI_ASL_COMPILER
51 #include <contrib/dev/acpica/include/acnamesp.h>
54 #ifdef ACPI_DISASSEMBLER
56 #define _COMPONENT ACPI_CA_DEBUGGER
57 ACPI_MODULE_NAME ("dmutils")
60 /* Data used in keeping track of fields */
62 const char *AcpiGbl_FENames[] =
66 }; /* FE = Field Element */
69 /* Operators for Match() */
71 const char *AcpiGbl_MatchOps[] =
81 /* Access type decoding */
83 const char *AcpiGbl_AccessTypes[] =
95 /* Lock rule decoding */
97 const char *AcpiGbl_LockRule[] =
103 /* Update rule decoding */
105 const char *AcpiGbl_UpdateRules[] =
113 /* Strings used to decode resource descriptors */
115 const char *AcpiGbl_WordDecode[] =
120 "UnknownResourceType"
123 const char *AcpiGbl_IrqDecode[] =
130 /*******************************************************************************
132 * FUNCTION: AcpiDmDecodeAttribute
134 * PARAMETERS: Attribute - Attribute field of AccessAs keyword
138 * DESCRIPTION: Decode the AccessAs attribute byte. (Mostly SMBus and
139 * GenericSerialBus stuff.)
141 ******************************************************************************/
144 AcpiDmDecodeAttribute (
150 case AML_FIELD_ATTRIB_QUICK:
152 AcpiOsPrintf ("AttribQuick");
155 case AML_FIELD_ATTRIB_SEND_RCV:
157 AcpiOsPrintf ("AttribSendReceive");
160 case AML_FIELD_ATTRIB_BYTE:
162 AcpiOsPrintf ("AttribByte");
165 case AML_FIELD_ATTRIB_WORD:
167 AcpiOsPrintf ("AttribWord");
170 case AML_FIELD_ATTRIB_BLOCK:
172 AcpiOsPrintf ("AttribBlock");
175 case AML_FIELD_ATTRIB_MULTIBYTE:
177 AcpiOsPrintf ("AttribBytes");
180 case AML_FIELD_ATTRIB_WORD_CALL:
182 AcpiOsPrintf ("AttribProcessCall");
185 case AML_FIELD_ATTRIB_BLOCK_CALL:
187 AcpiOsPrintf ("AttribBlockProcessCall");
190 case AML_FIELD_ATTRIB_RAW_BYTES:
192 AcpiOsPrintf ("AttribRawBytes");
195 case AML_FIELD_ATTRIB_RAW_PROCESS:
197 AcpiOsPrintf ("AttribRawProcessBytes");
202 /* A ByteConst is allowed by the grammar */
204 AcpiOsPrintf ("0x%2.2X", Attribute);
210 /*******************************************************************************
212 * FUNCTION: AcpiDmIndent
214 * PARAMETERS: Level - Current source code indentation level
218 * DESCRIPTION: Indent 4 spaces per indentation level.
220 ******************************************************************************/
232 AcpiOsPrintf ("%*.s", ACPI_MUL_4 (Level), " ");
236 /*******************************************************************************
238 * FUNCTION: AcpiDmCommaIfListMember
240 * PARAMETERS: Op - Current operator/operand
242 * RETURN: TRUE if a comma was inserted
244 * DESCRIPTION: Insert a comma if this Op is a member of an argument list.
246 ******************************************************************************/
249 AcpiDmCommaIfListMember (
250 ACPI_PARSE_OBJECT *Op)
253 if (!Op->Common.Next)
258 if (AcpiDmListType (Op->Common.Parent) & BLOCK_COMMA_LIST)
260 /* Check for a NULL target operand */
262 if ((Op->Common.Next->Common.AmlOpcode == AML_INT_NAMEPATH_OP) &&
263 (!Op->Common.Next->Common.Value.String))
266 * To handle the Divide() case where there are two optional
267 * targets, look ahead one more op. If null, this null target
268 * is the one and only target -- no comma needed. Otherwise,
269 * we need a comma to prepare for the next target.
271 if (!Op->Common.Next->Common.Next)
277 if ((Op->Common.DisasmFlags & ACPI_PARSEOP_PARAMLIST) &&
278 (!(Op->Common.Next->Common.DisasmFlags & ACPI_PARSEOP_PARAMLIST)))
287 else if ((Op->Common.DisasmFlags & ACPI_PARSEOP_PARAMLIST) &&
288 (Op->Common.Next->Common.DisasmFlags & ACPI_PARSEOP_PARAMLIST))
298 /*******************************************************************************
300 * FUNCTION: AcpiDmCommaIfFieldMember
302 * PARAMETERS: Op - Current operator/operand
306 * DESCRIPTION: Insert a comma if this Op is a member of a Field argument list.
308 ******************************************************************************/
311 AcpiDmCommaIfFieldMember (
312 ACPI_PARSE_OBJECT *Op)