utxface.c File Reference

#include "acpi.h"
#include "accommon.h"
#include "acdebug.h"

Include dependency graph for utxface.c:

Go to the source code of this file.

Macros
#define	EXPORT_ACPI_INTERFACES
#define	_COMPONENT   ACPI_UTILITIES

Functions
ACPI_STATUS ACPI_INIT_FUNCTION	AcpiTerminate (void)
ACPI_STATUS	AcpiSubsystemStatus (void)
ACPI_STATUS	AcpiGetSystemInfo (ACPI_BUFFER *OutBuffer)
ACPI_STATUS	AcpiGetStatistics (ACPI_STATISTICS *Stats)
ACPI_STATUS	AcpiInstallInitializationHandler (ACPI_INIT_HANDLER Handler, UINT32 Function)
ACPI_STATUS	AcpiPurgeCachedObjects (void)
ACPI_STATUS	AcpiInstallInterface (ACPI_STRING InterfaceName)
ACPI_STATUS	AcpiRemoveInterface (ACPI_STRING InterfaceName)
ACPI_STATUS	AcpiInstallInterfaceHandler (ACPI_INTERFACE_HANDLER Handler)
ACPI_STATUS	AcpiUpdateInterfaces (UINT8 Action)
UINT32	AcpiCheckAddressRange (ACPI_ADR_SPACE_TYPE SpaceId, ACPI_PHYSICAL_ADDRESS Address, ACPI_SIZE Length, BOOLEAN Warn)
ACPI_STATUS	AcpiDecodePldBuffer (UINT8 *InBuffer, ACPI_SIZE Length, ACPI_PLD_INFO **ReturnBuffer)

Macro Definition Documentation

_COMPONENT

#define _COMPONENT   ACPI_UTILITIES

Definition at line 50 of file utxface.c.

EXPORT_ACPI_INTERFACES

#define EXPORT_ACPI_INTERFACES

Definition at line 44 of file utxface.c.

Function Documentation

AcpiCheckAddressRange()

UINT32 AcpiCheckAddressRange	(	ACPI_ADR_SPACE_TYPE	SpaceId,
		ACPI_PHYSICAL_ADDRESS	Address,
		ACPI_SIZE	Length,
		BOOLEAN	Warn
	)

Definition at line 521 of file utxface.c.

