dmutils.c revision 1.1.1.2.2.2
1 1.1.1.2.2.2 bouyer /******************************************************************************* 2 1.1.1.2.2.2 bouyer * 3 1.1.1.2.2.2 bouyer * Module Name: dmutils - AML disassembler utilities 4 1.1.1.2.2.2 bouyer * 5 1.1.1.2.2.2 bouyer ******************************************************************************/ 6 1.1.1.2.2.2 bouyer 7 1.1.1.2.2.2 bouyer /* 8 1.1.1.2.2.2 bouyer * Copyright (C) 2000 - 2011, Intel Corp. 9 1.1.1.2.2.2 bouyer * All rights reserved. 10 1.1.1.2.2.2 bouyer * 11 1.1.1.2.2.2 bouyer * Redistribution and use in source and binary forms, with or without 12 1.1.1.2.2.2 bouyer * modification, are permitted provided that the following conditions 13 1.1.1.2.2.2 bouyer * are met: 14 1.1.1.2.2.2 bouyer * 1. Redistributions of source code must retain the above copyright 15 1.1.1.2.2.2 bouyer * notice, this list of conditions, and the following disclaimer, 16 1.1.1.2.2.2 bouyer * without modification. 17 1.1.1.2.2.2 bouyer * 2. Redistributions in binary form must reproduce at minimum a disclaimer 18 1.1.1.2.2.2 bouyer * substantially similar to the "NO WARRANTY" disclaimer below 19 1.1.1.2.2.2 bouyer * ("Disclaimer") and any redistribution must be conditioned upon 20 1.1.1.2.2.2 bouyer * including a substantially similar Disclaimer requirement for further 21 1.1.1.2.2.2 bouyer * binary redistribution. 22 1.1.1.2.2.2 bouyer * 3. Neither the names of the above-listed copyright holders nor the names 23 1.1.1.2.2.2 bouyer * of any contributors may be used to endorse or promote products derived 24 1.1.1.2.2.2 bouyer * from this software without specific prior written permission. 25 1.1.1.2.2.2 bouyer * 26 1.1.1.2.2.2 bouyer * Alternatively, this software may be distributed under the terms of the 27 1.1.1.2.2.2 bouyer * GNU General Public License ("GPL") version 2 as published by the Free 28 1.1.1.2.2.2 bouyer * Software Foundation. 29 1.1.1.2.2.2 bouyer * 30 1.1.1.2.2.2 bouyer * NO WARRANTY 31 1.1.1.2.2.2 bouyer * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 32 1.1.1.2.2.2 bouyer * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 33 1.1.1.2.2.2 bouyer * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR 34 1.1.1.2.2.2 bouyer * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 35 1.1.1.2.2.2 bouyer * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 36 1.1.1.2.2.2 bouyer * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 37 1.1.1.2.2.2 bouyer * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 38 1.1.1.2.2.2 bouyer * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 39 1.1.1.2.2.2 bouyer * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 40 1.1.1.2.2.2 bouyer * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 41 1.1.1.2.2.2 bouyer * POSSIBILITY OF SUCH DAMAGES. 42 1.1.1.2.2.2 bouyer */ 43 1.1.1.2.2.2 bouyer 44 1.1.1.2.2.2 bouyer 45 1.1.1.2.2.2 bouyer #include "acpi.h" 46 1.1.1.2.2.2 bouyer #include "accommon.h" 47 1.1.1.2.2.2 bouyer #include "amlcode.h" 48 1.1.1.2.2.2 bouyer #include "acdisasm.h" 49 1.1.1.2.2.2 bouyer 50 1.1.1.2.2.2 bouyer #ifdef ACPI_ASL_COMPILER 51 1.1.1.2.2.2 bouyer #include <acnamesp.h> 52 1.1.1.2.2.2 bouyer #endif 53 1.1.1.2.2.2 bouyer 54 1.1.1.2.2.2 bouyer #ifdef ACPI_DISASSEMBLER 55 1.1.1.2.2.2 bouyer 56 1.1.1.2.2.2 bouyer #define _COMPONENT ACPI_CA_DEBUGGER 57 1.1.1.2.2.2 bouyer ACPI_MODULE_NAME ("dmutils") 58 1.1.1.2.2.2 bouyer 59 1.1.1.2.2.2 bouyer 60 1.1.1.2.2.2 bouyer /* Data used in keeping track of fields */ 61 1.1.1.2.2.2 bouyer #if 0 62 1.1.1.2.2.2 bouyer const char *AcpiGbl_FENames[] = 63 1.1.1.2.2.2 bouyer { 64 1.1.1.2.2.2 bouyer "skip", 65 1.1.1.2.2.2 bouyer "?access?" 66 1.1.1.2.2.2 bouyer }; /* FE = Field Element */ 67 1.1.1.2.2.2 bouyer #endif 68 1.1.1.2.2.2 bouyer 69 1.1.1.2.2.2 bouyer /* Operators for Match() */ 70 1.1.1.2.2.2 bouyer 71 1.1.1.2.2.2 bouyer const char *AcpiGbl_MatchOps[] = 72 1.1.1.2.2.2 bouyer { 73 1.1.1.2.2.2 bouyer "MTR", 74 1.1.1.2.2.2 bouyer "MEQ", 75 1.1.1.2.2.2 bouyer "MLE", 76 1.1.1.2.2.2 bouyer "MLT", 77 1.1.1.2.2.2 bouyer "MGE", 78 1.1.1.2.2.2 bouyer "MGT" 79 1.1.1.2.2.2 bouyer }; 80 1.1.1.2.2.2 bouyer 81 1.1.1.2.2.2 bouyer /* Access type decoding */ 82 1.1.1.2.2.2 bouyer 83 1.1.1.2.2.2 bouyer const char *AcpiGbl_AccessTypes[] = 84 1.1.1.2.2.2 bouyer { 85 1.1.1.2.2.2 bouyer "AnyAcc", 86 1.1.1.2.2.2 bouyer "ByteAcc", 87 1.1.1.2.2.2 bouyer "WordAcc", 88 1.1.1.2.2.2 bouyer "DWordAcc", 89 1.1.1.2.2.2 bouyer "QWordAcc", 90 1.1.1.2.2.2 bouyer "BufferAcc", 91 1.1.1.2.2.2 bouyer "InvalidAccType", 92 1.1.1.2.2.2 bouyer "InvalidAccType" 93 1.1.1.2.2.2 bouyer }; 94 1.1.1.2.2.2 bouyer 95 1.1.1.2.2.2 bouyer /* Lock rule decoding */ 96 1.1.1.2.2.2 bouyer 97 1.1.1.2.2.2 bouyer const char *AcpiGbl_LockRule[] = 98 1.1.1.2.2.2 bouyer { 99 1.1.1.2.2.2 bouyer "NoLock", 100 1.1.1.2.2.2 bouyer "Lock" 101 1.1.1.2.2.2 bouyer }; 102 1.1.1.2.2.2 bouyer 103 1.1.1.2.2.2 bouyer /* Update rule decoding */ 104 1.1.1.2.2.2 bouyer 105 1.1.1.2.2.2 bouyer const char *AcpiGbl_UpdateRules[] = 106 1.1.1.2.2.2 bouyer { 107 1.1.1.2.2.2 bouyer "Preserve", 108 1.1.1.2.2.2 bouyer "WriteAsOnes", 109 1.1.1.2.2.2 bouyer "WriteAsZeros", 110 1.1.1.2.2.2 bouyer "InvalidUpdateRule" 111 1.1.1.2.2.2 bouyer }; 112 1.1.1.2.2.2 bouyer 113 1.1.1.2.2.2 bouyer /* Strings used to decode resource descriptors */ 114 1.1.1.2.2.2 bouyer 115 1.1.1.2.2.2 bouyer const char *AcpiGbl_WordDecode[] = 116 1.1.1.2.2.2 bouyer { 117 1.1.1.2.2.2 bouyer "Memory", 118 1.1.1.2.2.2 bouyer "IO", 119 1.1.1.2.2.2 bouyer "BusNumber", 120 1.1.1.2.2.2 bouyer "UnknownResourceType" 121 1.1.1.2.2.2 bouyer }; 122 1.1.1.2.2.2 bouyer 123 1.1.1.2.2.2 bouyer const char *AcpiGbl_IrqDecode[] = 124 1.1.1.2.2.2 bouyer { 125 1.1.1.2.2.2 bouyer "IRQNoFlags", 126 1.1.1.2.2.2 bouyer "IRQ" 127 1.1.1.2.2.2 bouyer }; 128 1.1.1.2.2.2 bouyer 129 1.1.1.2.2.2 bouyer 130 1.1.1.2.2.2 bouyer /******************************************************************************* 131 1.1.1.2.2.2 bouyer * 132 1.1.1.2.2.2 bouyer * FUNCTION: AcpiDmDecodeAttribute 133 1.1.1.2.2.2 bouyer * 134 1.1.1.2.2.2 bouyer * PARAMETERS: Attribute - Attribute field of AccessAs keyword 135 1.1.1.2.2.2 bouyer * 136 1.1.1.2.2.2 bouyer * RETURN: None 137 1.1.1.2.2.2 bouyer * 138 1.1.1.2.2.2 bouyer * DESCRIPTION: Decode the AccessAs attribute byte. (Mostly SMBus stuff) 139 1.1.1.2.2.2 bouyer * 140 1.1.1.2.2.2 bouyer ******************************************************************************/ 141 1.1.1.2.2.2 bouyer 142 1.1.1.2.2.2 bouyer void 143 1.1.1.2.2.2 bouyer AcpiDmDecodeAttribute ( 144 1.1.1.2.2.2 bouyer UINT8 Attribute) 145 1.1.1.2.2.2 bouyer { 146 1.1.1.2.2.2 bouyer 147 1.1.1.2.2.2 bouyer switch (Attribute) 148 1.1.1.2.2.2 bouyer { 149 1.1.1.2.2.2 bouyer case AML_FIELD_ATTRIB_SMB_QUICK: 150 1.1.1.2.2.2 bouyer 151 1.1.1.2.2.2 bouyer AcpiOsPrintf ("SMBQuick"); 152 1.1.1.2.2.2 bouyer break; 153 1.1.1.2.2.2 bouyer 154 1.1.1.2.2.2 bouyer case AML_FIELD_ATTRIB_SMB_SEND_RCV: 155 1.1.1.2.2.2 bouyer 156 1.1.1.2.2.2 bouyer AcpiOsPrintf ("SMBSendReceive"); 157 1.1.1.2.2.2 bouyer break; 158 1.1.1.2.2.2 bouyer 159 1.1.1.2.2.2 bouyer case AML_FIELD_ATTRIB_SMB_BYTE: 160 1.1.1.2.2.2 bouyer 161 1.1.1.2.2.2 bouyer AcpiOsPrintf ("SMBByte"); 162 1.1.1.2.2.2 bouyer break; 163 1.1.1.2.2.2 bouyer 164 1.1.1.2.2.2 bouyer case AML_FIELD_ATTRIB_SMB_WORD: 165 1.1.1.2.2.2 bouyer 166 1.1.1.2.2.2 bouyer AcpiOsPrintf ("SMBWord"); 167 1.1.1.2.2.2 bouyer break; 168 1.1.1.2.2.2 bouyer 169 1.1.1.2.2.2 bouyer case AML_FIELD_ATTRIB_SMB_WORD_CALL: 170 1.1.1.2.2.2 bouyer 171 1.1.1.2.2.2 bouyer AcpiOsPrintf ("SMBProcessCall"); 172 1.1.1.2.2.2 bouyer break; 173 1.1.1.2.2.2 bouyer 174 1.1.1.2.2.2 bouyer case AML_FIELD_ATTRIB_SMB_BLOCK: 175 1.1.1.2.2.2 bouyer 176 1.1.1.2.2.2 bouyer AcpiOsPrintf ("SMBBlock"); 177 1.1.1.2.2.2 bouyer break; 178 1.1.1.2.2.2 bouyer 179 1.1.1.2.2.2 bouyer case AML_FIELD_ATTRIB_SMB_BLOCK_CALL: 180 1.1.1.2.2.2 bouyer 181 1.1.1.2.2.2 bouyer AcpiOsPrintf ("SMBBlockProcessCall"); 182 1.1.1.2.2.2 bouyer break; 183 1.1.1.2.2.2 bouyer 184 1.1.1.2.2.2 bouyer default: 185 1.1.1.2.2.2 bouyer 186 1.1.1.2.2.2 bouyer AcpiOsPrintf ("0x%.2X", Attribute); 187 1.1.1.2.2.2 bouyer break; 188 1.1.1.2.2.2 bouyer } 189 1.1.1.2.2.2 bouyer } 190 1.1.1.2.2.2 bouyer 191 1.1.1.2.2.2 bouyer 192 1.1.1.2.2.2 bouyer /******************************************************************************* 193 1.1.1.2.2.2 bouyer * 194 1.1.1.2.2.2 bouyer * FUNCTION: AcpiDmIndent 195 1.1.1.2.2.2 bouyer * 196 1.1.1.2.2.2 bouyer * PARAMETERS: Level - Current source code indentation level 197 1.1.1.2.2.2 bouyer * 198 1.1.1.2.2.2 bouyer * RETURN: None 199 1.1.1.2.2.2 bouyer * 200 1.1.1.2.2.2 bouyer * DESCRIPTION: Indent 4 spaces per indentation level. 201 1.1.1.2.2.2 bouyer * 202 1.1.1.2.2.2 bouyer ******************************************************************************/ 203 1.1.1.2.2.2 bouyer 204 1.1.1.2.2.2 bouyer void 205 1.1.1.2.2.2 bouyer AcpiDmIndent ( 206 1.1.1.2.2.2 bouyer UINT32 Level) 207 1.1.1.2.2.2 bouyer { 208 1.1.1.2.2.2 bouyer 209 1.1.1.2.2.2 bouyer if (!Level) 210 1.1.1.2.2.2 bouyer { 211 1.1.1.2.2.2 bouyer return; 212 1.1.1.2.2.2 bouyer } 213 1.1.1.2.2.2 bouyer 214 1.1.1.2.2.2 bouyer AcpiOsPrintf ("%*.s", ACPI_MUL_4 (Level), " "); 215 1.1.1.2.2.2 bouyer } 216 1.1.1.2.2.2 bouyer 217 1.1.1.2.2.2 bouyer 218 1.1.1.2.2.2 bouyer /******************************************************************************* 219 1.1.1.2.2.2 bouyer * 220 1.1.1.2.2.2 bouyer * FUNCTION: AcpiDmCommaIfListMember 221 1.1.1.2.2.2 bouyer * 222 1.1.1.2.2.2 bouyer * PARAMETERS: Op - Current operator/operand 223 1.1.1.2.2.2 bouyer * 224 1.1.1.2.2.2 bouyer * RETURN: TRUE if a comma was inserted 225 1.1.1.2.2.2 bouyer * 226 1.1.1.2.2.2 bouyer * DESCRIPTION: Insert a comma if this Op is a member of an argument list. 227 1.1.1.2.2.2 bouyer * 228 1.1.1.2.2.2 bouyer ******************************************************************************/ 229 1.1.1.2.2.2 bouyer 230 1.1.1.2.2.2 bouyer BOOLEAN 231 1.1.1.2.2.2 bouyer AcpiDmCommaIfListMember ( 232 1.1.1.2.2.2 bouyer ACPI_PARSE_OBJECT *Op) 233 1.1.1.2.2.2 bouyer { 234 1.1.1.2.2.2 bouyer 235 1.1.1.2.2.2 bouyer if (!Op->Common.Next) 236 1.1.1.2.2.2 bouyer { 237 1.1.1.2.2.2 bouyer return FALSE; 238 1.1.1.2.2.2 bouyer } 239 1.1.1.2.2.2 bouyer 240 1.1.1.2.2.2 bouyer if (AcpiDmListType (Op->Common.Parent) & BLOCK_COMMA_LIST) 241 1.1.1.2.2.2 bouyer { 242 1.1.1.2.2.2 bouyer /* Check for a NULL target operand */ 243 1.1.1.2.2.2 bouyer 244 1.1.1.2.2.2 bouyer if ((Op->Common.Next->Common.AmlOpcode == AML_INT_NAMEPATH_OP) && 245 1.1.1.2.2.2 bouyer (!Op->Common.Next->Common.Value.String)) 246 1.1.1.2.2.2 bouyer { 247 1.1.1.2.2.2 bouyer /* 248 1.1.1.2.2.2 bouyer * To handle the Divide() case where there are two optional 249 1.1.1.2.2.2 bouyer * targets, look ahead one more op. If null, this null target 250 1.1.1.2.2.2 bouyer * is the one and only target -- no comma needed. Otherwise, 251 1.1.1.2.2.2 bouyer * we need a comma to prepare for the next target. 252 1.1.1.2.2.2 bouyer */ 253 1.1.1.2.2.2 bouyer if (!Op->Common.Next->Common.Next) 254 1.1.1.2.2.2 bouyer { 255 1.1.1.2.2.2 bouyer return FALSE; 256 1.1.1.2.2.2 bouyer } 257 1.1.1.2.2.2 bouyer } 258 1.1.1.2.2.2 bouyer 259 1.1.1.2.2.2 bouyer if ((Op->Common.DisasmFlags & ACPI_PARSEOP_PARAMLIST) && 260 1.1.1.2.2.2 bouyer (!(Op->Common.Next->Common.DisasmFlags & ACPI_PARSEOP_PARAMLIST))) 261 1.1.1.2.2.2 bouyer { 262 1.1.1.2.2.2 bouyer return FALSE; 263 1.1.1.2.2.2 bouyer } 264 1.1.1.2.2.2 bouyer 265 1.1.1.2.2.2 bouyer AcpiOsPrintf (", "); 266 1.1.1.2.2.2 bouyer return (TRUE); 267 1.1.1.2.2.2 bouyer } 268 1.1.1.2.2.2 bouyer 269 1.1.1.2.2.2 bouyer else if ((Op->Common.DisasmFlags & ACPI_PARSEOP_PARAMLIST) && 270 1.1.1.2.2.2 bouyer (Op->Common.Next->Common.DisasmFlags & ACPI_PARSEOP_PARAMLIST)) 271 1.1.1.2.2.2 bouyer { 272 1.1.1.2.2.2 bouyer AcpiOsPrintf (", "); 273 1.1.1.2.2.2 bouyer return (TRUE); 274 1.1.1.2.2.2 bouyer } 275 1.1.1.2.2.2 bouyer 276 1.1.1.2.2.2 bouyer return (FALSE); 277 1.1.1.2.2.2 bouyer } 278 1.1.1.2.2.2 bouyer 279 1.1.1.2.2.2 bouyer 280 1.1.1.2.2.2 bouyer /******************************************************************************* 281 1.1.1.2.2.2 bouyer * 282 1.1.1.2.2.2 bouyer * FUNCTION: AcpiDmCommaIfFieldMember 283 1.1.1.2.2.2 bouyer * 284 1.1.1.2.2.2 bouyer * PARAMETERS: Op - Current operator/operand 285 1.1.1.2.2.2 bouyer * 286 1.1.1.2.2.2 bouyer * RETURN: None 287 1.1.1.2.2.2 bouyer * 288 1.1.1.2.2.2 bouyer * DESCRIPTION: Insert a comma if this Op is a member of a Field argument list. 289 1.1.1.2.2.2 bouyer * 290 1.1.1.2.2.2 bouyer ******************************************************************************/ 291 1.1.1.2.2.2 bouyer 292 1.1.1.2.2.2 bouyer void 293 1.1.1.2.2.2 bouyer AcpiDmCommaIfFieldMember ( 294 1.1.1.2.2.2 bouyer ACPI_PARSE_OBJECT *Op) 295 1.1.1.2.2.2 bouyer { 296 1.1.1.2.2.2 bouyer 297 1.1.1.2.2.2 bouyer if (Op->Common.Next) 298 1.1.1.2.2.2 bouyer { 299 1.1.1.2.2.2 bouyer AcpiOsPrintf (", "); 300 1.1.1.2.2.2 bouyer } 301 1.1.1.2.2.2 bouyer } 302 1.1.1.2.2.2 bouyer 303 1.1.1.2.2.2 bouyer #endif 304
Indexes created Tue Sep 30 07:10:03 GMT 2025