exutils.c File Reference

#include "acpi.h"
#include "accommon.h"
#include "acinterp.h"
#include "amlcode.h"

Include dependency graph for exutils.c:

Go to the source code of this file.

Macros
#define	DEFINE_AML_GLOBALS
#define	_COMPONENT   ACPI_EXECUTER

Functions
static UINT32	AcpiExDigitsNeeded (UINT64 Value, UINT32 Base)
void	AcpiExEnterInterpreter (void)
void	AcpiExExitInterpreter (void)
BOOLEAN	AcpiExTruncateFor32bitTable (ACPI_OPERAND_OBJECT *ObjDesc)
void	AcpiExAcquireGlobalLock (UINT32 FieldFlags)
void	AcpiExReleaseGlobalLock (UINT32 FieldFlags)
void	AcpiExEisaIdToString (char *OutString, UINT64 CompressedId)
void	AcpiExIntegerToString (char *OutString, UINT64 Value)
void	AcpiExPciClsToString (char *OutString, UINT8 ClassCode[3])
BOOLEAN	AcpiIsValidSpaceId (UINT8 SpaceId)

Macro Definition Documentation

_COMPONENT

#define _COMPONENT   ACPI_EXECUTER

Definition at line 65 of file exutils.c.

DEFINE_AML_GLOBALS

#define DEFINE_AML_GLOBALS

Definition at line 58 of file exutils.c.

Function Documentation

AcpiExAcquireGlobalLock()

void AcpiExAcquireGlobalLock

(

UINT32

FieldFlags

)

Definition at line 225 of file exutils.c.

{
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (ExAcquireGlobalLock);
 
 
    /* Only use the lock if the AlwaysLock bit is set */
 
    if (!(FieldFlags & AML_FIELD_LOCK_RULE_MASK))
    {
        return_VOID;
    }
 
    /* Attempt to get the global lock, wait forever */
 
    Status = AcpiExAcquireMutexObject (ACPI_WAIT_FOREVER,
        AcpiGbl_GlobalLockMutex, AcpiOsGetThreadId ());
 
    if (ACPI_FAILURE (Status))
    {
        ACPI_EXCEPTION ((AE_INFO, Status,
            "Could not acquire Global Lock"));
    }
 
    return_VOID;
}

Referenced by AcpiExReadDataFromField(), AcpiExReadGpio(), AcpiExReadSerialBus(), AcpiExWriteDataToField(), AcpiExWriteGpio(), and AcpiExWriteSerialBus().

AcpiExDigitsNeeded()

static UINT32 AcpiExDigitsNeeded ( UINT64  Value, UINT32  Base  )

static

Definition at line 316 of file exutils.c.

{
    UINT32                  NumDigits;
    UINT64                  CurrentValue;
 
 
    ACPI_FUNCTION_TRACE (ExDigitsNeeded);
 
 
    /* UINT64 is unsigned, so we don't worry about a '-' prefix */
 
    if (Value == 0)
    {
        return_UINT32 (1);
    }
 
    CurrentValue = Value;
    NumDigits = 0;
 
    /* Count the digits in the requested base */
 
    while (CurrentValue)
    {
        (void) AcpiUtShortDivide (CurrentValue, Base, &CurrentValue, NULL);
        NumDigits++;
    }
 
    return_UINT32 (NumDigits);
}

Referenced by AcpiExIntegerToString().

AcpiExEisaIdToString()

void AcpiExEisaIdToString	(	char *	OutString,
		UINT64	CompressedId
	)

Definition at line 366 of file exutils.c.

