uteval.c File Reference

#include "acpi.h"
#include "accommon.h"
#include "acnamesp.h"

Include dependency graph for uteval.c:

Go to the source code of this file.

Macros
#define	_COMPONENT   ACPI_UTILITIES

Functions
ACPI_STATUS	AcpiUtEvaluateObject (ACPI_NAMESPACE_NODE *PrefixNode, const char *Path, UINT32 ExpectedReturnBtypes, ACPI_OPERAND_OBJECT **ReturnDesc)
ACPI_STATUS	AcpiUtEvaluateNumericObject (const char *ObjectName, ACPI_NAMESPACE_NODE *DeviceNode, UINT64 *Value)
ACPI_STATUS	AcpiUtExecute_STA (ACPI_NAMESPACE_NODE *DeviceNode, UINT32 *Flags)
ACPI_STATUS	AcpiUtExecutePowerMethods (ACPI_NAMESPACE_NODE *DeviceNode, const char **MethodNames, UINT8 MethodCount, UINT8 *OutValues)

Macro Definition Documentation

_COMPONENT

#define _COMPONENT   ACPI_UTILITIES

Definition at line 49 of file uteval.c.

Function Documentation

AcpiUtEvaluateNumericObject()

ACPI_STATUS AcpiUtEvaluateNumericObject	(	const char *	ObjectName,
		ACPI_NAMESPACE_NODE *	DeviceNode,
		UINT64 *	Value
	)

Definition at line 221 of file uteval.c.

{
    ACPI_OPERAND_OBJECT     *ObjDesc;
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (UtEvaluateNumericObject);
 
 
    Status = AcpiUtEvaluateObject (DeviceNode, ObjectName,
        ACPI_BTYPE_INTEGER, &ObjDesc);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    /* Get the returned Integer */
 
    *Value = ObjDesc->Integer.Value;
 
    /* On exit, we must delete the return object */
 
    AcpiUtRemoveReference (ObjDesc);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiEvPciConfigRegionSetup(), AcpiGetObjectInfo(), and AcpiHwGetPciDeviceInfo().

AcpiUtEvaluateObject()

ACPI_STATUS AcpiUtEvaluateObject	(	ACPI_NAMESPACE_NODE *	PrefixNode,
		const char *	Path,
		UINT32	ExpectedReturnBtypes,
		ACPI_OPERAND_OBJECT **	ReturnDesc
	)

Definition at line 73 of file uteval.c.

{
    ACPI_EVALUATE_INFO      *Info;
    ACPI_STATUS             Status;
    UINT32                  ReturnBtype;
 
 
    ACPI_FUNCTION_TRACE (UtEvaluateObject);
 
 
    /* Allocate the evaluation information block */
 
    Info = ACPI_ALLOCATE_ZEROED (sizeof (ACPI_EVALUATE_INFO));
    if (!Info)
    {
        return_ACPI_STATUS (AE_NO_MEMORY);
    }
 
    Info->PrefixNode = PrefixNode;
    Info->RelativePathname = Path;
 
    /* Evaluate the object/method */
 
    Status = AcpiNsEvaluate (Info);
    if (ACPI_FAILURE (Status))
    {
        if (Status == AE_NOT_FOUND)
        {
            ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[%4.4s.%s] was not found\n",
                AcpiUtGetNodeName (PrefixNode), Path));
        }
        else
        {
            ACPI_ERROR_METHOD ("Method execution failed",
                PrefixNode, Path, Status);
        }
 
        goto Cleanup;
    }
 
    /* Did we get a return object? */
 
    if (!Info->ReturnObject)
    {
        if (ExpectedReturnBtypes)
        {
            ACPI_ERROR_METHOD ("No object was returned from",
                PrefixNode, Path, AE_NOT_EXIST);
 
            Status = AE_NOT_EXIST;
        }
 
        goto Cleanup;
    }
 
    /* Map the return object type to the bitmapped type */
 
    switch ((Info->ReturnObject)->Common.Type)
    {
    case ACPI_TYPE_INTEGER:
 
        ReturnBtype = ACPI_BTYPE_INTEGER;
        break;
 
    case ACPI_TYPE_BUFFER:
 
        ReturnBtype = ACPI_BTYPE_BUFFER;
        break;
 
    case ACPI_TYPE_STRING:
 
        ReturnBtype = ACPI_BTYPE_STRING;
        break;
 
    case ACPI_TYPE_PACKAGE:
 
        ReturnBtype = ACPI_BTYPE_PACKAGE;
        break;
 
    default:
 
        ReturnBtype = 0;
        break;
    }
 
    if ((AcpiGbl_EnableInterpreterSlack) &&
        (!ExpectedReturnBtypes))
    {
        /*
         * 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.
         */
        AcpiUtRemoveReference (Info->ReturnObject);
        goto Cleanup;
    }
 
    /* Is the return object one of the expected types? */
 
    if (!(ExpectedReturnBtypes & ReturnBtype))
    {
        ACPI_ERROR_METHOD ("Return object type is incorrect",
            PrefixNode, Path, AE_TYPE);
 
        ACPI_ERROR ((AE_INFO,
            "Type returned from %s was incorrect: %s, expected Btypes: 0x%X",
            Path, AcpiUtGetObjectTypeName (Info->ReturnObject),
            ExpectedReturnBtypes));
 
        /* On error exit, we must delete the return object */
 
        AcpiUtRemoveReference (Info->ReturnObject);
        Status = AE_TYPE;
        goto Cleanup;
    }
 
    /* Object type is OK, return it */
 
    *ReturnDesc = Info->ReturnObject;
 
