![Bob Moore](/assets/img/avatar_default.png)
Includes all source headers and signons for the various tools. Signed-off-by: Bob Moore <robert.moore@intel.com> Signed-off-by: Lv Zheng <lv.zheng@intel.com> Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
408 lines
11 KiB
C
408 lines
11 KiB
C
/*******************************************************************************
|
|
*
|
|
* Module Name: utmisc - common utility procedures
|
|
*
|
|
******************************************************************************/
|
|
|
|
/*
|
|
* Copyright (C) 2000 - 2013, Intel Corp.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions, and the following disclaimer,
|
|
* without modification.
|
|
* 2. Redistributions in binary form must reproduce at minimum a disclaimer
|
|
* substantially similar to the "NO WARRANTY" disclaimer below
|
|
* ("Disclaimer") and any redistribution must be conditioned upon
|
|
* including a substantially similar Disclaimer requirement for further
|
|
* binary redistribution.
|
|
* 3. Neither the names of the above-listed copyright holders nor the names
|
|
* of any contributors may be used to endorse or promote products derived
|
|
* from this software without specific prior written permission.
|
|
*
|
|
* Alternatively, this software may be distributed under the terms of the
|
|
* GNU General Public License ("GPL") version 2 as published by the Free
|
|
* Software Foundation.
|
|
*
|
|
* NO WARRANTY
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
|
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
* HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
|
|
* IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGES.
|
|
*/
|
|
|
|
#include <acpi/acpi.h>
|
|
#include "accommon.h"
|
|
#include "acnamesp.h"
|
|
|
|
#define _COMPONENT ACPI_UTILITIES
|
|
ACPI_MODULE_NAME("utmisc")
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: acpi_ut_is_pci_root_bridge
|
|
*
|
|
* PARAMETERS: id - The HID/CID in string format
|
|
*
|
|
* RETURN: TRUE if the Id is a match for a PCI/PCI-Express Root Bridge
|
|
*
|
|
* DESCRIPTION: Determine if the input ID is a PCI Root Bridge ID.
|
|
*
|
|
******************************************************************************/
|
|
u8 acpi_ut_is_pci_root_bridge(char *id)
|
|
{
|
|
|
|
/*
|
|
* Check if this is a PCI root bridge.
|
|
* ACPI 3.0+: check for a PCI Express root also.
|
|
*/
|
|
if (!(ACPI_STRCMP(id,
|
|
PCI_ROOT_HID_STRING)) ||
|
|
!(ACPI_STRCMP(id, PCI_EXPRESS_ROOT_HID_STRING))) {
|
|
return (TRUE);
|
|
}
|
|
|
|
return (FALSE);
|
|
}
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: acpi_ut_is_aml_table
|
|
*
|
|
* PARAMETERS: table - An ACPI table
|
|
*
|
|
* RETURN: TRUE if table contains executable AML; FALSE otherwise
|
|
*
|
|
* DESCRIPTION: Check ACPI Signature for a table that contains AML code.
|
|
* Currently, these are DSDT,SSDT,PSDT. All other table types are
|
|
* data tables that do not contain AML code.
|
|
*
|
|
******************************************************************************/
|
|
|
|
u8 acpi_ut_is_aml_table(struct acpi_table_header *table)
|
|
{
|
|
|
|
/* These are the only tables that contain executable AML */
|
|
|
|
if (ACPI_COMPARE_NAME(table->signature, ACPI_SIG_DSDT) ||
|
|
ACPI_COMPARE_NAME(table->signature, ACPI_SIG_PSDT) ||
|
|
ACPI_COMPARE_NAME(table->signature, ACPI_SIG_SSDT)) {
|
|
return (TRUE);
|
|
}
|
|
|
|
return (FALSE);
|
|
}
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: acpi_ut_dword_byte_swap
|
|
*
|
|
* PARAMETERS: value - Value to be converted
|
|
*
|
|
* RETURN: u32 integer with bytes swapped
|
|
*
|
|
* DESCRIPTION: Convert a 32-bit value to big-endian (swap the bytes)
|
|
*
|
|
******************************************************************************/
|
|
|
|
u32 acpi_ut_dword_byte_swap(u32 value)
|
|
{
|
|
union {
|
|
u32 value;
|
|
u8 bytes[4];
|
|
} out;
|
|
union {
|
|
u32 value;
|
|
u8 bytes[4];
|
|
} in;
|
|
|
|
ACPI_FUNCTION_ENTRY();
|
|
|
|
in.value = value;
|
|
|
|
out.bytes[0] = in.bytes[3];
|
|
out.bytes[1] = in.bytes[2];
|
|
out.bytes[2] = in.bytes[1];
|
|
out.bytes[3] = in.bytes[0];
|
|
|
|
return (out.value);
|
|
}
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: acpi_ut_set_integer_width
|
|
*
|
|
* PARAMETERS: Revision From DSDT header
|
|
*
|
|
* RETURN: None
|
|
*
|
|
* DESCRIPTION: Set the global integer bit width based upon the revision
|
|
* of the DSDT. For Revision 1 and 0, Integers are 32 bits.
|
|
* For Revision 2 and above, Integers are 64 bits. Yes, this
|
|
* makes a difference.
|
|
*
|
|
******************************************************************************/
|
|
|
|
void acpi_ut_set_integer_width(u8 revision)
|
|
{
|
|
|
|
if (revision < 2) {
|
|
|
|
/* 32-bit case */
|
|
|
|
acpi_gbl_integer_bit_width = 32;
|
|
acpi_gbl_integer_nybble_width = 8;
|
|
acpi_gbl_integer_byte_width = 4;
|
|
} else {
|
|
/* 64-bit case (ACPI 2.0+) */
|
|
|
|
acpi_gbl_integer_bit_width = 64;
|
|
acpi_gbl_integer_nybble_width = 16;
|
|
acpi_gbl_integer_byte_width = 8;
|
|
}
|
|
}
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: acpi_ut_create_update_state_and_push
|
|
*
|
|
* PARAMETERS: object - Object to be added to the new state
|
|
* action - Increment/Decrement
|
|
* state_list - List the state will be added to
|
|
*
|
|
* RETURN: Status
|
|
*
|
|
* DESCRIPTION: Create a new state and push it
|
|
*
|
|
******************************************************************************/
|
|
|
|
acpi_status
|
|
acpi_ut_create_update_state_and_push(union acpi_operand_object *object,
|
|
u16 action,
|
|
union acpi_generic_state **state_list)
|
|
{
|
|
union acpi_generic_state *state;
|
|
|
|
ACPI_FUNCTION_ENTRY();
|
|
|
|
/* Ignore null objects; these are expected */
|
|
|
|
if (!object) {
|
|
return (AE_OK);
|
|
}
|
|
|
|
state = acpi_ut_create_update_state(object, action);
|
|
if (!state) {
|
|
return (AE_NO_MEMORY);
|
|
}
|
|
|
|
acpi_ut_push_generic_state(state_list, state);
|
|
return (AE_OK);
|
|
}
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: acpi_ut_walk_package_tree
|
|
*
|
|
* PARAMETERS: source_object - The package to walk
|
|
* target_object - Target object (if package is being copied)
|
|
* walk_callback - Called once for each package element
|
|
* context - Passed to the callback function
|
|
*
|
|
* RETURN: Status
|
|
*
|
|
* DESCRIPTION: Walk through a package
|
|
*
|
|
******************************************************************************/
|
|
|
|
acpi_status
|
|
acpi_ut_walk_package_tree(union acpi_operand_object *source_object,
|
|
void *target_object,
|
|
acpi_pkg_callback walk_callback, void *context)
|
|
{
|
|
acpi_status status = AE_OK;
|
|
union acpi_generic_state *state_list = NULL;
|
|
union acpi_generic_state *state;
|
|
u32 this_index;
|
|
union acpi_operand_object *this_source_obj;
|
|
|
|
ACPI_FUNCTION_TRACE(ut_walk_package_tree);
|
|
|
|
state = acpi_ut_create_pkg_state(source_object, target_object, 0);
|
|
if (!state) {
|
|
return_ACPI_STATUS(AE_NO_MEMORY);
|
|
}
|
|
|
|
while (state) {
|
|
|
|
/* Get one element of the package */
|
|
|
|
this_index = state->pkg.index;
|
|
this_source_obj = (union acpi_operand_object *)
|
|
state->pkg.source_object->package.elements[this_index];
|
|
|
|
/*
|
|
* Check for:
|
|
* 1) An uninitialized package element. It is completely
|
|
* legal to declare a package and leave it uninitialized
|
|
* 2) Not an internal object - can be a namespace node instead
|
|
* 3) Any type other than a package. Packages are handled in else
|
|
* case below.
|
|
*/
|
|
if ((!this_source_obj) ||
|
|
(ACPI_GET_DESCRIPTOR_TYPE(this_source_obj) !=
|
|
ACPI_DESC_TYPE_OPERAND)
|
|
|| (this_source_obj->common.type != ACPI_TYPE_PACKAGE)) {
|
|
status =
|
|
walk_callback(ACPI_COPY_TYPE_SIMPLE,
|
|
this_source_obj, state, context);
|
|
if (ACPI_FAILURE(status)) {
|
|
return_ACPI_STATUS(status);
|
|
}
|
|
|
|
state->pkg.index++;
|
|
while (state->pkg.index >=
|
|
state->pkg.source_object->package.count) {
|
|
/*
|
|
* We've handled all of the objects at this level, This means
|
|
* that we have just completed a package. That package may
|
|
* have contained one or more packages itself.
|
|
*
|
|
* Delete this state and pop the previous state (package).
|
|
*/
|
|
acpi_ut_delete_generic_state(state);
|
|
state = acpi_ut_pop_generic_state(&state_list);
|
|
|
|
/* Finished when there are no more states */
|
|
|
|
if (!state) {
|
|
/*
|
|
* We have handled all of the objects in the top level
|
|
* package just add the length of the package objects
|
|
* and exit
|
|
*/
|
|
return_ACPI_STATUS(AE_OK);
|
|
}
|
|
|
|
/*
|
|
* Go back up a level and move the index past the just
|
|
* completed package object.
|
|
*/
|
|
state->pkg.index++;
|
|
}
|
|
} else {
|
|
/* This is a subobject of type package */
|
|
|
|
status =
|
|
walk_callback(ACPI_COPY_TYPE_PACKAGE,
|
|
this_source_obj, state, context);
|
|
if (ACPI_FAILURE(status)) {
|
|
return_ACPI_STATUS(status);
|
|
}
|
|
|
|
/*
|
|
* Push the current state and create a new one
|
|
* The callback above returned a new target package object.
|
|
*/
|
|
acpi_ut_push_generic_state(&state_list, state);
|
|
state = acpi_ut_create_pkg_state(this_source_obj,
|
|
state->pkg.
|
|
this_target_obj, 0);
|
|
if (!state) {
|
|
|
|
/* Free any stacked Update State objects */
|
|
|
|
while (state_list) {
|
|
state =
|
|
acpi_ut_pop_generic_state
|
|
(&state_list);
|
|
acpi_ut_delete_generic_state(state);
|
|
}
|
|
return_ACPI_STATUS(AE_NO_MEMORY);
|
|
}
|
|
}
|
|
}
|
|
|
|
/* We should never get here */
|
|
|
|
return_ACPI_STATUS(AE_AML_INTERNAL);
|
|
}
|
|
|
|
#ifdef ACPI_DEBUG_OUTPUT
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: acpi_ut_display_init_pathname
|
|
*
|
|
* PARAMETERS: type - Object type of the node
|
|
* obj_handle - Handle whose pathname will be displayed
|
|
* path - Additional path string to be appended.
|
|
* (NULL if no extra path)
|
|
*
|
|
* RETURN: acpi_status
|
|
*
|
|
* DESCRIPTION: Display full pathname of an object, DEBUG ONLY
|
|
*
|
|
******************************************************************************/
|
|
|
|
void
|
|
acpi_ut_display_init_pathname(u8 type,
|
|
struct acpi_namespace_node *obj_handle,
|
|
char *path)
|
|
{
|
|
acpi_status status;
|
|
struct acpi_buffer buffer;
|
|
|
|
ACPI_FUNCTION_ENTRY();
|
|
|
|
/* Only print the path if the appropriate debug level is enabled */
|
|
|
|
if (!(acpi_dbg_level & ACPI_LV_INIT_NAMES)) {
|
|
return;
|
|
}
|
|
|
|
/* Get the full pathname to the node */
|
|
|
|
buffer.length = ACPI_ALLOCATE_LOCAL_BUFFER;
|
|
status = acpi_ns_handle_to_pathname(obj_handle, &buffer);
|
|
if (ACPI_FAILURE(status)) {
|
|
return;
|
|
}
|
|
|
|
/* Print what we're doing */
|
|
|
|
switch (type) {
|
|
case ACPI_TYPE_METHOD:
|
|
acpi_os_printf("Executing ");
|
|
break;
|
|
|
|
default:
|
|
acpi_os_printf("Initializing ");
|
|
break;
|
|
}
|
|
|
|
/* Print the object type and pathname */
|
|
|
|
acpi_os_printf("%-12s %s",
|
|
acpi_ut_get_type_name(type), (char *)buffer.pointer);
|
|
|
|
/* Extra path is used to append names like _STA, _INI, etc. */
|
|
|
|
if (path) {
|
|
acpi_os_printf(".%s", path);
|
|
}
|
|
acpi_os_printf("\n");
|
|
|
|
ACPI_FREE(buffer.pointer);
|
|
}
|
|
#endif
|