{
    UINT32                  SwappedId;
 
 
    ACPI_FUNCTION_ENTRY ();
 
 
    /* The EISAID should be a 32-bit integer */
 
    if (CompressedId > ACPI_UINT32_MAX)
    {
        ACPI_WARNING ((AE_INFO,
            "Expected EISAID is larger than 32 bits: "
            "0x%8.8X%8.8X, truncating",
            ACPI_FORMAT_UINT64 (CompressedId)));
    }
 
    /* Swap ID to big-endian to get contiguous bits */
 
    SwappedId = AcpiUtDwordByteSwap ((UINT32) CompressedId);
 
    /* First 3 bytes are uppercase letters. Next 4 bytes are hexadecimal */
 
    OutString[0] = (char) (0x40 + (((unsigned long) SwappedId >> 26) & 0x1F));
    OutString[1] = (char) (0x40 + ((SwappedId >> 21) & 0x1F));
    OutString[2] = (char) (0x40 + ((SwappedId >> 16) & 0x1F));
    OutString[3] = AcpiUtHexToAsciiChar ((UINT64) SwappedId, 12);
    OutString[4] = AcpiUtHexToAsciiChar ((UINT64) SwappedId, 8);
    OutString[5] = AcpiUtHexToAsciiChar ((UINT64) SwappedId, 4);
    OutString[6] = AcpiUtHexToAsciiChar ((UINT64) SwappedId, 0);
    OutString[7] = 0;
}

Referenced by AcpiUtExecute_CID(), and AcpiUtExecute_HID().

AcpiExEnterInterpreter()

void AcpiExEnterInterpreter

(

void

)

Definition at line 91 of file exutils.c.

{
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (ExEnterInterpreter);
 
 
    Status = AcpiUtAcquireMutex (ACPI_MTX_INTERPRETER);
    if (ACPI_FAILURE (Status))
    {
        ACPI_ERROR ((AE_INFO, "Could not acquire AML Interpreter mutex"));
    }
    Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
    if (ACPI_FAILURE (Status))
    {
        ACPI_ERROR ((AE_INFO, "Could not acquire AML Namespace mutex"));
    }
 
    return_VOID;
}

Referenced by AcpiAcquireGlobalLock(), AcpiDsMethodError(), AcpiDsTerminateControlMethod(), AcpiEvAddressSpaceDispatch(), AcpiEvaluateObject(), AcpiEvInitializeRegion(), AcpiExLoadOp(), AcpiExLoadTableOp(), AcpiExSystemDoSleep(), AcpiExSystemWaitMutex(), AcpiExSystemWaitSemaphore(), AcpiExUnloadTable(), AcpiNsEvaluate(), AcpiNsInitOneObject(), AcpiNsLoadTable(), AcpiNsOneCompleteParse(), AcpiPsExecuteTable(), and AcpiPsParseAml().

AcpiExExitInterpreter()

void AcpiExExitInterpreter

(

void

)

Definition at line 139 of file exutils.c.

{
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (ExExitInterpreter);
 
 
    Status = AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
    if (ACPI_FAILURE (Status))
    {
        ACPI_ERROR ((AE_INFO, "Could not release AML Namespace mutex"));
    }
    Status = AcpiUtReleaseMutex (ACPI_MTX_INTERPRETER);
    if (ACPI_FAILURE (Status))
    {
        ACPI_ERROR ((AE_INFO, "Could not release AML Interpreter mutex"));
    }
 
    return_VOID;
}

Referenced by AcpiAcquireGlobalLock(), AcpiDsMethodError(), AcpiDsTerminateControlMethod(), AcpiEvAddressSpaceDispatch(), AcpiEvaluateObject(), AcpiEvInitializeRegion(), AcpiExLoadOp(), AcpiExLoadTableOp(), AcpiExSystemDoSleep(), AcpiExSystemWaitMutex(), AcpiExSystemWaitSemaphore(), AcpiExUnloadTable(), AcpiNsEvaluate(), AcpiNsInitOneObject(), AcpiNsLoadTable(), AcpiNsOneCompleteParse(), AcpiPsExecuteTable(), and AcpiPsParseAml().

AcpiExIntegerToString()

void AcpiExIntegerToString	(	char *	OutString,
		UINT64	Value
	)

Definition at line 421 of file exutils.c.

{
    UINT32                  Count;
    UINT32                  DigitsNeeded;
    UINT32                  Remainder;
 
 
    ACPI_FUNCTION_ENTRY ();
 
 
    DigitsNeeded = AcpiExDigitsNeeded (Value, 10);
    OutString[DigitsNeeded] = 0;
 
    for (Count = DigitsNeeded; Count > 0; Count--)
    {
        (void) AcpiUtShortDivide (Value, 10, &Value, &Remainder);
        OutString[Count-1] = (char) ('0' + Remainder);\
    }
}

