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

Include dependency graph for rsxface.c:

Macros
#define	EXPORT_ACPI_INTERFACES

#define	_COMPONENT ACPI_RESOURCES

#define	ACPI_COPY_FIELD(Out, In, Field) ((Out)->Field = (In)->Field)

#define	ACPI_COPY_ADDRESS(Out, In)

Functions
static ACPI_STATUS	AcpiRsMatchVendorResource (ACPI_RESOURCE Resource, void Context)

static ACPI_STATUS	AcpiRsValidateParameters (ACPI_HANDLE DeviceHandle, ACPI_BUFFER Buffer, ACPI_NAMESPACE_NODE *ReturnNode)

ACPI_STATUS	AcpiGetIrqRoutingTable (ACPI_HANDLE DeviceHandle, ACPI_BUFFER *RetBuffer)

ACPI_STATUS	AcpiGetCurrentResources (ACPI_HANDLE DeviceHandle, ACPI_BUFFER *RetBuffer)

ACPI_STATUS	AcpiGetPossibleResources (ACPI_HANDLE DeviceHandle, ACPI_BUFFER *RetBuffer)

ACPI_STATUS	AcpiSetCurrentResources (ACPI_HANDLE DeviceHandle, ACPI_BUFFER *InBuffer)

ACPI_STATUS	AcpiGetEventResources (ACPI_HANDLE DeviceHandle, ACPI_BUFFER *RetBuffer)

ACPI_STATUS	AcpiResourceToAddress64 (ACPI_RESOURCE Resource, ACPI_RESOURCE_ADDRESS64 Out)

ACPI_STATUS	AcpiGetVendorResource (ACPI_HANDLE DeviceHandle, char Name, ACPI_VENDOR_UUID Uuid, ACPI_BUFFER *RetBuffer)

ACPI_STATUS	AcpiWalkResourceBuffer (ACPI_BUFFER Buffer, ACPI_WALK_RESOURCE_CALLBACK UserFunction, void Context)

ACPI_STATUS	AcpiWalkResources (ACPI_HANDLE DeviceHandle, char Name, ACPI_WALK_RESOURCE_CALLBACK UserFunction, void Context)

Macro Definition Documentation

◆ _COMPONENT

#define _COMPONENT ACPI_RESOURCES

Definition at line 51 of file rsxface.c.

◆ ACPI_COPY_ADDRESS

#define ACPI_COPY_ADDRESS	(	Out,
		In
	)

Value:

    ACPI_COPY_FIELD(Out, In, ResourceType);              \
    ACPI_COPY_FIELD(Out, In, ProducerConsumer);          \
    ACPI_COPY_FIELD(Out, In, Decode);                    \
    ACPI_COPY_FIELD(Out, In, MinAddressFixed);           \
    ACPI_COPY_FIELD(Out, In, MaxAddressFixed);           \
    ACPI_COPY_FIELD(Out, In, Info);                      \
    ACPI_COPY_FIELD(Out, In, Address.Granularity);       \
    ACPI_COPY_FIELD(Out, In, Address.Minimum);           \
    ACPI_COPY_FIELD(Out, In, Address.Maximum);           \
    ACPI_COPY_FIELD(Out, In, Address.TranslationOffset); \
    ACPI_COPY_FIELD(Out, In, Address.AddressLength);     \
    ACPI_COPY_FIELD(Out, In, ResourceSource);

Definition at line 57 of file rsxface.c.

◆ ACPI_COPY_FIELD

#define ACPI_COPY_FIELD	(	Out,
		In,
		Field
	)	((Out)->Field = (In)->Field)

Definition at line 56 of file rsxface.c.

◆ EXPORT_ACPI_INTERFACES

#define EXPORT_ACPI_INTERFACES

Definition at line 44 of file rsxface.c.

Function Documentation

◆ AcpiGetCurrentResources()

ACPI_STATUS AcpiGetCurrentResources	(	ACPI_HANDLE	DeviceHandle,
		ACPI_BUFFER *	RetBuffer
	)

Definition at line 225 of file rsxface.c.

