rsutils.c File Reference

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

Include dependency graph for rsutils.c:

Go to the source code of this file.

Macros
#define	_COMPONENT   ACPI_RESOURCES

Functions
UINT8	AcpiRsDecodeBitmask (UINT16 Mask, UINT8 *List)
UINT16	AcpiRsEncodeBitmask (UINT8 *List, UINT8 Count)
void	AcpiRsMoveData (void *Destination, void *Source, UINT16 ItemCount, UINT8 MoveType)
void	AcpiRsSetResourceLength (ACPI_RSDESC_SIZE TotalLength, AML_RESOURCE *Aml)
void	AcpiRsSetResourceHeader (UINT8 DescriptorType, ACPI_RSDESC_SIZE TotalLength, AML_RESOURCE *Aml)
static UINT16	AcpiRsStrcpy (char *Destination, char *Source)
ACPI_RS_LENGTH	AcpiRsGetResourceSource (ACPI_RS_LENGTH ResourceLength, ACPI_RS_LENGTH MinimumLength, ACPI_RESOURCE_SOURCE *ResourceSource, AML_RESOURCE *Aml, char *StringPtr)
ACPI_RSDESC_SIZE	AcpiRsSetResourceSource (AML_RESOURCE *Aml, ACPI_RS_LENGTH MinimumLength, ACPI_RESOURCE_SOURCE *ResourceSource)
ACPI_STATUS	AcpiRsGetPrtMethodData (ACPI_NAMESPACE_NODE *Node, ACPI_BUFFER *RetBuffer)
ACPI_STATUS	AcpiRsGetCrsMethodData (ACPI_NAMESPACE_NODE *Node, ACPI_BUFFER *RetBuffer)
ACPI_STATUS	AcpiRsGetPrsMethodData (ACPI_NAMESPACE_NODE *Node, ACPI_BUFFER *RetBuffer)
ACPI_STATUS	AcpiRsGetAeiMethodData (ACPI_NAMESPACE_NODE *Node, ACPI_BUFFER *RetBuffer)
ACPI_STATUS	AcpiRsGetMethodData (ACPI_HANDLE Handle, const char *Path, ACPI_BUFFER *RetBuffer)
ACPI_STATUS	AcpiRsSetSrsMethodData (ACPI_NAMESPACE_NODE *Node, ACPI_BUFFER *InBuffer)

Macro Definition Documentation

_COMPONENT

#define _COMPONENT   ACPI_RESOURCES

Definition at line 50 of file rsutils.c.

Function Documentation

AcpiRsDecodeBitmask()

UINT8 AcpiRsDecodeBitmask	(	UINT16	Mask,
		UINT8 *	List
	)

Definition at line 68 of file rsutils.c.

{
    UINT8                   i;
    UINT8                   BitCount;
 
 
    ACPI_FUNCTION_ENTRY ();
 
 
    /* Decode the mask bits */
 
    for (i = 0, BitCount = 0; Mask; i++)
    {
        if (Mask & 0x0001)
        {
            List[BitCount] = i;
            BitCount++;
        }
 
        Mask >>= 1;
    }
 
    return (BitCount);
}

Referenced by AcpiRsConvertAmlToResource().

AcpiRsEncodeBitmask()

UINT16 AcpiRsEncodeBitmask	(	UINT8 *	List,
		UINT8	Count
	)

Definition at line 110 of file rsutils.c.

{
    UINT32                  i;
    UINT16                  Mask;
 
 
    ACPI_FUNCTION_ENTRY ();
 
 
    /* Encode the list into a single bitmask */
 
    for (i = 0, Mask = 0; i < Count; i++)
    {
        Mask |= (0x1 << List[i]);
    }
 
    return (Mask);
}

Referenced by AcpiRsConvertResourceToAml().

AcpiRsGetAeiMethodData()

ACPI_STATUS AcpiRsGetAeiMethodData	(	ACPI_NAMESPACE_NODE *	Node,
		ACPI_BUFFER *	RetBuffer
	)

Definition at line 685 of file rsutils.c.