Referenced by AcpiUtExecute_UID().

AcpiExPciClsToString()

void AcpiExPciClsToString	(	char *	OutString,
		UINT8	ClassCode[3]
	)

Definition at line 461 of file exutils.c.

{
 
    ACPI_FUNCTION_ENTRY ();
 
 
    /* All 3 bytes are hexadecimal */
 
    OutString[0] = AcpiUtHexToAsciiChar ((UINT64) ClassCode[0], 4);
    OutString[1] = AcpiUtHexToAsciiChar ((UINT64) ClassCode[0], 0);
    OutString[2] = AcpiUtHexToAsciiChar ((UINT64) ClassCode[1], 4);
    OutString[3] = AcpiUtHexToAsciiChar ((UINT64) ClassCode[1], 0);
    OutString[4] = AcpiUtHexToAsciiChar ((UINT64) ClassCode[2], 4);
    OutString[5] = AcpiUtHexToAsciiChar ((UINT64) ClassCode[2], 0);
    OutString[6] = 0;
}

Referenced by AcpiUtExecute_CLS().

AcpiExReleaseGlobalLock()

void AcpiExReleaseGlobalLock

(

UINT32

FieldFlags

)

Definition at line 270 of file exutils.c.

{
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (ExReleaseGlobalLock);
 
 
    /* Only use the lock if the AlwaysLock bit is set */
 
    if (!(FieldFlags & AML_FIELD_LOCK_RULE_MASK))
    {
        return_VOID;
    }
 
    /* Release the global lock */
 
    Status = AcpiExReleaseMutexObject (AcpiGbl_GlobalLockMutex);
    if (ACPI_FAILURE (Status))
    {
        /* Report the error, but there isn't much else we can do */
 
        ACPI_EXCEPTION ((AE_INFO, Status,
            "Could not release Global Lock"));
    }
 
    return_VOID;
}

Referenced by AcpiExReadDataFromField(), AcpiExReadGpio(), AcpiExReadSerialBus(), AcpiExWriteDataToField(), AcpiExWriteGpio(), and AcpiExWriteSerialBus().

AcpiExTruncateFor32bitTable()

BOOLEAN AcpiExTruncateFor32bitTable

(

ACPI_OPERAND_OBJECT *

ObjDesc

)

Definition at line 177 of file exutils.c.

{
 
    ACPI_FUNCTION_ENTRY ();
 
 
    /*
     * Object must be a valid number and we must be executing
     * a control method. Object could be NS node for AML_INT_NAMEPATH_OP.
     */
    if ((!ObjDesc) ||
        (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) != ACPI_DESC_TYPE_OPERAND) ||
        (ObjDesc->Common.Type != ACPI_TYPE_INTEGER))
    {
        return (FALSE);
    }
 
    if ((AcpiGbl_IntegerByteWidth == 4) &&
        (ObjDesc->Integer.Value > (UINT64) ACPI_UINT32_MAX))
    {
        /*
         * We are executing in a 32-bit ACPI table. Truncate
         * the value to 32 bits by zeroing out the upper 32-bit field
         */
        ObjDesc->Integer.Value &= (UINT64) ACPI_UINT32_MAX;
        return (TRUE);
    }
 
    return (FALSE);
}

Referenced by AcpiDsExecEndOp(), AcpiDsGetPredicateValue(), AcpiDsInitObjectFromOp(), AcpiExConvertToInteger(), and AcpiExStoreObjectToObject().

AcpiIsValidSpaceId()

BOOLEAN AcpiIsValidSpaceId

(

UINT8

SpaceId

)

Definition at line 494 of file exutils.c.

{
 
    if ((SpaceId >= ACPI_NUM_PREDEFINED_REGIONS) &&
        (SpaceId < ACPI_USER_REGION_BEGIN) &&
        (SpaceId != ACPI_ADR_SPACE_DATA_TABLE) &&
        (SpaceId != ACPI_ADR_SPACE_FIXED_HARDWARE))
    {
        return (FALSE);
    }
 
    return (TRUE);
}

Referenced by AcpiExCreateRegion(), and AcpiExSetupRegion().