Cleanup:
    ACPI_FREE (Info);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiRsGetAeiMethodData(), AcpiRsGetCrsMethodData(), AcpiRsGetMethodData(), AcpiRsGetPrsMethodData(), AcpiRsGetPrtMethodData(), AcpiUtEvaluateNumericObject(), AcpiUtExecute_CID(), AcpiUtExecute_CLS(), AcpiUtExecute_HID(), AcpiUtExecute_STA(), AcpiUtExecute_UID(), and AcpiUtExecutePowerMethods().

AcpiUtExecute_STA()

ACPI_STATUS AcpiUtExecute_STA	(	ACPI_NAMESPACE_NODE *	DeviceNode,
		UINT32 *	Flags
	)

Definition at line 269 of file uteval.c.

{
    ACPI_OPERAND_OBJECT     *ObjDesc;
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (UtExecute_STA);
 
 
    Status = AcpiUtEvaluateObject (DeviceNode, METHOD_NAME__STA,
        ACPI_BTYPE_INTEGER, &ObjDesc);
    if (ACPI_FAILURE (Status))
    {
        if (AE_NOT_FOUND == Status)
        {
            /*
             * if _STA does not exist, then (as per the ACPI specification),
             * the returned flags will indicate that the device is present,
             * functional, and enabled.
             */
            ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
                "_STA on %4.4s was not found, assuming device is present\n",
                AcpiUtGetNodeName (DeviceNode)));
 
            *Flags = ACPI_UINT32_MAX;
            Status = AE_OK;
        }
 
        return_ACPI_STATUS (Status);
    }
 
    /* Extract the status flags */
 
    *Flags = (UINT32) ObjDesc->Integer.Value;
 
    /* On exit, we must delete the return object */
 
    AcpiUtRemoveReference (ObjDesc);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiNsGetDeviceCallback(), and AcpiNsInitOneDevice().

AcpiUtExecutePowerMethods()

ACPI_STATUS AcpiUtExecutePowerMethods	(	ACPI_NAMESPACE_NODE *	DeviceNode,
		const char **	MethodNames,
		UINT8	MethodCount,
		UINT8 *	OutValues
	)

Definition at line 332 of file uteval.c.

{
    ACPI_OPERAND_OBJECT     *ObjDesc;
    ACPI_STATUS             Status;
    ACPI_STATUS             FinalStatus = AE_NOT_FOUND;
    UINT32                  i;
 
 
    ACPI_FUNCTION_TRACE (UtExecutePowerMethods);
 
 
    for (i = 0; i < MethodCount; i++)
    {
        /*
         * Execute the power method (_SxD or _SxW). The only allowable
         * return type is an Integer.
         */
        Status = AcpiUtEvaluateObject (DeviceNode,
            ACPI_CAST_PTR (char, MethodNames[i]),
            ACPI_BTYPE_INTEGER, &ObjDesc);
        if (ACPI_SUCCESS (Status))
        {
            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 (FinalStatus);
}

Referenced by AcpiGetObjectInfo().