{
    UINT32                  Overlaps;
    ACPI_STATUS             Status;
 
 
    Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
    if (ACPI_FAILURE (Status))
    {
        return (0);
    }
 
    Overlaps = AcpiUtCheckAddressRange (SpaceId, Address,
        (UINT32) Length, Warn);
 
    (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
    return (Overlaps);
}

AcpiDecodePldBuffer()

ACPI_STATUS AcpiDecodePldBuffer	(	UINT8 *	InBuffer,
		ACPI_SIZE	Length,
		ACPI_PLD_INFO **	ReturnBuffer
	)

Definition at line 566 of file utxface.c.

{
    ACPI_PLD_INFO           *PldInfo;
    UINT32                  *Buffer = ACPI_CAST_PTR (UINT32, InBuffer);
    UINT32                  Dword;
 
 
    /* Parameter validation */
 
    if (!InBuffer || !ReturnBuffer || (Length < ACPI_PLD_REV1_BUFFER_SIZE))
    {
        return (AE_BAD_PARAMETER);
    }
 
    PldInfo = ACPI_ALLOCATE_ZEROED (sizeof (ACPI_PLD_INFO));
    if (!PldInfo)
    {
        return (AE_NO_MEMORY);
    }
 
    /* First 32-bit DWord */
 
    ACPI_MOVE_32_TO_32 (&Dword, &Buffer[0]);
    PldInfo->Revision =             ACPI_PLD_GET_REVISION (&Dword);
    PldInfo->IgnoreColor =          ACPI_PLD_GET_IGNORE_COLOR (&Dword);
    PldInfo->Red =                  ACPI_PLD_GET_RED (&Dword);
    PldInfo->Green =                ACPI_PLD_GET_GREEN (&Dword);
    PldInfo->Blue =                 ACPI_PLD_GET_BLUE (&Dword);
 
    /* Second 32-bit DWord */
 
    ACPI_MOVE_32_TO_32 (&Dword, &Buffer[1]);
    PldInfo->Width =                ACPI_PLD_GET_WIDTH (&Dword);
    PldInfo->Height =               ACPI_PLD_GET_HEIGHT(&Dword);
 
    /* Third 32-bit DWord */
 
    ACPI_MOVE_32_TO_32 (&Dword, &Buffer[2]);
    PldInfo->UserVisible =          ACPI_PLD_GET_USER_VISIBLE (&Dword);
    PldInfo->Dock =                 ACPI_PLD_GET_DOCK (&Dword);
    PldInfo->Lid =                  ACPI_PLD_GET_LID (&Dword);
    PldInfo->Panel =                ACPI_PLD_GET_PANEL (&Dword);
    PldInfo->VerticalPosition =     ACPI_PLD_GET_VERTICAL (&Dword);
    PldInfo->HorizontalPosition =   ACPI_PLD_GET_HORIZONTAL (&Dword);
    PldInfo->Shape =                ACPI_PLD_GET_SHAPE (&Dword);
    PldInfo->GroupOrientation =     ACPI_PLD_GET_ORIENTATION (&Dword);
    PldInfo->GroupToken =           ACPI_PLD_GET_TOKEN (&Dword);
    PldInfo->GroupPosition =        ACPI_PLD_GET_POSITION (&Dword);
    PldInfo->Bay =                  ACPI_PLD_GET_BAY (&Dword);
 
    /* Fourth 32-bit DWord */
 
    ACPI_MOVE_32_TO_32 (&Dword, &Buffer[3]);
    PldInfo->Ejectable =            ACPI_PLD_GET_EJECTABLE (&Dword);
    PldInfo->OspmEjectRequired =    ACPI_PLD_GET_OSPM_EJECT (&Dword);
    PldInfo->CabinetNumber =        ACPI_PLD_GET_CABINET (&Dword);
    PldInfo->CardCageNumber =       ACPI_PLD_GET_CARD_CAGE (&Dword);
    PldInfo->Reference =            ACPI_PLD_GET_REFERENCE (&Dword);
    PldInfo->Rotation =             ACPI_PLD_GET_ROTATION (&Dword);
    PldInfo->Order =                ACPI_PLD_GET_ORDER (&Dword);
 
    if (Length >= ACPI_PLD_REV2_BUFFER_SIZE)
    {
        /* Fifth 32-bit DWord (Revision 2 of _PLD) */
 
        ACPI_MOVE_32_TO_32 (&Dword, &Buffer[4]);
        PldInfo->VerticalOffset =       ACPI_PLD_GET_VERT_OFFSET (&Dword);
        PldInfo->HorizontalOffset =     ACPI_PLD_GET_HORIZ_OFFSET (&Dword);
    }
 
    *ReturnBuffer = PldInfo;
    return (AE_OK);
}

AcpiGetStatistics()

ACPI_STATUS AcpiGetStatistics

(

ACPI_STATISTICS *

Stats

)

Definition at line 221 of file utxface.c.

{
    ACPI_FUNCTION_TRACE (AcpiGetStatistics);
 
 
    /* Parameter validation */
 
    if (!Stats)
    {
        return_ACPI_STATUS (AE_BAD_PARAMETER);
    }
 
    /* Various interrupt-based event counters */
 
    Stats->SciCount = AcpiSciCount;
    Stats->GpeCount = AcpiGpeCount;
 
    memcpy (Stats->FixedEventCount, AcpiFixedEventCount,
        sizeof (AcpiFixedEventCount));
 
    /* Other counters */
 
    Stats->MethodCount = AcpiMethodCount;
    return_ACPI_STATUS (AE_OK);
}

Referenced by AcpiGetStatistics().

AcpiGetSystemInfo()

ACPI_STATUS AcpiGetSystemInfo

(

ACPI_BUFFER *

OutBuffer

)

Definition at line 145 of file utxface.c.

{
    ACPI_SYSTEM_INFO        *InfoPtr;
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (AcpiGetSystemInfo);
 
 
    /* Parameter validation */
 
    Status = AcpiUtValidateBuffer (OutBuffer);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    /* Validate/Allocate/Clear caller buffer */
 
    Status = AcpiUtInitializeBuffer (OutBuffer, sizeof (ACPI_SYSTEM_INFO));
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    /*
     * Populate the return buffer
     */
    InfoPtr = (ACPI_SYSTEM_INFO *) OutBuffer->Pointer;
    InfoPtr->AcpiCaVersion = ACPI_CA_VERSION;
 
    /* System flags (ACPI capabilities) */
 
    InfoPtr->Flags = ACPI_SYS_MODE_ACPI;
 
    /* Timer resolution - 24 or 32 bits  */
 
    if (AcpiGbl_FADT.Flags & ACPI_FADT_32BIT_TIMER)
    {
        InfoPtr->TimerResolution = 24;
    }
    else
    {
        InfoPtr->TimerResolution = 32;
    }
 
    /* Clear the reserved fields */
 
    InfoPtr->Reserved1 = 0;
    InfoPtr->Reserved2 = 0;
 
    /* Current debug levels */
 
    InfoPtr->DebugLayer = AcpiDbgLayer;
    InfoPtr->DebugLevel = AcpiDbgLevel;
 
    return_ACPI_STATUS (AE_OK);
}

Referenced by AcpiGetSystemInfo().

AcpiInstallInitializationHandler()

ACPI_STATUS AcpiInstallInitializationHandler	(	ACPI_INIT_HANDLER	Handler,
		UINT32	Function
	)

Definition at line 267 of file utxface.c.

{
 
    if (!Handler)
    {
        return (AE_BAD_PARAMETER);
    }
 
    if (AcpiGbl_InitHandler)
    {
        return (AE_ALREADY_EXISTS);
    }
 
    AcpiGbl_InitHandler = Handler;
    return (AE_OK);
}

AcpiInstallInterface()

ACPI_STATUS AcpiInstallInterface

(

ACPI_STRING

InterfaceName

)

Definition at line 332 of file utxface.c.

{
    ACPI_STATUS             Status;
    ACPI_INTERFACE_INFO     *InterfaceInfo;
 
 
    /* Parameter validation */
 
    if (!InterfaceName || (strlen (InterfaceName) == 0))
    {
        return (AE_BAD_PARAMETER);
    }
 
    Status = AcpiOsAcquireMutex (AcpiGbl_OsiMutex, ACPI_WAIT_FOREVER);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    /* Check if the interface name is already in the global list */
 
    InterfaceInfo = AcpiUtGetInterface (InterfaceName);
    if (InterfaceInfo)
    {
        /*
         * The interface already exists in the list. This is OK if the
         * interface has been marked invalid -- just clear the bit.
         */
        if (InterfaceInfo->Flags & ACPI_OSI_INVALID)
        {
            InterfaceInfo->Flags &= ~ACPI_OSI_INVALID;
            Status = AE_OK;
        }
        else
        {
            Status = AE_ALREADY_EXISTS;
        }
    }
    else
    {
        /* New interface name, install into the global list */
 
        Status = AcpiUtInstallInterface (InterfaceName);
    }
 
    AcpiOsReleaseMutex (AcpiGbl_OsiMutex);
    return (Status);
}

AcpiInstallInterfaceHandler()

ACPI_STATUS AcpiInstallInterfaceHandler

(

ACPI_INTERFACE_HANDLER

Handler

)

Definition at line 442 of file utxface.c.

{
    ACPI_STATUS             Status;
 
 
    Status = AcpiOsAcquireMutex (AcpiGbl_OsiMutex, ACPI_WAIT_FOREVER);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    if (Handler && AcpiGbl_InterfaceHandler)
    {
        Status = AE_ALREADY_EXISTS;
    }
    else
    {
        AcpiGbl_InterfaceHandler = Handler;
    }
 
    AcpiOsReleaseMutex (AcpiGbl_OsiMutex);
    return (Status);
}

AcpiPurgeCachedObjects()

ACPI_STATUS AcpiPurgeCachedObjects

(

void

)

Definition at line 302 of file utxface.c.

{
    ACPI_FUNCTION_TRACE (AcpiPurgeCachedObjects);
 
 
    (void) AcpiOsPurgeCache (AcpiGbl_StateCache);
    (void) AcpiOsPurgeCache (AcpiGbl_OperandCache);
    (void) AcpiOsPurgeCache (AcpiGbl_PsNodeCache);
    (void) AcpiOsPurgeCache (AcpiGbl_PsNodeExtCache);
 
    return_ACPI_STATUS (AE_OK);
}

Referenced by AcpiInitializeObjects(), and AcpiPurgeCachedObjects().

AcpiRemoveInterface()

ACPI_STATUS AcpiRemoveInterface

(

ACPI_STRING

InterfaceName

)

Definition at line 398 of file utxface.c.

{
    ACPI_STATUS             Status;
 
 
    /* Parameter validation */
 
    if (!InterfaceName || (strlen (InterfaceName) == 0))
    {
        return (AE_BAD_PARAMETER);
    }
 
    Status = AcpiOsAcquireMutex (AcpiGbl_OsiMutex, ACPI_WAIT_FOREVER);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    Status = AcpiUtRemoveInterface (InterfaceName);
 
    AcpiOsReleaseMutex (AcpiGbl_OsiMutex);
    return (Status);
}

AcpiSubsystemStatus()

ACPI_STATUS AcpiSubsystemStatus

(

void

)

Definition at line 109 of file utxface.c.

{
 
    if (AcpiGbl_StartupFlags & ACPI_INITIALIZED_OK)
    {
        return (AE_OK);
    }
    else
    {
        return (AE_ERROR);
    }
}

AcpiTerminate()

ACPI_STATUS ACPI_INIT_FUNCTION AcpiTerminate

(

void

)

Definition at line 67 of file utxface.c.

{
    ACPI_STATUS         Status;
 
 
    ACPI_FUNCTION_TRACE (AcpiTerminate);
 
 
    /* Shutdown and free all resources */
 
    AcpiUtSubsystemShutdown ();
 
    /* Free the mutex objects */
 
    AcpiUtMutexTerminate ();
 
    /* Now we can shutdown the OS-dependent layer */
 
    Status = AcpiOsTerminate ();
    return_ACPI_STATUS (Status);
}

Referenced by acpi_bus_exit(), acpi_bus_init(), AcpiTerminate(), and Bus_StartFdo().

AcpiUpdateInterfaces()

ACPI_STATUS AcpiUpdateInterfaces

(

UINT8

Action

)

Definition at line 485 of file utxface.c.

{
    ACPI_STATUS             Status;
 
 
    Status = AcpiOsAcquireMutex (AcpiGbl_OsiMutex, ACPI_WAIT_FOREVER);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    Status = AcpiUtUpdateInterfaces (Action);
 
    AcpiOsReleaseMutex (AcpiGbl_OsiMutex);
    return (Status);
}