{
    ACPI_STATUS             Status;
    ACPI_NAMESPACE_NODE     *Node;
 
 
    ACPI_FUNCTION_TRACE (AcpiGetCurrentResources);
 
 
    /* Validate parameters then dispatch to internal routine */
 
    Status = AcpiRsValidateParameters (DeviceHandle, RetBuffer, &Node);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    Status = AcpiRsGetCrsMethodData (Node, RetBuffer);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiGetCurrentResources(), Bus_PDO_QueryResourceRequirements(), and Bus_PDO_QueryResources().

◆ AcpiGetEventResources()

ACPI_STATUS AcpiGetEventResources	(	ACPI_HANDLE	DeviceHandle,
		ACPI_BUFFER *	RetBuffer
	)

Definition at line 373 of file rsxface.c.

{
    ACPI_STATUS             Status;
    ACPI_NAMESPACE_NODE     *Node;
 
 
    ACPI_FUNCTION_TRACE (AcpiGetEventResources);
 
 
    /* Validate parameters then dispatch to internal routine */
 
    Status = AcpiRsValidateParameters (DeviceHandle, RetBuffer, &Node);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    Status = AcpiRsGetAeiMethodData (Node, RetBuffer);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiGetEventResources().

◆ AcpiGetIrqRoutingTable()

ACPI_STATUS AcpiGetIrqRoutingTable	(	ACPI_HANDLE	DeviceHandle,
		ACPI_BUFFER *	RetBuffer
	)

Definition at line 174 of file rsxface.c.

{
    ACPI_STATUS             Status;
    ACPI_NAMESPACE_NODE     *Node;
 
 
    ACPI_FUNCTION_TRACE (AcpiGetIrqRoutingTable);
 
 
    /* Validate parameters then dispatch to internal routine */
 
    Status = AcpiRsValidateParameters (DeviceHandle, RetBuffer, &Node);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    Status = AcpiRsGetPrtMethodData (Node, RetBuffer);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiGetIrqRoutingTable().

◆ AcpiGetPossibleResources()

ACPI_STATUS AcpiGetPossibleResources	(	ACPI_HANDLE	DeviceHandle,
		ACPI_BUFFER *	RetBuffer
	)

Definition at line 273 of file rsxface.c.

{
    ACPI_STATUS             Status;
    ACPI_NAMESPACE_NODE     *Node;
 
 
    ACPI_FUNCTION_TRACE (AcpiGetPossibleResources);
 
 
    /* Validate parameters then dispatch to internal routine */
 
    Status = AcpiRsValidateParameters (DeviceHandle, RetBuffer, &Node);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    Status = AcpiRsGetPrsMethodData (Node, RetBuffer);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiGetPossibleResources(), and Bus_PDO_QueryResourceRequirements().

◆ AcpiGetVendorResource()

ACPI_STATUS AcpiGetVendorResource	(	ACPI_HANDLE	DeviceHandle,
		char *	Name,
		ACPI_VENDOR_UUID *	Uuid,
		ACPI_BUFFER *	RetBuffer
	)

Definition at line 486 of file rsxface.c.

{
    ACPI_VENDOR_WALK_INFO   Info;
    ACPI_STATUS             Status;
 
 
    /* Other parameters are validated by AcpiWalkResources */
 
    if (!Uuid || !RetBuffer)
    {
        return (AE_BAD_PARAMETER);
    }
 
    Info.Uuid = Uuid;
    Info.Buffer = RetBuffer;
    Info.Status = AE_NOT_EXIST;
 
    /* Walk the _CRS or _PRS resource list for this device */
 
    Status = AcpiWalkResources (
        DeviceHandle, Name, AcpiRsMatchVendorResource, &Info);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    return (Info.Status);
}

◆ AcpiResourceToAddress64()

ACPI_STATUS AcpiResourceToAddress64	(	ACPI_RESOURCE *	Resource,
		ACPI_RESOURCE_ADDRESS64 *	Out
	)

Definition at line 417 of file rsxface.c.

{
    ACPI_RESOURCE_ADDRESS16     *Address16;
    ACPI_RESOURCE_ADDRESS32     *Address32;
 
 
    if (!Resource || !Out)
    {
        return (AE_BAD_PARAMETER);
    }
 
    /* Convert 16 or 32 address descriptor to 64 */
 
    switch (Resource->Type)
    {
    case ACPI_RESOURCE_TYPE_ADDRESS16:
 
        Address16 = ACPI_CAST_PTR (
            ACPI_RESOURCE_ADDRESS16, &Resource->Data);
        ACPI_COPY_ADDRESS (Out, Address16);
        break;
 
    case ACPI_RESOURCE_TYPE_ADDRESS32:
 
        Address32 = ACPI_CAST_PTR (
            ACPI_RESOURCE_ADDRESS32, &Resource->Data);
        ACPI_COPY_ADDRESS (Out, Address32);
        break;
 
    case ACPI_RESOURCE_TYPE_ADDRESS64:
 
        /* Simple copy for 64 bit source */
 
        memcpy (Out, &Resource->Data, sizeof (ACPI_RESOURCE_ADDRESS64));
        break;
 
    default:
 
        return (AE_BAD_PARAMETER);
    }
 
    return (AE_OK);
}

◆ AcpiRsMatchVendorResource()

static ACPI_STATUS AcpiRsMatchVendorResource	(	ACPI_RESOURCE *	Resource,
		void *	Context
	)

static

Definition at line 535 of file rsxface.c.

{
    ACPI_VENDOR_WALK_INFO       *Info = Context;
    ACPI_RESOURCE_VENDOR_TYPED  *Vendor;
    ACPI_BUFFER                 *Buffer;
    ACPI_STATUS                 Status;
 
 
    /* Ignore all descriptors except Vendor */
 
    if (Resource->Type != ACPI_RESOURCE_TYPE_VENDOR)
    {
        return (AE_OK);
    }
 
    Vendor = &Resource->Data.VendorTyped;
 
    /*
     * For a valid match, these conditions must hold:
     *
     * 1) Length of descriptor data must be at least as long as a UUID struct
     * 2) The UUID subtypes must match
     * 3) The UUID data must match
     */
    if ((Vendor->ByteLength < (ACPI_UUID_LENGTH + 1)) ||
        (Vendor->UuidSubtype != Info->Uuid->Subtype)  ||
        (memcmp (Vendor->Uuid, Info->Uuid->Data, ACPI_UUID_LENGTH)))
    {
        return (AE_OK);
    }
 
    /* Validate/Allocate/Clear caller buffer */
 
    Buffer = Info->Buffer;
    Status = AcpiUtInitializeBuffer (Buffer, Resource->Length);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    /* Found the correct resource, copy and return it */
 
    memcpy (Buffer->Pointer, Resource, Resource->Length);
    Buffer->Length = Resource->Length;
 
    /* Found the desired descriptor, terminate resource walk */
 
    Info->Status = AE_OK;
    return (AE_CTRL_TERMINATE);
}

Referenced by AcpiGetVendorResource().

◆ AcpiRsValidateParameters()

static ACPI_STATUS AcpiRsValidateParameters	(	ACPI_HANDLE	DeviceHandle,
		ACPI_BUFFER *	Buffer,
		ACPI_NAMESPACE_NODE **	ReturnNode
	)

static

Definition at line 101 of file rsxface.c.

{
    ACPI_STATUS             Status;
    ACPI_NAMESPACE_NODE     *Node;
 
 
    ACPI_FUNCTION_TRACE (RsValidateParameters);
 
 
    /*
     * Must have a valid handle to an ACPI device
     */
    if (!DeviceHandle)
    {
        return_ACPI_STATUS (AE_BAD_PARAMETER);
    }
 
    Node = AcpiNsValidateHandle (DeviceHandle);
    if (!Node)
    {
        return_ACPI_STATUS (AE_BAD_PARAMETER);
    }
 
    if (Node->Type != ACPI_TYPE_DEVICE)
    {
        return_ACPI_STATUS (AE_TYPE);
    }
 
    /*
     * Validate the user buffer object
     *
     * if there is a non-zero buffer length we also need a valid pointer in
     * the buffer. If it's a zero buffer length, we'll be returning the
     * needed buffer size (later), so keep going.
     */
    Status = AcpiUtValidateBuffer (Buffer);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    *ReturnNode = Node;
    return_ACPI_STATUS (AE_OK);
}

Referenced by AcpiGetCurrentResources(), AcpiGetEventResources(), AcpiGetIrqRoutingTable(), AcpiGetPossibleResources(), and AcpiSetCurrentResources().

◆ AcpiSetCurrentResources()

ACPI_STATUS AcpiSetCurrentResources	(	ACPI_HANDLE	DeviceHandle,
		ACPI_BUFFER *	InBuffer
	)

Definition at line 318 of file rsxface.c.

{
    ACPI_STATUS             Status;
    ACPI_NAMESPACE_NODE     *Node;
 
 
    ACPI_FUNCTION_TRACE (AcpiSetCurrentResources);
 
 
    /* Validate the buffer, don't allow zero length */
 
    if ((!InBuffer) ||
        (!InBuffer->Pointer) ||
        (!InBuffer->Length))
    {
        return_ACPI_STATUS (AE_BAD_PARAMETER);
    }
 
    /* Validate parameters then dispatch to internal routine */
 
    Status = AcpiRsValidateParameters (DeviceHandle, InBuffer, &Node);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    Status = AcpiRsSetSrsMethodData (Node, InBuffer);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiSetCurrentResources().

◆ AcpiWalkResourceBuffer()

ACPI_STATUS AcpiWalkResourceBuffer	(	ACPI_BUFFER *	Buffer,
		ACPI_WALK_RESOURCE_CALLBACK	UserFunction,
		void *	Context
	)

Definition at line 606 of file rsxface.c.

{
    ACPI_STATUS                 Status = AE_OK;
    ACPI_RESOURCE               *Resource;
    ACPI_RESOURCE               *ResourceEnd;
 
 
    ACPI_FUNCTION_TRACE (AcpiWalkResourceBuffer);
 
 
    /* Parameter validation */
 
    if (!Buffer || !Buffer->Pointer || !UserFunction)
    {
        return_ACPI_STATUS (AE_BAD_PARAMETER);
    }
 
    /* Buffer contains the resource list and length */
 
    Resource = ACPI_CAST_PTR (ACPI_RESOURCE, Buffer->Pointer);
    ResourceEnd = ACPI_ADD_PTR (
        ACPI_RESOURCE, Buffer->Pointer, Buffer->Length);
 
    /* Walk the resource list until the EndTag is found (or buffer end) */
 
    while (Resource < ResourceEnd)
    {
        /* Sanity check the resource type */
 
        if (Resource->Type > ACPI_RESOURCE_TYPE_MAX)
        {
            Status = AE_AML_INVALID_RESOURCE_TYPE;
            break;
        }
 
        /* Sanity check the length. It must not be zero, or we loop forever */
 
        if (!Resource->Length)
        {
            return_ACPI_STATUS (AE_AML_BAD_RESOURCE_LENGTH);
        }
 
        /* Invoke the user function, abort on any error returned */
 
        Status = UserFunction (Resource, Context);
        if (ACPI_FAILURE (Status))
        {
            if (Status == AE_CTRL_TERMINATE)
            {
                /* This is an OK termination by the user function */
 
                Status = AE_OK;
            }
            break;
        }
 
        /* EndTag indicates end-of-list */
 
        if (Resource->Type == ACPI_RESOURCE_TYPE_END_TAG)
        {
            break;
        }
 
        /* Get the next resource descriptor */
 
        Resource = ACPI_NEXT_RESOURCE (Resource);
    }
 
    return_ACPI_STATUS (Status);
}

Referenced by AcpiWalkResourceBuffer(), and AcpiWalkResources().

◆ AcpiWalkResources()

ACPI_STATUS AcpiWalkResources	(	ACPI_HANDLE	DeviceHandle,
		char *	Name,
		ACPI_WALK_RESOURCE_CALLBACK	UserFunction,
		void *	Context
	)

Definition at line 704 of file rsxface.c.

{
    ACPI_STATUS                 Status;
    ACPI_BUFFER                 Buffer;
 
 
    ACPI_FUNCTION_TRACE (AcpiWalkResources);
 
 
    /* Parameter validation */
 
    if (!DeviceHandle || !UserFunction || !Name ||
        (!ACPI_COMPARE_NAMESEG (Name, METHOD_NAME__CRS) &&
         !ACPI_COMPARE_NAMESEG (Name, METHOD_NAME__PRS) &&
         !ACPI_COMPARE_NAMESEG (Name, METHOD_NAME__AEI) &&
         !ACPI_COMPARE_NAMESEG (Name, METHOD_NAME__DMA)))
    {
        return_ACPI_STATUS (AE_BAD_PARAMETER);
    }
 
    /* Get the _CRS/_PRS/_AEI/_DMA resource list */
 
    Buffer.Length = ACPI_ALLOCATE_LOCAL_BUFFER;
    Status = AcpiRsGetMethodData (DeviceHandle, Name, &Buffer);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    /* Walk the resource list and cleanup */
 
    Status = AcpiWalkResourceBuffer (&Buffer, UserFunction, Context);
    ACPI_FREE (Buffer.Pointer);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiGetVendorResource(), and AcpiWalkResources().

Macros

Functions