aboutsummaryrefslogtreecommitdiff
path: root/utilities/uteval.c
diff options
context:
space:
mode:
Diffstat (limited to 'utilities/uteval.c')
-rw-r--r--utilities/uteval.c410
1 files changed, 41 insertions, 369 deletions
diff --git a/utilities/uteval.c b/utilities/uteval.c
index a75ef3caf6e0..b25cfe12ac81 100644
--- a/utilities/uteval.c
+++ b/utilities/uteval.c
@@ -118,32 +118,18 @@
#include "acpi.h"
#include "accommon.h"
#include "acnamesp.h"
-#include "acinterp.h"
#define _COMPONENT ACPI_UTILITIES
ACPI_MODULE_NAME ("uteval")
-/* Local prototypes */
-
-static void
-AcpiUtCopyIdString (
- char *Destination,
- char *Source,
- ACPI_SIZE MaxLength);
-
-static ACPI_STATUS
-AcpiUtTranslateOneCid (
- ACPI_OPERAND_OBJECT *ObjDesc,
- ACPI_COMPATIBLE_ID *OneCid);
-
/*
* Strings supported by the _OSI predefined (internal) method.
*
* March 2009: Removed "Linux" as this host no longer wants to respond true
* for this string. Basically, the only safe OS strings are windows-related
- * and in many or most cases represent the only test path within the
+ * and in many or most cases represent the only test path within the
* BIOS-provided ASL code.
*
* The second element of each entry is used to track the newest version of
@@ -280,7 +266,7 @@ Exit:
* RETURN: Status
*
* DESCRIPTION: Evaluates a namespace object and verifies the type of the
- * return object. Common code that simplifies accessing objects
+ * return object. Common code that simplifies accessing objects
* that have required return objects of fixed types.
*
* NOTE: Internal function, no parameter validation
@@ -376,7 +362,7 @@ AcpiUtEvaluateObject (
(!ExpectedReturnBtypes))
{
/*
- * We received a return object, but one was not expected. This can
+ * We received a return object, but one was not expected. This can
* happen frequently if the "implicit return" feature is enabled.
* Just delete the return object and return AE_OK.
*/
@@ -419,12 +405,12 @@ Cleanup:
*
* PARAMETERS: ObjectName - Object name to be evaluated
* DeviceNode - Node for the device
- * Address - Where the value is returned
+ * Value - Where the value is returned
*
* RETURN: Status
*
* DESCRIPTION: Evaluates a numeric namespace object for a selected device
- * and stores result in *Address.
+ * and stores result in *Value.
*
* NOTE: Internal function, no parameter validation
*
@@ -434,7 +420,7 @@ ACPI_STATUS
AcpiUtEvaluateNumericObject (
char *ObjectName,
ACPI_NAMESPACE_NODE *DeviceNode,
- ACPI_INTEGER *Address)
+ ACPI_INTEGER *Value)
{
ACPI_OPERAND_OBJECT *ObjDesc;
ACPI_STATUS Status;
@@ -452,326 +438,7 @@ AcpiUtEvaluateNumericObject (
/* Get the returned Integer */
- *Address = ObjDesc->Integer.Value;
-
- /* On exit, we must delete the return object */
-
- AcpiUtRemoveReference (ObjDesc);
- return_ACPI_STATUS (Status);
-}
-
-
-/*******************************************************************************
- *
- * FUNCTION: AcpiUtCopyIdString
- *
- * PARAMETERS: Destination - Where to copy the string
- * Source - Source string
- * MaxLength - Length of the destination buffer
- *
- * RETURN: None
- *
- * DESCRIPTION: Copies an ID string for the _HID, _CID, and _UID methods.
- * Performs removal of a leading asterisk if present -- workaround
- * for a known issue on a bunch of machines.
- *
- ******************************************************************************/
-
-static void
-AcpiUtCopyIdString (
- char *Destination,
- char *Source,
- ACPI_SIZE MaxLength)
-{
-
- /*
- * Workaround for ID strings that have a leading asterisk. This construct
- * is not allowed by the ACPI specification (ID strings must be
- * alphanumeric), but enough existing machines have this embedded in their
- * ID strings that the following code is useful.
- */
- if (*Source == '*')
- {
- Source++;
- }
-
- /* Do the actual copy */
-
- ACPI_STRNCPY (Destination, Source, MaxLength);
-}
-
-
-/*******************************************************************************
- *
- * FUNCTION: AcpiUtExecute_HID
- *
- * PARAMETERS: DeviceNode - Node for the device
- * Hid - Where the HID is returned
- *
- * RETURN: Status
- *
- * DESCRIPTION: Executes the _HID control method that returns the hardware
- * ID of the device.
- *
- * NOTE: Internal function, no parameter validation
- *
- ******************************************************************************/
-
-ACPI_STATUS
-AcpiUtExecute_HID (
- ACPI_NAMESPACE_NODE *DeviceNode,
- ACPI_DEVICE_ID *Hid)
-{
- ACPI_OPERAND_OBJECT *ObjDesc;
- ACPI_STATUS Status;
-
-
- ACPI_FUNCTION_TRACE (UtExecute_HID);
-
-
- Status = AcpiUtEvaluateObject (DeviceNode, METHOD_NAME__HID,
- ACPI_BTYPE_INTEGER | ACPI_BTYPE_STRING, &ObjDesc);
- if (ACPI_FAILURE (Status))
- {
- return_ACPI_STATUS (Status);
- }
-
- if (ObjDesc->Common.Type == ACPI_TYPE_INTEGER)
- {
- /* Convert the Numeric HID to string */
-
- AcpiExEisaIdToString ((UINT32) ObjDesc->Integer.Value, Hid->Value);
- }
- else
- {
- /* Copy the String HID from the returned object */
-
- AcpiUtCopyIdString (Hid->Value, ObjDesc->String.Pointer,
- sizeof (Hid->Value));
- }
-
- /* On exit, we must delete the return object */
-
- AcpiUtRemoveReference (ObjDesc);
- return_ACPI_STATUS (Status);
-}
-
-
-/*******************************************************************************
- *
- * FUNCTION: AcpiUtTranslateOneCid
- *
- * PARAMETERS: ObjDesc - _CID object, must be integer or string
- * OneCid - Where the CID string is returned
- *
- * RETURN: Status
- *
- * DESCRIPTION: Return a numeric or string _CID value as a string.
- * (Compatible ID)
- *
- * NOTE: Assumes a maximum _CID string length of
- * ACPI_MAX_CID_LENGTH.
- *
- ******************************************************************************/
-
-static ACPI_STATUS
-AcpiUtTranslateOneCid (
- ACPI_OPERAND_OBJECT *ObjDesc,
- ACPI_COMPATIBLE_ID *OneCid)
-{
-
-
- switch (ObjDesc->Common.Type)
- {
- case ACPI_TYPE_INTEGER:
-
- /* Convert the Numeric CID to string */
-
- AcpiExEisaIdToString ((UINT32) ObjDesc->Integer.Value, OneCid->Value);
- return (AE_OK);
-
- case ACPI_TYPE_STRING:
-
- if (ObjDesc->String.Length > ACPI_MAX_CID_LENGTH)
- {
- return (AE_AML_STRING_LIMIT);
- }
-
- /* Copy the String CID from the returned object */
-
- AcpiUtCopyIdString (OneCid->Value, ObjDesc->String.Pointer,
- ACPI_MAX_CID_LENGTH);
- return (AE_OK);
-
- default:
-
- return (AE_TYPE);
- }
-}
-
-
-/*******************************************************************************
- *
- * FUNCTION: AcpiUtExecute_CID
- *
- * PARAMETERS: DeviceNode - Node for the device
- * ReturnCidList - Where the CID list is returned
- *
- * RETURN: Status
- *
- * DESCRIPTION: Executes the _CID control method that returns one or more
- * compatible hardware IDs for the device.
- *
- * NOTE: Internal function, no parameter validation
- *
- ******************************************************************************/
-
-ACPI_STATUS
-AcpiUtExecute_CID (
- ACPI_NAMESPACE_NODE *DeviceNode,
- ACPI_COMPATIBLE_ID_LIST **ReturnCidList)
-{
- ACPI_OPERAND_OBJECT *ObjDesc;
- ACPI_STATUS Status;
- UINT32 Count;
- UINT32 Size;
- ACPI_COMPATIBLE_ID_LIST *CidList;
- UINT32 i;
-
-
- ACPI_FUNCTION_TRACE (UtExecute_CID);
-
-
- /* Evaluate the _CID method for this device */
-
- Status = AcpiUtEvaluateObject (DeviceNode, METHOD_NAME__CID,
- ACPI_BTYPE_INTEGER | ACPI_BTYPE_STRING | ACPI_BTYPE_PACKAGE,
- &ObjDesc);
- if (ACPI_FAILURE (Status))
- {
- return_ACPI_STATUS (Status);
- }
-
- /* Get the number of _CIDs returned */
-
- Count = 1;
- if (ObjDesc->Common.Type == ACPI_TYPE_PACKAGE)
- {
- Count = ObjDesc->Package.Count;
- }
-
- /* Allocate a worst-case buffer for the _CIDs */
-
- Size = (((Count - 1) * sizeof (ACPI_COMPATIBLE_ID)) +
- sizeof (ACPI_COMPATIBLE_ID_LIST));
-
- CidList = ACPI_ALLOCATE_ZEROED ((ACPI_SIZE) Size);
- if (!CidList)
- {
- return_ACPI_STATUS (AE_NO_MEMORY);
- }
-
- /* Init CID list */
-
- CidList->Count = Count;
- CidList->Size = Size;
-
- /*
- * A _CID can return either a single compatible ID or a package of
- * compatible IDs. Each compatible ID can be one of the following:
- * 1) Integer (32 bit compressed EISA ID) or
- * 2) String (PCI ID format, e.g. "PCI\VEN_vvvv&DEV_dddd&SUBSYS_ssssssss")
- */
-
- /* The _CID object can be either a single CID or a package (list) of CIDs */
-
- if (ObjDesc->Common.Type == ACPI_TYPE_PACKAGE)
- {
- /* Translate each package element */
-
- for (i = 0; i < Count; i++)
- {
- Status = AcpiUtTranslateOneCid (ObjDesc->Package.Elements[i],
- &CidList->Id[i]);
- if (ACPI_FAILURE (Status))
- {
- break;
- }
- }
- }
- else
- {
- /* Only one CID, translate to a string */
-
- Status = AcpiUtTranslateOneCid (ObjDesc, CidList->Id);
- }
-
- /* Cleanup on error */
-
- if (ACPI_FAILURE (Status))
- {
- ACPI_FREE (CidList);
- }
- else
- {
- *ReturnCidList = CidList;
- }
-
- /* On exit, we must delete the _CID return object */
-
- AcpiUtRemoveReference (ObjDesc);
- return_ACPI_STATUS (Status);
-}
-
-
-/*******************************************************************************
- *
- * FUNCTION: AcpiUtExecute_UID
- *
- * PARAMETERS: DeviceNode - Node for the device
- * Uid - Where the UID is returned
- *
- * RETURN: Status
- *
- * DESCRIPTION: Executes the _UID control method that returns the hardware
- * ID of the device.
- *
- * NOTE: Internal function, no parameter validation
- *
- ******************************************************************************/
-
-ACPI_STATUS
-AcpiUtExecute_UID (
- ACPI_NAMESPACE_NODE *DeviceNode,
- ACPI_DEVICE_ID *Uid)
-{
- ACPI_OPERAND_OBJECT *ObjDesc;
- ACPI_STATUS Status;
-
-
- ACPI_FUNCTION_TRACE (UtExecute_UID);
-
-
- Status = AcpiUtEvaluateObject (DeviceNode, METHOD_NAME__UID,
- ACPI_BTYPE_INTEGER | ACPI_BTYPE_STRING, &ObjDesc);
- if (ACPI_FAILURE (Status))
- {
- return_ACPI_STATUS (Status);
- }
-
- if (ObjDesc->Common.Type == ACPI_TYPE_INTEGER)
- {
- /* Convert the Numeric UID to string */
-
- AcpiExUnsignedIntegerToString (ObjDesc->Integer.Value, Uid->Value);
- }
- else
- {
- /* Copy the String UID from the returned object */
-
- AcpiUtCopyIdString (Uid->Value, ObjDesc->String.Pointer,
- sizeof (Uid->Value));
- }
+ *Value = ObjDesc->Integer.Value;
/* On exit, we must delete the return object */
@@ -838,63 +505,68 @@ AcpiUtExecute_STA (
/*******************************************************************************
*
- * FUNCTION: AcpiUtExecute_Sxds
+ * FUNCTION: AcpiUtExecutePowerMethods
*
* PARAMETERS: DeviceNode - Node for the device
- * Flags - Where the status flags are returned
+ * MethodNames - Array of power method names
+ * MethodCount - Number of methods to execute
+ * OutValues - Where the power method values are returned
*
- * RETURN: Status
+ * RETURN: Status, OutValues
*
- * DESCRIPTION: Executes _STA for selected device and stores results in
- * *Flags.
+ * DESCRIPTION: Executes the specified power methods for the device and returns
+ * the result(s).
*
* NOTE: Internal function, no parameter validation
*
******************************************************************************/
ACPI_STATUS
-AcpiUtExecute_Sxds (
+AcpiUtExecutePowerMethods (
ACPI_NAMESPACE_NODE *DeviceNode,
- UINT8 *Highest)
+ const char **MethodNames,
+ UINT8 MethodCount,
+ UINT8 *OutValues)
{
ACPI_OPERAND_OBJECT *ObjDesc;
ACPI_STATUS Status;
+ ACPI_STATUS FinalStatus = AE_NOT_FOUND;
UINT32 i;
- ACPI_FUNCTION_TRACE (UtExecute_Sxds);
+ ACPI_FUNCTION_TRACE (UtExecutePowerMethods);
- for (i = 0; i < 4; i++)
+ for (i = 0; i < MethodCount; i++)
{
- Highest[i] = 0xFF;
+ /*
+ * Execute the power method (_SxD or _SxW). The only allowable
+ * return type is an Integer.
+ */
Status = AcpiUtEvaluateObject (DeviceNode,
- ACPI_CAST_PTR (char, AcpiGbl_HighestDstateNames[i]),
+ ACPI_CAST_PTR (char, MethodNames[i]),
ACPI_BTYPE_INTEGER, &ObjDesc);
- if (ACPI_FAILURE (Status))
+ if (ACPI_SUCCESS (Status))
{
- if (Status != AE_NOT_FOUND)
- {
- ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
- "%s on Device %4.4s, %s\n",
- ACPI_CAST_PTR (char, AcpiGbl_HighestDstateNames[i]),
- AcpiUtGetNodeName (DeviceNode),
- AcpiFormatException (Status)));
-
- return_ACPI_STATUS (Status);
- }
- }
- else
- {
- /* Extract the Dstate value */
-
- Highest[i] = (UINT8) ObjDesc->Integer.Value;
+ OutValues[i] = (UINT8) ObjDesc->Integer.Value;
/* Delete the return object */
AcpiUtRemoveReference (ObjDesc);
+ FinalStatus = AE_OK; /* At least one value is valid */
+ continue;
}
+
+ OutValues[i] = ACPI_UINT8_MAX;
+ if (Status == AE_NOT_FOUND)
+ {
+ continue; /* Ignore if not found */
+ }
+
+ ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Failed %s on Device %4.4s, %s\n",
+ ACPI_CAST_PTR (char, MethodNames[i]),
+ AcpiUtGetNodeName (DeviceNode), AcpiFormatException (Status)));
}
- return_ACPI_STATUS (AE_OK);
+ return_ACPI_STATUS (FinalStatus);
}