{
    ACPI_OPERAND_OBJECT     *ObjDesc;
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (RsGetAeiMethodData);
 
 
    /* Parameters guaranteed valid by caller */
 
    /* Execute the method, no parameters */
 
    Status = AcpiUtEvaluateObject (
        Node, METHOD_NAME__AEI, ACPI_BTYPE_BUFFER, &ObjDesc);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    /*
     * Make the call to create a resource linked list from the
     * byte stream buffer that comes back from the _CRS method
     * execution.
     */
    Status = AcpiRsCreateResourceList (ObjDesc, RetBuffer);
 
    /* On exit, we must delete the object returned by evaluateObject */
 
    AcpiUtRemoveReference (ObjDesc);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiGetEventResources().

AcpiRsGetCrsMethodData()

ACPI_STATUS AcpiRsGetCrsMethodData	(	ACPI_NAMESPACE_NODE *	Node,
		ACPI_BUFFER *	RetBuffer
	)

Definition at line 575 of file rsutils.c.

{
    ACPI_OPERAND_OBJECT     *ObjDesc;
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (RsGetCrsMethodData);
 
 
    /* Parameters guaranteed valid by caller */
 
    /* Execute the method, no parameters */
 
    Status = AcpiUtEvaluateObject (
        Node, METHOD_NAME__CRS, ACPI_BTYPE_BUFFER, &ObjDesc);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    /*
     * Make the call to create a resource linked list from the
     * byte stream buffer that comes back from the _CRS method
     * execution.
     */
    Status = AcpiRsCreateResourceList (ObjDesc, RetBuffer);
 
    /* On exit, we must delete the object returned by evaluateObject */
 
    AcpiUtRemoveReference (ObjDesc);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiGetCurrentResources().

AcpiRsGetMethodData()

ACPI_STATUS AcpiRsGetMethodData	(	ACPI_HANDLE	Handle,
		const char *	Path,
		ACPI_BUFFER *	RetBuffer
	)

Definition at line 741 of file rsutils.c.

{
    ACPI_OPERAND_OBJECT     *ObjDesc;
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (RsGetMethodData);
 
 
    /* Parameters guaranteed valid by caller */
 
    /* Execute the method, no parameters */
 
    Status = AcpiUtEvaluateObject (
        ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, Handle),
        Path, ACPI_BTYPE_BUFFER, &ObjDesc);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    /*
     * Make the call to create a resource linked list from the
     * byte stream buffer that comes back from the method
     * execution.
     */
    Status = AcpiRsCreateResourceList (ObjDesc, RetBuffer);
 
    /* On exit, we must delete the object returned by EvaluateObject */
 
    AcpiUtRemoveReference (ObjDesc);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiWalkResources().

AcpiRsGetPrsMethodData()

ACPI_STATUS AcpiRsGetPrsMethodData	(	ACPI_NAMESPACE_NODE *	Node,
		ACPI_BUFFER *	RetBuffer
	)

Definition at line 630 of file rsutils.c.

{
    ACPI_OPERAND_OBJECT     *ObjDesc;
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (RsGetPrsMethodData);
 
 
    /* Parameters guaranteed valid by caller */
 
    /* Execute the method, no parameters */
 
    Status = AcpiUtEvaluateObject (
        Node, METHOD_NAME__PRS, ACPI_BTYPE_BUFFER, &ObjDesc);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    /*
     * Make the call to create a resource linked list from the
     * byte stream buffer that comes back from the _CRS method
     * execution.
     */
    Status = AcpiRsCreateResourceList (ObjDesc, RetBuffer);
 
    /* On exit, we must delete the object returned by evaluateObject */
 
    AcpiUtRemoveReference (ObjDesc);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiGetPossibleResources().

AcpiRsGetPrtMethodData()

ACPI_STATUS AcpiRsGetPrtMethodData	(	ACPI_NAMESPACE_NODE *	Node,
		ACPI_BUFFER *	RetBuffer
	)

Definition at line 521 of file rsutils.c.

{
    ACPI_OPERAND_OBJECT     *ObjDesc;
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (RsGetPrtMethodData);
 
 
    /* Parameters guaranteed valid by caller */
 
    /* Execute the method, no parameters */
 
    Status = AcpiUtEvaluateObject (
        Node, METHOD_NAME__PRT, ACPI_BTYPE_PACKAGE, &ObjDesc);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    /*
     * Create a resource linked list from the byte stream buffer that comes
     * back from the _CRS method execution.
     */
    Status = AcpiRsCreatePciRoutingTable (ObjDesc, RetBuffer);
 
    /* On exit, we must delete the object returned by EvaluateObject */
 
    AcpiUtRemoveReference (ObjDesc);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiGetIrqRoutingTable().

AcpiRsGetResourceSource()

ACPI_RS_LENGTH AcpiRsGetResourceSource	(	ACPI_RS_LENGTH	ResourceLength,
		ACPI_RS_LENGTH	MinimumLength,
		ACPI_RESOURCE_SOURCE *	ResourceSource,
		AML_RESOURCE *	Aml,
		char *	StringPtr
	)

Definition at line 366 of file rsutils.c.

{
    ACPI_RSDESC_SIZE        TotalLength;
    UINT8                   *AmlResourceSource;
 
 
    ACPI_FUNCTION_ENTRY ();
 
 
    TotalLength = ResourceLength + sizeof (AML_RESOURCE_LARGE_HEADER);
    AmlResourceSource = ACPI_ADD_PTR (UINT8, Aml, MinimumLength);
 
    /*
     * ResourceSource is present if the length of the descriptor is longer
     * than the minimum length.
     *
     * Note: Some resource descriptors will have an additional null, so
     * we add 1 to the minimum length.
     */
    if (TotalLength > (ACPI_RSDESC_SIZE) (MinimumLength + 1))
    {
        /* Get the ResourceSourceIndex */
 
        ResourceSource->Index = AmlResourceSource[0];
 
        ResourceSource->StringPtr = StringPtr;
        if (!StringPtr)
        {
            /*
             * String destination pointer is not specified; Set the String
             * pointer to the end of the current ResourceSource structure.
             */
            ResourceSource->StringPtr = ACPI_ADD_PTR (
                char, ResourceSource, sizeof (ACPI_RESOURCE_SOURCE));
        }
 
        /*
         * In order for the Resource length to be a multiple of the native
         * word, calculate the length of the string (+1 for NULL terminator)
         * and expand to the next word multiple.
         *
         * Zero the entire area of the buffer.
         */
        TotalLength = (UINT32) strlen (
            ACPI_CAST_PTR (char, &AmlResourceSource[1])) + 1;
 
        TotalLength = (UINT32) ACPI_ROUND_UP_TO_NATIVE_WORD (TotalLength);
 
        memset (ResourceSource->StringPtr, 0, TotalLength);
 
        /* Copy the ResourceSource string to the destination */
 
        ResourceSource->StringLength = AcpiRsStrcpy (
            ResourceSource->StringPtr,
            ACPI_CAST_PTR (char, &AmlResourceSource[1]));
 
        return ((ACPI_RS_LENGTH) TotalLength);
    }
 
    /* ResourceSource is not present */
 
    ResourceSource->Index = 0;
    ResourceSource->StringLength = 0;
    ResourceSource->StringPtr = NULL;
    return (0);
}

Referenced by AcpiRsConvertAmlToResource().

AcpiRsMoveData()

void AcpiRsMoveData	(	void *	Destination,
		void *	Source,
		UINT16	ItemCount,
		UINT8	MoveType
	)

Definition at line 150 of file rsutils.c.

{
    UINT32                  i;
 
 
    ACPI_FUNCTION_ENTRY ();
 
 
    /* One move per item */
 
    for (i = 0; i < ItemCount; i++)
    {
        switch (MoveType)
        {
        /*
         * For the 8-bit case, we can perform the move all at once
         * since there are no alignment or endian issues
         */
        case ACPI_RSC_MOVE8:
        case ACPI_RSC_MOVE_GPIO_RES:
        case ACPI_RSC_MOVE_SERIAL_VEN:
        case ACPI_RSC_MOVE_SERIAL_RES:
 
            memcpy (Destination, Source, ItemCount);
            return;
 
        /*
         * 16-, 32-, and 64-bit cases must use the move macros that perform
         * endian conversion and/or accommodate hardware that cannot perform
         * misaligned memory transfers
         */
        case ACPI_RSC_MOVE16:
        case ACPI_RSC_MOVE_GPIO_PIN:
 
            ACPI_MOVE_16_TO_16 (
                &ACPI_CAST_PTR (UINT16, Destination)[i],
                &ACPI_CAST_PTR (UINT16, Source)[i]);
            break;
 
        case ACPI_RSC_MOVE32:
 
            ACPI_MOVE_32_TO_32 (
                &ACPI_CAST_PTR (UINT32, Destination)[i],
                &ACPI_CAST_PTR (UINT32, Source)[i]);
            break;
 
        case ACPI_RSC_MOVE64:
 
            ACPI_MOVE_64_TO_64 (
                &ACPI_CAST_PTR (UINT64, Destination)[i],
                &ACPI_CAST_PTR (UINT64, Source)[i]);
            break;
 
        default:
 
            return;
        }
    }
}

Referenced by AcpiRsConvertAmlToResource(), and AcpiRsConvertResourceToAml().

AcpiRsSetResourceHeader()

void AcpiRsSetResourceHeader	(	UINT8	DescriptorType,
		ACPI_RSDESC_SIZE	TotalLength,
		AML_RESOURCE *	Aml
	)

Definition at line 289 of file rsutils.c.

{
    ACPI_FUNCTION_ENTRY ();
 
 
    /* Set the Resource Type */
 
    Aml->SmallHeader.DescriptorType = DescriptorType;
 
    /* Set the Resource Length */
 
    AcpiRsSetResourceLength (TotalLength, Aml);
}

Referenced by AcpiRsConvertResourceToAml().

AcpiRsSetResourceLength()

void AcpiRsSetResourceLength	(	ACPI_RSDESC_SIZE	TotalLength,
		AML_RESOURCE *	Aml
	)

Definition at line 233 of file rsutils.c.

{
    ACPI_RS_LENGTH          ResourceLength;
 
 
    ACPI_FUNCTION_ENTRY ();
 
 
    /* Length is the total descriptor length minus the header length */
 
    ResourceLength = (ACPI_RS_LENGTH)
        (TotalLength - AcpiUtGetResourceHeaderLength (Aml));
 
    /* Length is stored differently for large and small descriptors */
 
    if (Aml->SmallHeader.DescriptorType & ACPI_RESOURCE_NAME_LARGE)
    {
        /* Large descriptor -- bytes 1-2 contain the 16-bit length */
 
        ACPI_MOVE_16_TO_16 (
            &Aml->LargeHeader.ResourceLength, &ResourceLength);
    }
    else
    {
        /*
         * Small descriptor -- bits 2:0 of byte 0 contain the length
         * Clear any existing length, preserving descriptor type bits
         */
        Aml->SmallHeader.DescriptorType = (UINT8)
            ((Aml->SmallHeader.DescriptorType &
                ~ACPI_RESOURCE_NAME_SMALL_LENGTH_MASK)
            | ResourceLength);
    }
}

Referenced by AcpiRsConvertResourceToAml(), and AcpiRsSetResourceHeader().

AcpiRsSetResourceSource()

ACPI_RSDESC_SIZE AcpiRsSetResourceSource	(	AML_RESOURCE *	Aml,
		ACPI_RS_LENGTH	MinimumLength,
		ACPI_RESOURCE_SOURCE *	ResourceSource
	)

Definition at line 457 of file rsutils.c.

{
    UINT8                   *AmlResourceSource;
    ACPI_RSDESC_SIZE        DescriptorLength;
 
 
    ACPI_FUNCTION_ENTRY ();
 
 
    DescriptorLength = MinimumLength;
 
    /* Non-zero string length indicates presence of a ResourceSource */
 
    if (ResourceSource->StringLength)
    {
        /* Point to the end of the AML descriptor */
 
        AmlResourceSource = ACPI_ADD_PTR (UINT8, Aml, MinimumLength);
 
        /* Copy the ResourceSourceIndex */
 
        AmlResourceSource[0] = (UINT8) ResourceSource->Index;
 
        /* Copy the ResourceSource string */
 
        strcpy (ACPI_CAST_PTR (char, &AmlResourceSource[1]),
            ResourceSource->StringPtr);
 
        /*
         * Add the length of the string (+ 1 for null terminator) to the
         * final descriptor length
         */
        DescriptorLength += ((ACPI_RSDESC_SIZE)
            ResourceSource->StringLength + 1);
    }
 
    /* Return the new total length of the AML descriptor */
 
    return (DescriptorLength);
}

Referenced by AcpiRsConvertResourceToAml().

AcpiRsSetSrsMethodData()

ACPI_STATUS AcpiRsSetSrsMethodData	(	ACPI_NAMESPACE_NODE *	Node,
		ACPI_BUFFER *	InBuffer
	)

Definition at line 800 of file rsutils.c.

{
    ACPI_EVALUATE_INFO      *Info;
    ACPI_OPERAND_OBJECT     *Args[2];
    ACPI_STATUS             Status;
    ACPI_BUFFER             Buffer;
 
 
    ACPI_FUNCTION_TRACE (RsSetSrsMethodData);
 
 
    /* Allocate and initialize the evaluation information block */
 
    Info = ACPI_ALLOCATE_ZEROED (sizeof (ACPI_EVALUATE_INFO));
    if (!Info)
    {
        return_ACPI_STATUS (AE_NO_MEMORY);
    }
 
    Info->PrefixNode = Node;
    Info->RelativePathname = METHOD_NAME__SRS;
    Info->Parameters = Args;
    Info->Flags = ACPI_IGNORE_RETURN_VALUE;
 
    /*
     * The InBuffer parameter will point to a linked list of
     * resource parameters. It needs to be formatted into a
     * byte stream to be sent in as an input parameter to _SRS
     *
     * Convert the linked list into a byte stream
     */
    Buffer.Length = ACPI_ALLOCATE_LOCAL_BUFFER;
    Status = AcpiRsCreateAmlResources (InBuffer, &Buffer);
    if (ACPI_FAILURE (Status))
    {
        goto Cleanup;
    }
 
    /* Create and initialize the method parameter object */
 
    Args[0] = AcpiUtCreateInternalObject (ACPI_TYPE_BUFFER);
    if (!Args[0])
    {
        /*
         * Must free the buffer allocated above (otherwise it is freed
         * later)
         */
        ACPI_FREE (Buffer.Pointer);
        Status = AE_NO_MEMORY;
        goto Cleanup;
    }
 
    Args[0]->Buffer.Length  = (UINT32) Buffer.Length;
    Args[0]->Buffer.Pointer = Buffer.Pointer;
    Args[0]->Common.Flags   = AOPOBJ_DATA_VALID;
    Args[1] = NULL;
 
    /* Execute the method, no return value is expected */
 
    Status = AcpiNsEvaluate (Info);
 
    /* Clean up and return the status from AcpiNsEvaluate */
 
    AcpiUtRemoveReference (Args[0]);
 
Cleanup:
    ACPI_FREE (Info);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiSetCurrentResources().

AcpiRsStrcpy()

static UINT16 AcpiRsStrcpy ( char *  Destination, char *  Source  )

static

Definition at line 322 of file rsutils.c.

{
    UINT16                  i;
 
 
    ACPI_FUNCTION_ENTRY ();
 
 
    for (i = 0; Source[i]; i++)
    {
        Destination[i] = Source[i];
    }
 
    Destination[i] = 0;
 
    /* Return string length including the NULL terminator */
 
    return ((UINT16) (i + 1));
}

Referenced by AcpiRsGetResourceSource().