exutils.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 * 4 1.1.1.2.2.2 bouyer * Module Name: exutils - interpreter/scanner utilities 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 /* 9 1.1.1.2.2.2 bouyer * Copyright (C) 2000 - 2011, Intel Corp. 10 1.1.1.2.2.2 bouyer * All rights reserved. 11 1.1.1.2.2.2 bouyer * 12 1.1.1.2.2.2 bouyer * Redistribution and use in source and binary forms, with or without 13 1.1.1.2.2.2 bouyer * modification, are permitted provided that the following conditions 14 1.1.1.2.2.2 bouyer * are met: 15 1.1.1.2.2.2 bouyer * 1. Redistributions of source code must retain the above copyright 16 1.1.1.2.2.2 bouyer * notice, this list of conditions, and the following disclaimer, 17 1.1.1.2.2.2 bouyer * without modification. 18 1.1.1.2.2.2 bouyer * 2. Redistributions in binary form must reproduce at minimum a disclaimer 19 1.1.1.2.2.2 bouyer * substantially similar to the "NO WARRANTY" disclaimer below 20 1.1.1.2.2.2 bouyer * ("Disclaimer") and any redistribution must be conditioned upon 21 1.1.1.2.2.2 bouyer * including a substantially similar Disclaimer requirement for further 22 1.1.1.2.2.2 bouyer * binary redistribution. 23 1.1.1.2.2.2 bouyer * 3. Neither the names of the above-listed copyright holders nor the names 24 1.1.1.2.2.2 bouyer * of any contributors may be used to endorse or promote products derived 25 1.1.1.2.2.2 bouyer * from this software without specific prior written permission. 26 1.1.1.2.2.2 bouyer * 27 1.1.1.2.2.2 bouyer * Alternatively, this software may be distributed under the terms of the 28 1.1.1.2.2.2 bouyer * GNU General Public License ("GPL") version 2 as published by the Free 29 1.1.1.2.2.2 bouyer * Software Foundation. 30 1.1.1.2.2.2 bouyer * 31 1.1.1.2.2.2 bouyer * NO WARRANTY 32 1.1.1.2.2.2 bouyer * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 33 1.1.1.2.2.2 bouyer * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 34 1.1.1.2.2.2 bouyer * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR 35 1.1.1.2.2.2 bouyer * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 36 1.1.1.2.2.2 bouyer * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 37 1.1.1.2.2.2 bouyer * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 38 1.1.1.2.2.2 bouyer * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 39 1.1.1.2.2.2 bouyer * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 40 1.1.1.2.2.2 bouyer * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 41 1.1.1.2.2.2 bouyer * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 42 1.1.1.2.2.2 bouyer * POSSIBILITY OF SUCH DAMAGES. 43 1.1.1.2.2.2 bouyer */ 44 1.1.1.2.2.2 bouyer 45 1.1.1.2.2.2 bouyer #define __EXUTILS_C__ 46 1.1.1.2.2.2 bouyer 47 1.1.1.2.2.2 bouyer /* 48 1.1.1.2.2.2 bouyer * DEFINE_AML_GLOBALS is tested in amlcode.h 49 1.1.1.2.2.2 bouyer * to determine whether certain global names should be "defined" or only 50 1.1.1.2.2.2 bouyer * "declared" in the current compilation. This enhances maintainability 51 1.1.1.2.2.2 bouyer * by enabling a single header file to embody all knowledge of the names 52 1.1.1.2.2.2 bouyer * in question. 53 1.1.1.2.2.2 bouyer * 54 1.1.1.2.2.2 bouyer * Exactly one module of any executable should #define DEFINE_GLOBALS 55 1.1.1.2.2.2 bouyer * before #including the header files which use this convention. The 56 1.1.1.2.2.2 bouyer * names in question will be defined and initialized in that module, 57 1.1.1.2.2.2 bouyer * and declared as extern in all other modules which #include those 58 1.1.1.2.2.2 bouyer * header files. 59 1.1.1.2.2.2 bouyer */ 60 1.1.1.2.2.2 bouyer 61 1.1.1.2.2.2 bouyer #define DEFINE_AML_GLOBALS 62 1.1.1.2.2.2 bouyer 63 1.1.1.2.2.2 bouyer #include "acpi.h" 64 1.1.1.2.2.2 bouyer #include "accommon.h" 65 1.1.1.2.2.2 bouyer #include "acinterp.h" 66 1.1.1.2.2.2 bouyer #include "amlcode.h" 67 1.1.1.2.2.2 bouyer 68 1.1.1.2.2.2 bouyer #define _COMPONENT ACPI_EXECUTER 69 1.1.1.2.2.2 bouyer ACPI_MODULE_NAME ("exutils") 70 1.1.1.2.2.2 bouyer 71 1.1.1.2.2.2 bouyer /* Local prototypes */ 72 1.1.1.2.2.2 bouyer 73 1.1.1.2.2.2 bouyer static UINT32 74 1.1.1.2.2.2 bouyer AcpiExDigitsNeeded ( 75 1.1.1.2.2.2 bouyer UINT64 Value, 76 1.1.1.2.2.2 bouyer UINT32 Base); 77 1.1.1.2.2.2 bouyer 78 1.1.1.2.2.2 bouyer 79 1.1.1.2.2.2 bouyer #ifndef ACPI_NO_METHOD_EXECUTION 80 1.1.1.2.2.2 bouyer /******************************************************************************* 81 1.1.1.2.2.2 bouyer * 82 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExEnterInterpreter 83 1.1.1.2.2.2 bouyer * 84 1.1.1.2.2.2 bouyer * PARAMETERS: None 85 1.1.1.2.2.2 bouyer * 86 1.1.1.2.2.2 bouyer * RETURN: None 87 1.1.1.2.2.2 bouyer * 88 1.1.1.2.2.2 bouyer * DESCRIPTION: Enter the interpreter execution region. Failure to enter 89 1.1.1.2.2.2 bouyer * the interpreter region is a fatal system error. Used in 90 1.1.1.2.2.2 bouyer * conjunction with ExitInterpreter. 91 1.1.1.2.2.2 bouyer * 92 1.1.1.2.2.2 bouyer ******************************************************************************/ 93 1.1.1.2.2.2 bouyer 94 1.1.1.2.2.2 bouyer void 95 1.1.1.2.2.2 bouyer AcpiExEnterInterpreter ( 96 1.1.1.2.2.2 bouyer void) 97 1.1.1.2.2.2 bouyer { 98 1.1.1.2.2.2 bouyer ACPI_STATUS Status; 99 1.1.1.2.2.2 bouyer 100 1.1.1.2.2.2 bouyer 101 1.1.1.2.2.2 bouyer ACPI_FUNCTION_TRACE (ExEnterInterpreter); 102 1.1.1.2.2.2 bouyer 103 1.1.1.2.2.2 bouyer 104 1.1.1.2.2.2 bouyer Status = AcpiUtAcquireMutex (ACPI_MTX_INTERPRETER); 105 1.1.1.2.2.2 bouyer if (ACPI_FAILURE (Status)) 106 1.1.1.2.2.2 bouyer { 107 1.1.1.2.2.2 bouyer ACPI_ERROR ((AE_INFO, "Could not acquire AML Interpreter mutex")); 108 1.1.1.2.2.2 bouyer } 109 1.1.1.2.2.2 bouyer 110 1.1.1.2.2.2 bouyer return_VOID; 111 1.1.1.2.2.2 bouyer } 112 1.1.1.2.2.2 bouyer 113 1.1.1.2.2.2 bouyer 114 1.1.1.2.2.2 bouyer /******************************************************************************* 115 1.1.1.2.2.2 bouyer * 116 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExReacquireInterpreter 117 1.1.1.2.2.2 bouyer * 118 1.1.1.2.2.2 bouyer * PARAMETERS: None 119 1.1.1.2.2.2 bouyer * 120 1.1.1.2.2.2 bouyer * RETURN: None 121 1.1.1.2.2.2 bouyer * 122 1.1.1.2.2.2 bouyer * DESCRIPTION: Reacquire the interpreter execution region from within the 123 1.1.1.2.2.2 bouyer * interpreter code. Failure to enter the interpreter region is a 124 1.1.1.2.2.2 bouyer * fatal system error. Used in conjuction with 125 1.1.1.2.2.2 bouyer * RelinquishInterpreter 126 1.1.1.2.2.2 bouyer * 127 1.1.1.2.2.2 bouyer ******************************************************************************/ 128 1.1.1.2.2.2 bouyer 129 1.1.1.2.2.2 bouyer void 130 1.1.1.2.2.2 bouyer AcpiExReacquireInterpreter ( 131 1.1.1.2.2.2 bouyer void) 132 1.1.1.2.2.2 bouyer { 133 1.1.1.2.2.2 bouyer ACPI_FUNCTION_TRACE (ExReacquireInterpreter); 134 1.1.1.2.2.2 bouyer 135 1.1.1.2.2.2 bouyer 136 1.1.1.2.2.2 bouyer /* 137 1.1.1.2.2.2 bouyer * If the global serialized flag is set, do not release the interpreter, 138 1.1.1.2.2.2 bouyer * since it was not actually released by AcpiExRelinquishInterpreter. 139 1.1.1.2.2.2 bouyer * This forces the interpreter to be single threaded. 140 1.1.1.2.2.2 bouyer */ 141 1.1.1.2.2.2 bouyer if (!AcpiGbl_AllMethodsSerialized) 142 1.1.1.2.2.2 bouyer { 143 1.1.1.2.2.2 bouyer AcpiExEnterInterpreter (); 144 1.1.1.2.2.2 bouyer } 145 1.1.1.2.2.2 bouyer 146 1.1.1.2.2.2 bouyer return_VOID; 147 1.1.1.2.2.2 bouyer } 148 1.1.1.2.2.2 bouyer 149 1.1.1.2.2.2 bouyer 150 1.1.1.2.2.2 bouyer /******************************************************************************* 151 1.1.1.2.2.2 bouyer * 152 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExExitInterpreter 153 1.1.1.2.2.2 bouyer * 154 1.1.1.2.2.2 bouyer * PARAMETERS: None 155 1.1.1.2.2.2 bouyer * 156 1.1.1.2.2.2 bouyer * RETURN: None 157 1.1.1.2.2.2 bouyer * 158 1.1.1.2.2.2 bouyer * DESCRIPTION: Exit the interpreter execution region. This is the top level 159 1.1.1.2.2.2 bouyer * routine used to exit the interpreter when all processing has 160 1.1.1.2.2.2 bouyer * been completed. 161 1.1.1.2.2.2 bouyer * 162 1.1.1.2.2.2 bouyer ******************************************************************************/ 163 1.1.1.2.2.2 bouyer 164 1.1.1.2.2.2 bouyer void 165 1.1.1.2.2.2 bouyer AcpiExExitInterpreter ( 166 1.1.1.2.2.2 bouyer void) 167 1.1.1.2.2.2 bouyer { 168 1.1.1.2.2.2 bouyer ACPI_STATUS Status; 169 1.1.1.2.2.2 bouyer 170 1.1.1.2.2.2 bouyer 171 1.1.1.2.2.2 bouyer ACPI_FUNCTION_TRACE (ExExitInterpreter); 172 1.1.1.2.2.2 bouyer 173 1.1.1.2.2.2 bouyer 174 1.1.1.2.2.2 bouyer Status = AcpiUtReleaseMutex (ACPI_MTX_INTERPRETER); 175 1.1.1.2.2.2 bouyer if (ACPI_FAILURE (Status)) 176 1.1.1.2.2.2 bouyer { 177 1.1.1.2.2.2 bouyer ACPI_ERROR ((AE_INFO, "Could not release AML Interpreter mutex")); 178 1.1.1.2.2.2 bouyer } 179 1.1.1.2.2.2 bouyer 180 1.1.1.2.2.2 bouyer return_VOID; 181 1.1.1.2.2.2 bouyer } 182 1.1.1.2.2.2 bouyer 183 1.1.1.2.2.2 bouyer 184 1.1.1.2.2.2 bouyer /******************************************************************************* 185 1.1.1.2.2.2 bouyer * 186 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExRelinquishInterpreter 187 1.1.1.2.2.2 bouyer * 188 1.1.1.2.2.2 bouyer * PARAMETERS: None 189 1.1.1.2.2.2 bouyer * 190 1.1.1.2.2.2 bouyer * RETURN: None 191 1.1.1.2.2.2 bouyer * 192 1.1.1.2.2.2 bouyer * DESCRIPTION: Exit the interpreter execution region, from within the 193 1.1.1.2.2.2 bouyer * interpreter - before attempting an operation that will possibly 194 1.1.1.2.2.2 bouyer * block the running thread. 195 1.1.1.2.2.2 bouyer * 196 1.1.1.2.2.2 bouyer * Cases where the interpreter is unlocked internally 197 1.1.1.2.2.2 bouyer * 1) Method to be blocked on a Sleep() AML opcode 198 1.1.1.2.2.2 bouyer * 2) Method to be blocked on an Acquire() AML opcode 199 1.1.1.2.2.2 bouyer * 3) Method to be blocked on a Wait() AML opcode 200 1.1.1.2.2.2 bouyer * 4) Method to be blocked to acquire the global lock 201 1.1.1.2.2.2 bouyer * 5) Method to be blocked waiting to execute a serialized control method 202 1.1.1.2.2.2 bouyer * that is currently executing 203 1.1.1.2.2.2 bouyer * 6) About to invoke a user-installed opregion handler 204 1.1.1.2.2.2 bouyer * 205 1.1.1.2.2.2 bouyer ******************************************************************************/ 206 1.1.1.2.2.2 bouyer 207 1.1.1.2.2.2 bouyer void 208 1.1.1.2.2.2 bouyer AcpiExRelinquishInterpreter ( 209 1.1.1.2.2.2 bouyer void) 210 1.1.1.2.2.2 bouyer { 211 1.1.1.2.2.2 bouyer ACPI_FUNCTION_TRACE (ExRelinquishInterpreter); 212 1.1.1.2.2.2 bouyer 213 1.1.1.2.2.2 bouyer 214 1.1.1.2.2.2 bouyer /* 215 1.1.1.2.2.2 bouyer * If the global serialized flag is set, do not release the interpreter. 216 1.1.1.2.2.2 bouyer * This forces the interpreter to be single threaded. 217 1.1.1.2.2.2 bouyer */ 218 1.1.1.2.2.2 bouyer if (!AcpiGbl_AllMethodsSerialized) 219 1.1.1.2.2.2 bouyer { 220 1.1.1.2.2.2 bouyer AcpiExExitInterpreter (); 221 1.1.1.2.2.2 bouyer } 222 1.1.1.2.2.2 bouyer 223 1.1.1.2.2.2 bouyer return_VOID; 224 1.1.1.2.2.2 bouyer } 225 1.1.1.2.2.2 bouyer 226 1.1.1.2.2.2 bouyer 227 1.1.1.2.2.2 bouyer /******************************************************************************* 228 1.1.1.2.2.2 bouyer * 229 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExTruncateFor32bitTable 230 1.1.1.2.2.2 bouyer * 231 1.1.1.2.2.2 bouyer * PARAMETERS: ObjDesc - Object to be truncated 232 1.1.1.2.2.2 bouyer * 233 1.1.1.2.2.2 bouyer * RETURN: none 234 1.1.1.2.2.2 bouyer * 235 1.1.1.2.2.2 bouyer * DESCRIPTION: Truncate an ACPI Integer to 32 bits if the execution mode is 236 1.1.1.2.2.2 bouyer * 32-bit, as determined by the revision of the DSDT. 237 1.1.1.2.2.2 bouyer * 238 1.1.1.2.2.2 bouyer ******************************************************************************/ 239 1.1.1.2.2.2 bouyer 240 1.1.1.2.2.2 bouyer void 241 1.1.1.2.2.2 bouyer AcpiExTruncateFor32bitTable ( 242 1.1.1.2.2.2 bouyer ACPI_OPERAND_OBJECT *ObjDesc) 243 1.1.1.2.2.2 bouyer { 244 1.1.1.2.2.2 bouyer 245 1.1.1.2.2.2 bouyer ACPI_FUNCTION_ENTRY (); 246 1.1.1.2.2.2 bouyer 247 1.1.1.2.2.2 bouyer 248 1.1.1.2.2.2 bouyer /* 249 1.1.1.2.2.2 bouyer * Object must be a valid number and we must be executing 250 1.1.1.2.2.2 bouyer * a control method. NS node could be there for AML_INT_NAMEPATH_OP. 251 1.1.1.2.2.2 bouyer */ 252 1.1.1.2.2.2 bouyer if ((!ObjDesc) || 253 1.1.1.2.2.2 bouyer (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) != ACPI_DESC_TYPE_OPERAND) || 254 1.1.1.2.2.2 bouyer (ObjDesc->Common.Type != ACPI_TYPE_INTEGER)) 255 1.1.1.2.2.2 bouyer { 256 1.1.1.2.2.2 bouyer return; 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 (AcpiGbl_IntegerByteWidth == 4) 260 1.1.1.2.2.2 bouyer { 261 1.1.1.2.2.2 bouyer /* 262 1.1.1.2.2.2 bouyer * We are running a method that exists in a 32-bit ACPI table. 263 1.1.1.2.2.2 bouyer * Truncate the value to 32 bits by zeroing out the upper 32-bit field 264 1.1.1.2.2.2 bouyer */ 265 1.1.1.2.2.2 bouyer ObjDesc->Integer.Value &= (UINT64) ACPI_UINT32_MAX; 266 1.1.1.2.2.2 bouyer } 267 1.1.1.2.2.2 bouyer } 268 1.1.1.2.2.2 bouyer 269 1.1.1.2.2.2 bouyer 270 1.1.1.2.2.2 bouyer /******************************************************************************* 271 1.1.1.2.2.2 bouyer * 272 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExAcquireGlobalLock 273 1.1.1.2.2.2 bouyer * 274 1.1.1.2.2.2 bouyer * PARAMETERS: FieldFlags - Flags with Lock rule: 275 1.1.1.2.2.2 bouyer * AlwaysLock or NeverLock 276 1.1.1.2.2.2 bouyer * 277 1.1.1.2.2.2 bouyer * RETURN: None 278 1.1.1.2.2.2 bouyer * 279 1.1.1.2.2.2 bouyer * DESCRIPTION: Obtain the ACPI hardware Global Lock, only if the field 280 1.1.1.2.2.2 bouyer * flags specifiy that it is to be obtained before field access. 281 1.1.1.2.2.2 bouyer * 282 1.1.1.2.2.2 bouyer ******************************************************************************/ 283 1.1.1.2.2.2 bouyer 284 1.1.1.2.2.2 bouyer void 285 1.1.1.2.2.2 bouyer AcpiExAcquireGlobalLock ( 286 1.1.1.2.2.2 bouyer UINT32 FieldFlags) 287 1.1.1.2.2.2 bouyer { 288 1.1.1.2.2.2 bouyer ACPI_STATUS Status; 289 1.1.1.2.2.2 bouyer 290 1.1.1.2.2.2 bouyer 291 1.1.1.2.2.2 bouyer ACPI_FUNCTION_TRACE (ExAcquireGlobalLock); 292 1.1.1.2.2.2 bouyer 293 1.1.1.2.2.2 bouyer 294 1.1.1.2.2.2 bouyer /* Only use the lock if the AlwaysLock bit is set */ 295 1.1.1.2.2.2 bouyer 296 1.1.1.2.2.2 bouyer if (!(FieldFlags & AML_FIELD_LOCK_RULE_MASK)) 297 1.1.1.2.2.2 bouyer { 298 1.1.1.2.2.2 bouyer return_VOID; 299 1.1.1.2.2.2 bouyer } 300 1.1.1.2.2.2 bouyer 301 1.1.1.2.2.2 bouyer /* Attempt to get the global lock, wait forever */ 302 1.1.1.2.2.2 bouyer 303 1.1.1.2.2.2 bouyer Status = AcpiExAcquireMutexObject (ACPI_WAIT_FOREVER, 304 1.1.1.2.2.2 bouyer AcpiGbl_GlobalLockMutex, AcpiOsGetThreadId ()); 305 1.1.1.2.2.2 bouyer 306 1.1.1.2.2.2 bouyer if (ACPI_FAILURE (Status)) 307 1.1.1.2.2.2 bouyer { 308 1.1.1.2.2.2 bouyer ACPI_EXCEPTION ((AE_INFO, Status, 309 1.1.1.2.2.2 bouyer "Could not acquire Global Lock")); 310 1.1.1.2.2.2 bouyer } 311 1.1.1.2.2.2 bouyer 312 1.1.1.2.2.2 bouyer return_VOID; 313 1.1.1.2.2.2 bouyer } 314 1.1.1.2.2.2 bouyer 315 1.1.1.2.2.2 bouyer 316 1.1.1.2.2.2 bouyer /******************************************************************************* 317 1.1.1.2.2.2 bouyer * 318 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExReleaseGlobalLock 319 1.1.1.2.2.2 bouyer * 320 1.1.1.2.2.2 bouyer * PARAMETERS: FieldFlags - Flags with Lock rule: 321 1.1.1.2.2.2 bouyer * AlwaysLock or NeverLock 322 1.1.1.2.2.2 bouyer * 323 1.1.1.2.2.2 bouyer * RETURN: None 324 1.1.1.2.2.2 bouyer * 325 1.1.1.2.2.2 bouyer * DESCRIPTION: Release the ACPI hardware Global Lock 326 1.1.1.2.2.2 bouyer * 327 1.1.1.2.2.2 bouyer ******************************************************************************/ 328 1.1.1.2.2.2 bouyer 329 1.1.1.2.2.2 bouyer void 330 1.1.1.2.2.2 bouyer AcpiExReleaseGlobalLock ( 331 1.1.1.2.2.2 bouyer UINT32 FieldFlags) 332 1.1.1.2.2.2 bouyer { 333 1.1.1.2.2.2 bouyer ACPI_STATUS Status; 334 1.1.1.2.2.2 bouyer 335 1.1.1.2.2.2 bouyer 336 1.1.1.2.2.2 bouyer ACPI_FUNCTION_TRACE (ExReleaseGlobalLock); 337 1.1.1.2.2.2 bouyer 338 1.1.1.2.2.2 bouyer 339 1.1.1.2.2.2 bouyer /* Only use the lock if the AlwaysLock bit is set */ 340 1.1.1.2.2.2 bouyer 341 1.1.1.2.2.2 bouyer if (!(FieldFlags & AML_FIELD_LOCK_RULE_MASK)) 342 1.1.1.2.2.2 bouyer { 343 1.1.1.2.2.2 bouyer return_VOID; 344 1.1.1.2.2.2 bouyer } 345 1.1.1.2.2.2 bouyer 346 1.1.1.2.2.2 bouyer /* Release the global lock */ 347 1.1.1.2.2.2 bouyer 348 1.1.1.2.2.2 bouyer Status = AcpiExReleaseMutexObject (AcpiGbl_GlobalLockMutex); 349 1.1.1.2.2.2 bouyer if (ACPI_FAILURE (Status)) 350 1.1.1.2.2.2 bouyer { 351 1.1.1.2.2.2 bouyer /* Report the error, but there isn't much else we can do */ 352 1.1.1.2.2.2 bouyer 353 1.1.1.2.2.2 bouyer ACPI_EXCEPTION ((AE_INFO, Status, 354 1.1.1.2.2.2 bouyer "Could not release Global Lock")); 355 1.1.1.2.2.2 bouyer } 356 1.1.1.2.2.2 bouyer 357 1.1.1.2.2.2 bouyer return_VOID; 358 1.1.1.2.2.2 bouyer } 359 1.1.1.2.2.2 bouyer 360 1.1.1.2.2.2 bouyer 361 1.1.1.2.2.2 bouyer /******************************************************************************* 362 1.1.1.2.2.2 bouyer * 363 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExDigitsNeeded 364 1.1.1.2.2.2 bouyer * 365 1.1.1.2.2.2 bouyer * PARAMETERS: Value - Value to be represented 366 1.1.1.2.2.2 bouyer * Base - Base of representation 367 1.1.1.2.2.2 bouyer * 368 1.1.1.2.2.2 bouyer * RETURN: The number of digits. 369 1.1.1.2.2.2 bouyer * 370 1.1.1.2.2.2 bouyer * DESCRIPTION: Calculate the number of digits needed to represent the Value 371 1.1.1.2.2.2 bouyer * in the given Base (Radix) 372 1.1.1.2.2.2 bouyer * 373 1.1.1.2.2.2 bouyer ******************************************************************************/ 374 1.1.1.2.2.2 bouyer 375 1.1.1.2.2.2 bouyer static UINT32 376 1.1.1.2.2.2 bouyer AcpiExDigitsNeeded ( 377 1.1.1.2.2.2 bouyer UINT64 Value, 378 1.1.1.2.2.2 bouyer UINT32 Base) 379 1.1.1.2.2.2 bouyer { 380 1.1.1.2.2.2 bouyer UINT32 NumDigits; 381 1.1.1.2.2.2 bouyer UINT64 CurrentValue; 382 1.1.1.2.2.2 bouyer 383 1.1.1.2.2.2 bouyer 384 1.1.1.2.2.2 bouyer ACPI_FUNCTION_TRACE (ExDigitsNeeded); 385 1.1.1.2.2.2 bouyer 386 1.1.1.2.2.2 bouyer 387 1.1.1.2.2.2 bouyer /* UINT64 is unsigned, so we don't worry about a '-' prefix */ 388 1.1.1.2.2.2 bouyer 389 1.1.1.2.2.2 bouyer if (Value == 0) 390 1.1.1.2.2.2 bouyer { 391 1.1.1.2.2.2 bouyer return_UINT32 (1); 392 1.1.1.2.2.2 bouyer } 393 1.1.1.2.2.2 bouyer 394 1.1.1.2.2.2 bouyer CurrentValue = Value; 395 1.1.1.2.2.2 bouyer NumDigits = 0; 396 1.1.1.2.2.2 bouyer 397 1.1.1.2.2.2 bouyer /* Count the digits in the requested base */ 398 1.1.1.2.2.2 bouyer 399 1.1.1.2.2.2 bouyer while (CurrentValue) 400 1.1.1.2.2.2 bouyer { 401 1.1.1.2.2.2 bouyer (void) AcpiUtShortDivide (CurrentValue, Base, &CurrentValue, NULL); 402 1.1.1.2.2.2 bouyer NumDigits++; 403 1.1.1.2.2.2 bouyer } 404 1.1.1.2.2.2 bouyer 405 1.1.1.2.2.2 bouyer return_UINT32 (NumDigits); 406 1.1.1.2.2.2 bouyer } 407 1.1.1.2.2.2 bouyer 408 1.1.1.2.2.2 bouyer 409 1.1.1.2.2.2 bouyer /******************************************************************************* 410 1.1.1.2.2.2 bouyer * 411 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExEisaIdToString 412 1.1.1.2.2.2 bouyer * 413 1.1.1.2.2.2 bouyer * PARAMETERS: CompressedId - EISAID to be converted 414 1.1.1.2.2.2 bouyer * OutString - Where to put the converted string (8 bytes) 415 1.1.1.2.2.2 bouyer * 416 1.1.1.2.2.2 bouyer * RETURN: None 417 1.1.1.2.2.2 bouyer * 418 1.1.1.2.2.2 bouyer * DESCRIPTION: Convert a numeric EISAID to string representation. Return 419 1.1.1.2.2.2 bouyer * buffer must be large enough to hold the string. The string 420 1.1.1.2.2.2 bouyer * returned is always exactly of length ACPI_EISAID_STRING_SIZE 421 1.1.1.2.2.2 bouyer * (includes null terminator). The EISAID is always 32 bits. 422 1.1.1.2.2.2 bouyer * 423 1.1.1.2.2.2 bouyer ******************************************************************************/ 424 1.1.1.2.2.2 bouyer 425 1.1.1.2.2.2 bouyer void 426 1.1.1.2.2.2 bouyer AcpiExEisaIdToString ( 427 1.1.1.2.2.2 bouyer char *OutString, 428 1.1.1.2.2.2 bouyer UINT64 CompressedId) 429 1.1.1.2.2.2 bouyer { 430 1.1.1.2.2.2 bouyer UINT32 SwappedId; 431 1.1.1.2.2.2 bouyer 432 1.1.1.2.2.2 bouyer 433 1.1.1.2.2.2 bouyer ACPI_FUNCTION_ENTRY (); 434 1.1.1.2.2.2 bouyer 435 1.1.1.2.2.2 bouyer 436 1.1.1.2.2.2 bouyer /* The EISAID should be a 32-bit integer */ 437 1.1.1.2.2.2 bouyer 438 1.1.1.2.2.2 bouyer if (CompressedId > ACPI_UINT32_MAX) 439 1.1.1.2.2.2 bouyer { 440 1.1.1.2.2.2 bouyer ACPI_WARNING ((AE_INFO, 441 1.1.1.2.2.2 bouyer "Expected EISAID is larger than 32 bits: 0x%8.8X%8.8X, truncating", 442 1.1.1.2.2.2 bouyer ACPI_FORMAT_UINT64 (CompressedId))); 443 1.1.1.2.2.2 bouyer } 444 1.1.1.2.2.2 bouyer 445 1.1.1.2.2.2 bouyer /* Swap ID to big-endian to get contiguous bits */ 446 1.1.1.2.2.2 bouyer 447 1.1.1.2.2.2 bouyer SwappedId = AcpiUtDwordByteSwap ((UINT32) CompressedId); 448 1.1.1.2.2.2 bouyer 449 1.1.1.2.2.2 bouyer /* First 3 bytes are uppercase letters. Next 4 bytes are hexadecimal */ 450 1.1.1.2.2.2 bouyer 451 1.1.1.2.2.2 bouyer OutString[0] = (char) (0x40 + (((unsigned long) SwappedId >> 26) & 0x1F)); 452 1.1.1.2.2.2 bouyer OutString[1] = (char) (0x40 + ((SwappedId >> 21) & 0x1F)); 453 1.1.1.2.2.2 bouyer OutString[2] = (char) (0x40 + ((SwappedId >> 16) & 0x1F)); 454 1.1.1.2.2.2 bouyer OutString[3] = AcpiUtHexToAsciiChar ((UINT64) SwappedId, 12); 455 1.1.1.2.2.2 bouyer OutString[4] = AcpiUtHexToAsciiChar ((UINT64) SwappedId, 8); 456 1.1.1.2.2.2 bouyer OutString[5] = AcpiUtHexToAsciiChar ((UINT64) SwappedId, 4); 457 1.1.1.2.2.2 bouyer OutString[6] = AcpiUtHexToAsciiChar ((UINT64) SwappedId, 0); 458 1.1.1.2.2.2 bouyer OutString[7] = 0; 459 1.1.1.2.2.2 bouyer } 460 1.1.1.2.2.2 bouyer 461 1.1.1.2.2.2 bouyer 462 1.1.1.2.2.2 bouyer /******************************************************************************* 463 1.1.1.2.2.2 bouyer * 464 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExIntegerToString 465 1.1.1.2.2.2 bouyer * 466 1.1.1.2.2.2 bouyer * PARAMETERS: OutString - Where to put the converted string. At least 467 1.1.1.2.2.2 bouyer * 21 bytes are needed to hold the largest 468 1.1.1.2.2.2 bouyer * possible 64-bit integer. 469 1.1.1.2.2.2 bouyer * Value - Value to be converted 470 1.1.1.2.2.2 bouyer * 471 1.1.1.2.2.2 bouyer * RETURN: None, string 472 1.1.1.2.2.2 bouyer * 473 1.1.1.2.2.2 bouyer * DESCRIPTION: Convert a 64-bit integer to decimal string representation. 474 1.1.1.2.2.2 bouyer * Assumes string buffer is large enough to hold the string. The 475 1.1.1.2.2.2 bouyer * largest string is (ACPI_MAX64_DECIMAL_DIGITS + 1). 476 1.1.1.2.2.2 bouyer * 477 1.1.1.2.2.2 bouyer ******************************************************************************/ 478 1.1.1.2.2.2 bouyer 479 1.1.1.2.2.2 bouyer void 480 1.1.1.2.2.2 bouyer AcpiExIntegerToString ( 481 1.1.1.2.2.2 bouyer char *OutString, 482 1.1.1.2.2.2 bouyer UINT64 Value) 483 1.1.1.2.2.2 bouyer { 484 1.1.1.2.2.2 bouyer UINT32 Count; 485 1.1.1.2.2.2 bouyer UINT32 DigitsNeeded; 486 1.1.1.2.2.2 bouyer UINT32 Remainder; 487 1.1.1.2.2.2 bouyer 488 1.1.1.2.2.2 bouyer 489 1.1.1.2.2.2 bouyer ACPI_FUNCTION_ENTRY (); 490 1.1.1.2.2.2 bouyer 491 1.1.1.2.2.2 bouyer 492 1.1.1.2.2.2 bouyer DigitsNeeded = AcpiExDigitsNeeded (Value, 10); 493 1.1.1.2.2.2 bouyer OutString[DigitsNeeded] = 0; 494 1.1.1.2.2.2 bouyer 495 1.1.1.2.2.2 bouyer for (Count = DigitsNeeded; Count > 0; Count--) 496 1.1.1.2.2.2 bouyer { 497 1.1.1.2.2.2 bouyer (void) AcpiUtShortDivide (Value, 10, &Value, &Remainder); 498 1.1.1.2.2.2 bouyer OutString[Count-1] = (char) ('0' + Remainder);\ 499 1.1.1.2.2.2 bouyer } 500 1.1.1.2.2.2 bouyer } 501 1.1.1.2.2.2 bouyer 502 1.1.1.2.2.2 bouyer #endif 503
Indexes created Fri Oct 03 02:09:57 GMT 2025