1 /******************************************************************************
3 * Module Name: uteval - Object evaluation
6 *****************************************************************************/
8 /******************************************************************************
12 * Some or all of this work - Copyright (c) 1999 - 2003, Intel Corp.
13 * All rights reserved.
17 * 2.1. This is your license from Intel Corp. under its intellectual property
18 * rights. You may have additional license terms from the party that provided
19 * you this software, covering your right to use that party's intellectual
22 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
23 * copy of the source code appearing in this file ("Covered Code") an
24 * irrevocable, perpetual, worldwide license under Intel's copyrights in the
25 * base code distributed originally by Intel ("Original Intel Code") to copy,
26 * make derivatives, distribute, use and display any portion of the Covered
27 * Code in any form, with the right to sublicense such rights; and
29 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
30 * license (with the right to sublicense), under only those claims of Intel
31 * patents that are infringed by the Original Intel Code, to make, use, sell,
32 * offer to sell, and import the Covered Code and derivative works thereof
33 * solely to the minimum extent necessary to exercise the above copyright
34 * license, and in no event shall the patent license extend to any additions
35 * to or modifications of the Original Intel Code. No other license or right
36 * is granted directly or by implication, estoppel or otherwise;
38 * The above copyright and patent license is granted only if the following
43 * 3.1. Redistribution of Source with Rights to Further Distribute Source.
44 * Redistribution of source code of any substantial portion of the Covered
45 * Code or modification with rights to further distribute source must include
46 * the above Copyright Notice, the above License, this list of Conditions,
47 * and the following Disclaimer and Export Compliance provision. In addition,
48 * Licensee must cause all Covered Code to which Licensee contributes to
49 * contain a file documenting the changes Licensee made to create that Covered
50 * Code and the date of any change. Licensee must include in that file the
51 * documentation of any changes made by any predecessor Licensee. Licensee
52 * must include a prominent statement that the modification is derived,
53 * directly or indirectly, from Original Intel Code.
55 * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
56 * Redistribution of source code of any substantial portion of the Covered
57 * Code or modification without rights to further distribute source must
58 * include the following Disclaimer and Export Compliance provision in the
59 * documentation and/or other materials provided with distribution. In
60 * addition, Licensee may not authorize further sublicense of source of any
61 * portion of the Covered Code, and must include terms to the effect that the
62 * license from Licensee to its licensee is limited to the intellectual
63 * property embodied in the software Licensee provides to its licensee, and
64 * not to intellectual property embodied in modifications its licensee may
67 * 3.3. Redistribution of Executable. Redistribution in executable form of any
68 * substantial portion of the Covered Code or modification must reproduce the
69 * above Copyright Notice, and the following Disclaimer and Export Compliance
70 * provision in the documentation and/or other materials provided with the
73 * 3.4. Intel retains all right, title, and interest in and to the Original
76 * 3.5. Neither the name Intel nor any other trademark owned or controlled by
77 * Intel shall be used in advertising or otherwise to promote the sale, use or
78 * other dealings in products derived from or relating to the Covered Code
79 * without prior written authorization from Intel.
81 * 4. Disclaimer and Export Compliance
83 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
84 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
85 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
86 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
87 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
88 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
91 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
92 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
93 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
94 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
95 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
96 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
97 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
100 * 4.3. Licensee shall not export, either directly or indirectly, any of this
101 * software or system incorporating such software without first obtaining any
102 * required license or other approval from the U. S. Department of Commerce or
103 * any other agency or department of the United States Government. In the
104 * event Licensee exports any such software from the United States or
105 * re-exports any such software from a foreign destination, Licensee shall
106 * ensure that the distribution and export/re-export of the software is in
107 * compliance with all laws, regulations, orders, or other restrictions of the
108 * U.S. Export Administration Regulations. Licensee agrees that neither it nor
109 * any of its subsidiaries will export/re-export any technical data, process,
110 * software, or service, directly or indirectly, to any country for which the
111 * United States government or any agency thereof requires an export license,
112 * other governmental approval, or letter of assurance, without first obtaining
113 * such license, approval or letter.
115 *****************************************************************************/
120 #include "acnamesp.h"
121 #include "acinterp.h"
124 #define _COMPONENT ACPI_UTILITIES
125 ACPI_MODULE_NAME ("uteval")
128 /*******************************************************************************
130 * FUNCTION: AcpiUtEvaluateObject
132 * PARAMETERS: PrefixNode - Starting node
133 * Path - Path to object from starting node
134 * ExpectedReturnTypes - Bitmap of allowed return types
135 * ReturnDesc - Where a return value is stored
139 * DESCRIPTION: Evaluates a namespace object and verifies the type of the
140 * return object. Common code that simplifies accessing objects
141 * that have required return objects of fixed types.
143 * NOTE: Internal function, no parameter validation
145 ******************************************************************************/
148 AcpiUtEvaluateObject (
149 ACPI_NAMESPACE_NODE *PrefixNode,
151 UINT32 ExpectedReturnBtypes,
152 ACPI_OPERAND_OBJECT **ReturnDesc)
154 ACPI_OPERAND_OBJECT *ObjDesc;
159 ACPI_FUNCTION_TRACE ("UtEvaluateObject");
162 /* Evaluate the object/method */
164 Status = AcpiNsEvaluateRelative (PrefixNode, Path, NULL, &ObjDesc);
165 if (ACPI_FAILURE (Status))
167 if (Status == AE_NOT_FOUND)
169 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[%4.4s.%s] was not found\n",
170 AcpiUtGetNodeName (PrefixNode), Path));
174 ACPI_REPORT_METHOD_ERROR ("Method execution failed",
175 PrefixNode, Path, Status);
178 return_ACPI_STATUS (Status);
181 /* Did we get a return object? */
185 if (ExpectedReturnBtypes)
187 ACPI_REPORT_METHOD_ERROR ("No object was returned from",
188 PrefixNode, Path, AE_NOT_EXIST);
190 return_ACPI_STATUS (AE_NOT_EXIST);
193 return_ACPI_STATUS (AE_OK);
196 /* Map the return object type to the bitmapped type */
198 switch (ACPI_GET_OBJECT_TYPE (ObjDesc))
200 case ACPI_TYPE_INTEGER:
201 ReturnBtype = ACPI_BTYPE_INTEGER;
204 case ACPI_TYPE_BUFFER:
205 ReturnBtype = ACPI_BTYPE_BUFFER;
208 case ACPI_TYPE_STRING:
209 ReturnBtype = ACPI_BTYPE_STRING;
212 case ACPI_TYPE_PACKAGE:
213 ReturnBtype = ACPI_BTYPE_PACKAGE;
221 /* Is the return object one of the expected types? */
223 if (!(ExpectedReturnBtypes & ReturnBtype))
225 ACPI_REPORT_METHOD_ERROR ("Return object type is incorrect",
226 PrefixNode, Path, AE_TYPE);
228 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR,
229 "Type returned from %s was incorrect: %X\n",
230 Path, ACPI_GET_OBJECT_TYPE (ObjDesc)));
232 /* On error exit, we must delete the return object */
234 AcpiUtRemoveReference (ObjDesc);
235 return_ACPI_STATUS (AE_TYPE);
238 /* Object type is OK, return it */
240 *ReturnDesc = ObjDesc;
241 return_ACPI_STATUS (AE_OK);
245 /*******************************************************************************
247 * FUNCTION: AcpiUtEvaluateNumericObject
249 * PARAMETERS: *ObjectName - Object name to be evaluated
250 * DeviceNode - Node for the device
251 * *Address - Where the value is returned
255 * DESCRIPTION: Evaluates a numeric namespace object for a selected device
256 * and stores result in *Address.
258 * NOTE: Internal function, no parameter validation
260 ******************************************************************************/
263 AcpiUtEvaluateNumericObject (
265 ACPI_NAMESPACE_NODE *DeviceNode,
266 ACPI_INTEGER *Address)
268 ACPI_OPERAND_OBJECT *ObjDesc;
272 ACPI_FUNCTION_TRACE ("UtEvaluateNumericObject");
275 Status = AcpiUtEvaluateObject (DeviceNode, ObjectName,
276 ACPI_BTYPE_INTEGER, &ObjDesc);
277 if (ACPI_FAILURE (Status))
279 return_ACPI_STATUS (Status);
282 /* Get the returned Integer */
284 *Address = ObjDesc->Integer.Value;
286 /* On exit, we must delete the return object */
288 AcpiUtRemoveReference (ObjDesc);
289 return_ACPI_STATUS (Status);
293 /*******************************************************************************
295 * FUNCTION: AcpiUtCopyIdString
297 * PARAMETERS: Destination - Where to copy the string
298 * Source - Source string
299 * MaxLength - Length of the destination buffer
303 * DESCRIPTION: Copies an ID string for the _HID, _CID, and _UID methods.
304 * Performs removal of a leading asterisk if present -- workaround
305 * for a known issue on a bunch of machines.
307 ******************************************************************************/
318 * Workaround for ID strings that have a leading asterisk. This construct
319 * is not allowed by the ACPI specification (ID strings must be
320 * alphanumeric), but enough existing machines have this embedded in their
321 * ID strings that the following code is useful.
328 /* Do the actual copy */
330 ACPI_STRNCPY (Destination, Source, MaxLength);
334 /*******************************************************************************
336 * FUNCTION: AcpiUtExecute_HID
338 * PARAMETERS: DeviceNode - Node for the device
339 * *Hid - Where the HID is returned
343 * DESCRIPTION: Executes the _HID control method that returns the hardware
346 * NOTE: Internal function, no parameter validation
348 ******************************************************************************/
352 ACPI_NAMESPACE_NODE *DeviceNode,
355 ACPI_OPERAND_OBJECT *ObjDesc;
359 ACPI_FUNCTION_TRACE ("UtExecute_HID");
362 Status = AcpiUtEvaluateObject (DeviceNode, METHOD_NAME__HID,
363 ACPI_BTYPE_INTEGER | ACPI_BTYPE_STRING, &ObjDesc);
364 if (ACPI_FAILURE (Status))
366 return_ACPI_STATUS (Status);
369 if (ACPI_GET_OBJECT_TYPE (ObjDesc) == ACPI_TYPE_INTEGER)
371 /* Convert the Numeric HID to string */
373 AcpiExEisaIdToString ((UINT32) ObjDesc->Integer.Value, Hid->Value);
377 /* Copy the String HID from the returned object */
379 AcpiUtCopyIdString (Hid->Value, ObjDesc->String.Pointer,
380 sizeof (Hid->Value));
383 /* On exit, we must delete the return object */
385 AcpiUtRemoveReference (ObjDesc);
386 return_ACPI_STATUS (Status);
390 /*******************************************************************************
392 * FUNCTION: AcpiUtTranslateOneCid
394 * PARAMETERS: ObjDesc - _CID object, must be integer or string
395 * OneCid - Where the CID string is returned
399 * DESCRIPTION: Return a numeric or string _CID value as a string.
402 * NOTE: Assumes a maximum _CID string length of
403 * ACPI_MAX_CID_LENGTH.
405 ******************************************************************************/
408 AcpiUtTranslateOneCid (
409 ACPI_OPERAND_OBJECT *ObjDesc,
410 ACPI_COMPATIBLE_ID *OneCid)
414 switch (ACPI_GET_OBJECT_TYPE (ObjDesc))
416 case ACPI_TYPE_INTEGER:
418 /* Convert the Numeric CID to string */
420 AcpiExEisaIdToString ((UINT32) ObjDesc->Integer.Value, OneCid->Value);
423 case ACPI_TYPE_STRING:
425 if (ObjDesc->String.Length > ACPI_MAX_CID_LENGTH)
427 return (AE_AML_STRING_LIMIT);
430 /* Copy the String CID from the returned object */
432 AcpiUtCopyIdString (OneCid->Value, ObjDesc->String.Pointer,
433 ACPI_MAX_CID_LENGTH);
443 /*******************************************************************************
445 * FUNCTION: AcpiUtExecute_CID
447 * PARAMETERS: DeviceNode - Node for the device
448 * *Cid - Where the CID is returned
452 * DESCRIPTION: Executes the _CID control method that returns one or more
453 * compatible hardware IDs for the device.
455 * NOTE: Internal function, no parameter validation
457 ******************************************************************************/
461 ACPI_NAMESPACE_NODE *DeviceNode,
462 ACPI_COMPATIBLE_ID_LIST **ReturnCidList)
464 ACPI_OPERAND_OBJECT *ObjDesc;
468 ACPI_COMPATIBLE_ID_LIST *CidList;
472 ACPI_FUNCTION_TRACE ("UtExecute_CID");
475 /* Evaluate the _CID method for this device */
477 Status = AcpiUtEvaluateObject (DeviceNode, METHOD_NAME__CID,
478 ACPI_BTYPE_INTEGER | ACPI_BTYPE_STRING | ACPI_BTYPE_PACKAGE,
480 if (ACPI_FAILURE (Status))
482 return_ACPI_STATUS (Status);
485 /* Get the number of _CIDs returned */
488 if (ACPI_GET_OBJECT_TYPE (ObjDesc) == ACPI_TYPE_PACKAGE)
490 Count = ObjDesc->Package.Count;
493 /* Allocate a worst-case buffer for the _CIDs */
495 Size = (((Count - 1) * sizeof (ACPI_COMPATIBLE_ID)) +
496 sizeof (ACPI_COMPATIBLE_ID_LIST));
498 CidList = ACPI_MEM_CALLOCATE ((ACPI_SIZE) Size);
501 return_ACPI_STATUS (AE_NO_MEMORY);
506 CidList->Count = Count;
507 CidList->Size = Size;
510 * A _CID can return either a single compatible ID or a package of compatible
511 * IDs. Each compatible ID can be one of the following:
512 * -- Number (32 bit compressed EISA ID) or
513 * -- String (PCI ID format, e.g. "PCI\VEN_vvvv&DEV_dddd&SUBSYS_ssssssss").
516 /* The _CID object can be either a single CID or a package (list) of CIDs */
518 if (ACPI_GET_OBJECT_TYPE (ObjDesc) == ACPI_TYPE_PACKAGE)
520 /* Translate each package element */
522 for (i = 0; i < Count; i++)
524 Status = AcpiUtTranslateOneCid (ObjDesc->Package.Elements[i],
526 if (ACPI_FAILURE (Status))
534 /* Only one CID, translate to a string */
536 Status = AcpiUtTranslateOneCid (ObjDesc, CidList->Id);
539 /* Cleanup on error */
541 if (ACPI_FAILURE (Status))
543 ACPI_MEM_FREE (CidList);
547 *ReturnCidList = CidList;
550 /* On exit, we must delete the _CID return object */
552 AcpiUtRemoveReference (ObjDesc);
553 return_ACPI_STATUS (Status);
557 /*******************************************************************************
559 * FUNCTION: AcpiUtExecute_UID
561 * PARAMETERS: DeviceNode - Node for the device
562 * *Uid - Where the UID is returned
566 * DESCRIPTION: Executes the _UID control method that returns the hardware
569 * NOTE: Internal function, no parameter validation
571 ******************************************************************************/
575 ACPI_NAMESPACE_NODE *DeviceNode,
578 ACPI_OPERAND_OBJECT *ObjDesc;
582 ACPI_FUNCTION_TRACE ("UtExecute_UID");
585 Status = AcpiUtEvaluateObject (DeviceNode, METHOD_NAME__UID,
586 ACPI_BTYPE_INTEGER | ACPI_BTYPE_STRING, &ObjDesc);
587 if (ACPI_FAILURE (Status))
589 return_ACPI_STATUS (Status);
592 if (ACPI_GET_OBJECT_TYPE (ObjDesc) == ACPI_TYPE_INTEGER)
594 /* Convert the Numeric UID to string */
596 AcpiExUnsignedIntegerToString (ObjDesc->Integer.Value, Uid->Value);
600 /* Copy the String UID from the returned object */
602 AcpiUtCopyIdString (Uid->Value, ObjDesc->String.Pointer,
603 sizeof (Uid->Value));
606 /* On exit, we must delete the return object */
608 AcpiUtRemoveReference (ObjDesc);
609 return_ACPI_STATUS (Status);
613 /*******************************************************************************
615 * FUNCTION: AcpiUtExecute_STA
617 * PARAMETERS: DeviceNode - Node for the device
618 * *Flags - Where the status flags are returned
622 * DESCRIPTION: Executes _STA for selected device and stores results in
625 * NOTE: Internal function, no parameter validation
627 ******************************************************************************/
631 ACPI_NAMESPACE_NODE *DeviceNode,
634 ACPI_OPERAND_OBJECT *ObjDesc;
638 ACPI_FUNCTION_TRACE ("UtExecute_STA");
641 Status = AcpiUtEvaluateObject (DeviceNode, METHOD_NAME__STA,
642 ACPI_BTYPE_INTEGER, &ObjDesc);
643 if (ACPI_FAILURE (Status))
645 if (AE_NOT_FOUND == Status)
647 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
648 "_STA on %4.4s was not found, assuming device is present\n",
649 AcpiUtGetNodeName (DeviceNode)));
655 return_ACPI_STATUS (Status);
658 /* Extract the status flags */
660 *Flags = (UINT32) ObjDesc->Integer.Value;
662 /* On exit, we must delete the return object */
664 AcpiUtRemoveReference (ObjDesc);
665 return_ACPI_STATUS (Status);