| /****************************************************************************** |
| * |
| * Module Name: nsinit - namespace initialization |
| * |
| *****************************************************************************/ |
| |
| /* |
| * Copyright (C) 2000 - 2016, 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.h" |
| #include "accommon.h" |
| #include "acnamesp.h" |
| #include "acdispat.h" |
| #include "acinterp.h" |
| |
| #define _COMPONENT ACPI_NAMESPACE |
| ACPI_MODULE_NAME ("nsinit") |
| |
| /* Local prototypes */ |
| |
| static ACPI_STATUS |
| AcpiNsInitOneObject ( |
| ACPI_HANDLE ObjHandle, |
| UINT32 Level, |
| void *Context, |
| void **ReturnValue); |
| |
| static ACPI_STATUS |
| AcpiNsInitOneDevice ( |
| ACPI_HANDLE ObjHandle, |
| UINT32 NestingLevel, |
| void *Context, |
| void **ReturnValue); |
| |
| static ACPI_STATUS |
| AcpiNsFindIniMethods ( |
| ACPI_HANDLE ObjHandle, |
| UINT32 NestingLevel, |
| void *Context, |
| void **ReturnValue); |
| |
| |
| /******************************************************************************* |
| * |
| * FUNCTION: AcpiNsInitializeObjects |
| * |
| * PARAMETERS: None |
| * |
| * RETURN: Status |
| * |
| * DESCRIPTION: Walk the entire namespace and perform any necessary |
| * initialization on the objects found therein |
| * |
| ******************************************************************************/ |
| |
| ACPI_STATUS |
| AcpiNsInitializeObjects ( |
| void) |
| { |
| ACPI_STATUS Status; |
| ACPI_INIT_WALK_INFO Info; |
| |
| |
| ACPI_FUNCTION_TRACE (NsInitializeObjects); |
| |
| |
| ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, |
| "**** Starting initialization of namespace objects ****\n")); |
| ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT, |
| "Completing Region/Field/Buffer/Package initialization:\n")); |
| |
| /* Set all init info to zero */ |
| |
| memset (&Info, 0, sizeof (ACPI_INIT_WALK_INFO)); |
| |
| /* Walk entire namespace from the supplied root */ |
| |
| Status = AcpiWalkNamespace (ACPI_TYPE_ANY, ACPI_ROOT_OBJECT, |
| ACPI_UINT32_MAX, AcpiNsInitOneObject, NULL, |
| &Info, NULL); |
| if (ACPI_FAILURE (Status)) |
| { |
| ACPI_EXCEPTION ((AE_INFO, Status, "During WalkNamespace")); |
| } |
| |
| ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT, |
| " Initialized %u/%u Regions %u/%u Fields %u/%u " |
| "Buffers %u/%u Packages (%u nodes)\n", |
| Info.OpRegionInit, Info.OpRegionCount, |
| Info.FieldInit, Info.FieldCount, |
| Info.BufferInit, Info.BufferCount, |
| Info.PackageInit, Info.PackageCount, Info.ObjectCount)); |
| |
| ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, |
| "%u Control Methods found\n%u Op Regions found\n", |
| Info.MethodCount, Info.OpRegionCount)); |
| |
| return_ACPI_STATUS (AE_OK); |
| } |
| |
| |
| /******************************************************************************* |
| * |
| * FUNCTION: AcpiNsInitializeDevices |
| * |
| * PARAMETERS: None |
| * |
| * RETURN: ACPI_STATUS |
| * |
| * DESCRIPTION: Walk the entire namespace and initialize all ACPI devices. |
| * This means running _INI on all present devices. |
| * |
| * Note: We install PCI config space handler on region access, |
| * not here. |
| * |
| ******************************************************************************/ |
| |
| ACPI_STATUS |
| AcpiNsInitializeDevices ( |
| void) |
| { |
| ACPI_STATUS Status; |
| ACPI_DEVICE_WALK_INFO Info; |
| |
| |
| ACPI_FUNCTION_TRACE (NsInitializeDevices); |
| |
| |
| /* Init counters */ |
| |
| Info.DeviceCount = 0; |
| Info.Num_STA = 0; |
| Info.Num_INI = 0; |
| |
| ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT, |
| "Initializing Device/Processor/Thermal objects " |
| "and executing _INI/_STA methods:\n")); |
| |
| /* Tree analysis: find all subtrees that contain _INI methods */ |
| |
| Status = AcpiNsWalkNamespace (ACPI_TYPE_ANY, ACPI_ROOT_OBJECT, |
| ACPI_UINT32_MAX, FALSE, AcpiNsFindIniMethods, NULL, &Info, NULL); |
| if (ACPI_FAILURE (Status)) |
| { |
| goto ErrorExit; |
| } |
| |
| /* Allocate the evaluation information block */ |
| |
| Info.EvaluateInfo = ACPI_ALLOCATE_ZEROED (sizeof (ACPI_EVALUATE_INFO)); |
| if (!Info.EvaluateInfo) |
| { |
| Status = AE_NO_MEMORY; |
| goto ErrorExit; |
| } |
| |
| /* |
| * Execute the "global" _INI method that may appear at the root. This |
| * support is provided for Windows compatibility (Vista+) and is not |
| * part of the ACPI specification. |
| */ |
| Info.EvaluateInfo->PrefixNode = AcpiGbl_RootNode; |
| Info.EvaluateInfo->RelativePathname = METHOD_NAME__INI; |
| Info.EvaluateInfo->Parameters = NULL; |
| Info.EvaluateInfo->Flags = ACPI_IGNORE_RETURN_VALUE; |
| |
| Status = AcpiNsEvaluate (Info.EvaluateInfo); |
| if (ACPI_SUCCESS (Status)) |
| { |
| Info.Num_INI++; |
| } |
| |
| /* Walk namespace to execute all _INIs on present devices */ |
| |
| Status = AcpiNsWalkNamespace (ACPI_TYPE_ANY, ACPI_ROOT_OBJECT, |
| ACPI_UINT32_MAX, FALSE, AcpiNsInitOneDevice, NULL, &Info, NULL); |
| |
| /* |
| * Any _OSI requests should be completed by now. If the BIOS has |
| * requested any Windows OSI strings, we will always truncate |
| * I/O addresses to 16 bits -- for Windows compatibility. |
| */ |
| if (AcpiGbl_OsiData >= ACPI_OSI_WIN_2000) |
| { |
| AcpiGbl_TruncateIoAddresses = TRUE; |
| } |
| |
| ACPI_FREE (Info.EvaluateInfo); |
| if (ACPI_FAILURE (Status)) |
| { |
| goto ErrorExit; |
| } |
| |
| ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT, |
| " Executed %u _INI methods requiring %u _STA executions " |
| "(examined %u objects)\n", |
| Info.Num_INI, Info.Num_STA, Info.DeviceCount)); |
| |
| return_ACPI_STATUS (Status); |
| |
| |
| ErrorExit: |
| ACPI_EXCEPTION ((AE_INFO, Status, "During device initialization")); |
| return_ACPI_STATUS (Status); |
| } |
| |
| |
| /******************************************************************************* |
| * |
| * FUNCTION: AcpiNsInitOneObject |
| * |
| * PARAMETERS: ObjHandle - Node |
| * Level - Current nesting level |
| * Context - Points to a init info struct |
| * ReturnValue - Not used |
| * |
| * RETURN: Status |
| * |
| * DESCRIPTION: Callback from AcpiWalkNamespace. Invoked for every object |
| * within the namespace. |
| * |
| * Currently, the only objects that require initialization are: |
| * 1) Methods |
| * 2) Op Regions |
| * |
| ******************************************************************************/ |
| |
| static ACPI_STATUS |
| AcpiNsInitOneObject ( |
| ACPI_HANDLE ObjHandle, |
| UINT32 Level, |
| void *Context, |
| void **ReturnValue) |
| { |
| ACPI_OBJECT_TYPE Type; |
| ACPI_STATUS Status = AE_OK; |
| ACPI_INIT_WALK_INFO *Info = (ACPI_INIT_WALK_INFO *) Context; |
| ACPI_NAMESPACE_NODE *Node = (ACPI_NAMESPACE_NODE *) ObjHandle; |
| ACPI_OPERAND_OBJECT *ObjDesc; |
| |
| |
| ACPI_FUNCTION_NAME (NsInitOneObject); |
| |
| |
| Info->ObjectCount++; |
| |
| /* And even then, we are only interested in a few object types */ |
| |
| Type = AcpiNsGetType (ObjHandle); |
| ObjDesc = AcpiNsGetAttachedObject (Node); |
| if (!ObjDesc) |
| { |
| return (AE_OK); |
| } |
| |
| /* Increment counters for object types we are looking for */ |
| |
| switch (Type) |
| { |
| case ACPI_TYPE_REGION: |
| |
| Info->OpRegionCount++; |
| break; |
| |
| case ACPI_TYPE_BUFFER_FIELD: |
| |
| Info->FieldCount++; |
| break; |
| |
| case ACPI_TYPE_LOCAL_BANK_FIELD: |
| |
| Info->FieldCount++; |
| break; |
| |
| case ACPI_TYPE_BUFFER: |
| |
| Info->BufferCount++; |
| break; |
| |
| case ACPI_TYPE_PACKAGE: |
| |
| Info->PackageCount++; |
| break; |
| |
| default: |
| |
| /* No init required, just exit now */ |
| |
| return (AE_OK); |
| } |
| |
| /* If the object is already initialized, nothing else to do */ |
| |
| if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID) |
| { |
| return (AE_OK); |
| } |
| |
| /* Must lock the interpreter before executing AML code */ |
| |
| AcpiExEnterInterpreter (); |
| |
| /* |
| * Each of these types can contain executable AML code within the |
| * declaration. |
| */ |
| switch (Type) |
| { |
| case ACPI_TYPE_REGION: |
| |
| Info->OpRegionInit++; |
| Status = AcpiDsGetRegionArguments (ObjDesc); |
| break; |
| |
| case ACPI_TYPE_BUFFER_FIELD: |
| |
| Info->FieldInit++; |
| Status = AcpiDsGetBufferFieldArguments (ObjDesc); |
| break; |
| |
| case ACPI_TYPE_LOCAL_BANK_FIELD: |
| |
| Info->FieldInit++; |
| Status = AcpiDsGetBankFieldArguments (ObjDesc); |
| break; |
| |
| case ACPI_TYPE_BUFFER: |
| |
| Info->BufferInit++; |
| Status = AcpiDsGetBufferArguments (ObjDesc); |
| break; |
| |
| case ACPI_TYPE_PACKAGE: |
| |
| Info->PackageInit++; |
| Status = AcpiDsGetPackageArguments (ObjDesc); |
| break; |
| |
| default: |
| |
| /* No other types can get here */ |
| |
| break; |
| } |
| |
| if (ACPI_FAILURE (Status)) |
| { |
| ACPI_EXCEPTION ((AE_INFO, Status, |
| "Could not execute arguments for [%4.4s] (%s)", |
| AcpiUtGetNodeName (Node), AcpiUtGetTypeName (Type))); |
| } |
| |
| /* |
| * We ignore errors from above, and always return OK, since we don't want |
| * to abort the walk on any single error. |
| */ |
| AcpiExExitInterpreter (); |
| return (AE_OK); |
| } |
| |
| |
| /******************************************************************************* |
| * |
| * FUNCTION: AcpiNsFindIniMethods |
| * |
| * PARAMETERS: ACPI_WALK_CALLBACK |
| * |
| * RETURN: ACPI_STATUS |
| * |
| * DESCRIPTION: Called during namespace walk. Finds objects named _INI under |
| * device/processor/thermal objects, and marks the entire subtree |
| * with a SUBTREE_HAS_INI flag. This flag is used during the |
| * subsequent device initialization walk to avoid entire subtrees |
| * that do not contain an _INI. |
| * |
| ******************************************************************************/ |
| |
| static ACPI_STATUS |
| AcpiNsFindIniMethods ( |
| ACPI_HANDLE ObjHandle, |
| UINT32 NestingLevel, |
| void *Context, |
| void **ReturnValue) |
| { |
| ACPI_DEVICE_WALK_INFO *Info = ACPI_CAST_PTR (ACPI_DEVICE_WALK_INFO, Context); |
| ACPI_NAMESPACE_NODE *Node; |
| ACPI_NAMESPACE_NODE *ParentNode; |
| |
| |
| /* Keep count of device/processor/thermal objects */ |
| |
| Node = ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, ObjHandle); |
| if ((Node->Type == ACPI_TYPE_DEVICE) || |
| (Node->Type == ACPI_TYPE_PROCESSOR) || |
| (Node->Type == ACPI_TYPE_THERMAL)) |
| { |
| Info->DeviceCount++; |
| return (AE_OK); |
| } |
| |
| /* We are only looking for methods named _INI */ |
| |
| if (!ACPI_COMPARE_NAME (Node->Name.Ascii, METHOD_NAME__INI)) |
| { |
| return (AE_OK); |
| } |
| |
| /* |
| * The only _INI methods that we care about are those that are |
| * present under Device, Processor, and Thermal objects. |
| */ |
| ParentNode = Node->Parent; |
| switch (ParentNode->Type) |
| { |
| case ACPI_TYPE_DEVICE: |
| case ACPI_TYPE_PROCESSOR: |
| case ACPI_TYPE_THERMAL: |
| |
| /* Mark parent and bubble up the INI present flag to the root */ |
| |
| while (ParentNode) |
| { |
| ParentNode->Flags |= ANOBJ_SUBTREE_HAS_INI; |
| ParentNode = ParentNode->Parent; |
| } |
| break; |
| |
| default: |
| |
| break; |
| } |
| |
| return (AE_OK); |
| } |
| |
| |
| /******************************************************************************* |
| * |
| * FUNCTION: AcpiNsInitOneDevice |
| * |
| * PARAMETERS: ACPI_WALK_CALLBACK |
| * |
| * RETURN: ACPI_STATUS |
| * |
| * DESCRIPTION: This is called once per device soon after ACPI is enabled |
| * to initialize each device. It determines if the device is |
| * present, and if so, calls _INI. |
| * |
| ******************************************************************************/ |
| |
| static ACPI_STATUS |
| AcpiNsInitOneDevice ( |
| ACPI_HANDLE ObjHandle, |
| UINT32 NestingLevel, |
| void *Context, |
| void **ReturnValue) |
| { |
| ACPI_DEVICE_WALK_INFO *WalkInfo = ACPI_CAST_PTR (ACPI_DEVICE_WALK_INFO, Context); |
| ACPI_EVALUATE_INFO *Info = WalkInfo->EvaluateInfo; |
| UINT32 Flags; |
| ACPI_STATUS Status; |
| ACPI_NAMESPACE_NODE *DeviceNode; |
| |
| |
| ACPI_FUNCTION_TRACE (NsInitOneDevice); |
| |
| |
| /* We are interested in Devices, Processors and ThermalZones only */ |
| |
| DeviceNode = ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, ObjHandle); |
| if ((DeviceNode->Type != ACPI_TYPE_DEVICE) && |
| (DeviceNode->Type != ACPI_TYPE_PROCESSOR) && |
| (DeviceNode->Type != ACPI_TYPE_THERMAL)) |
| { |
| return_ACPI_STATUS (AE_OK); |
| } |
| |
| /* |
| * Because of an earlier namespace analysis, all subtrees that contain an |
| * _INI method are tagged. |
| * |
| * If this device subtree does not contain any _INI methods, we |
| * can exit now and stop traversing this entire subtree. |
| */ |
| if (!(DeviceNode->Flags & ANOBJ_SUBTREE_HAS_INI)) |
| { |
| return_ACPI_STATUS (AE_CTRL_DEPTH); |
| } |
| |
| /* |
| * Run _STA to determine if this device is present and functioning. We |
| * must know this information for two important reasons (from ACPI spec): |
| * |
| * 1) We can only run _INI if the device is present. |
| * 2) We must abort the device tree walk on this subtree if the device is |
| * not present and is not functional (we will not examine the children) |
| * |
| * The _STA method is not required to be present under the device, we |
| * assume the device is present if _STA does not exist. |
| */ |
| ACPI_DEBUG_EXEC (AcpiUtDisplayInitPathname ( |
| ACPI_TYPE_METHOD, DeviceNode, METHOD_NAME__STA)); |
| |
| Status = AcpiUtExecute_STA (DeviceNode, &Flags); |
| if (ACPI_FAILURE (Status)) |
| { |
| /* Ignore error and move on to next device */ |
| |
| return_ACPI_STATUS (AE_OK); |
| } |
| |
| /* |
| * Flags == -1 means that _STA was not found. In this case, we assume that |
| * the device is both present and functional. |
| * |
| * From the ACPI spec, description of _STA: |
| * |
| * "If a device object (including the processor object) does not have an |
| * _STA object, then OSPM assumes that all of the above bits are set (in |
| * other words, the device is present, ..., and functioning)" |
| */ |
| if (Flags != ACPI_UINT32_MAX) |
| { |
| WalkInfo->Num_STA++; |
| } |
| |
| /* |
| * Examine the PRESENT and FUNCTIONING status bits |
| * |
| * Note: ACPI spec does not seem to specify behavior for the present but |
| * not functioning case, so we assume functioning if present. |
| */ |
| if (!(Flags & ACPI_STA_DEVICE_PRESENT)) |
| { |
| /* Device is not present, we must examine the Functioning bit */ |
| |
| if (Flags & ACPI_STA_DEVICE_FUNCTIONING) |
| { |
| /* |
| * Device is not present but is "functioning". In this case, |
| * we will not run _INI, but we continue to examine the children |
| * of this device. |
| * |
| * From the ACPI spec, description of _STA: (Note - no mention |
| * of whether to run _INI or not on the device in question) |
| * |
| * "_STA may return bit 0 clear (not present) with bit 3 set |
| * (device is functional). This case is used to indicate a valid |
| * device for which no device driver should be loaded (for example, |
| * a bridge device.) Children of this device may be present and |
| * valid. OSPM should continue enumeration below a device whose |
| * _STA returns this bit combination" |
| */ |
| return_ACPI_STATUS (AE_OK); |
| } |
| else |
| { |
| /* |
| * Device is not present and is not functioning. We must abort the |
| * walk of this subtree immediately -- don't look at the children |
| * of such a device. |
| * |
| * From the ACPI spec, description of _INI: |
| * |
| * "If the _STA method indicates that the device is not present, |
| * OSPM will not run the _INI and will not examine the children |
| * of the device for _INI methods" |
| */ |
| return_ACPI_STATUS (AE_CTRL_DEPTH); |
| } |
| } |
| |
| /* |
| * The device is present or is assumed present if no _STA exists. |
| * Run the _INI if it exists (not required to exist) |
| * |
| * Note: We know there is an _INI within this subtree, but it may not be |
| * under this particular device, it may be lower in the branch. |
| */ |
| ACPI_DEBUG_EXEC (AcpiUtDisplayInitPathname ( |
| ACPI_TYPE_METHOD, DeviceNode, METHOD_NAME__INI)); |
| |
| memset (Info, 0, sizeof (ACPI_EVALUATE_INFO)); |
| Info->PrefixNode = DeviceNode; |
| Info->RelativePathname = METHOD_NAME__INI; |
| Info->Parameters = NULL; |
| Info->Flags = ACPI_IGNORE_RETURN_VALUE; |
| |
| Status = AcpiNsEvaluate (Info); |
| if (ACPI_SUCCESS (Status)) |
| { |
| WalkInfo->Num_INI++; |
| } |
| |
| #ifdef ACPI_DEBUG_OUTPUT |
| else if (Status != AE_NOT_FOUND) |
| { |
| /* Ignore error and move on to next device */ |
| |
| char *ScopeName = AcpiNsGetNormalizedPathname (DeviceNode, TRUE); |
| |
| ACPI_EXCEPTION ((AE_INFO, Status, "during %s._INI execution", |
| ScopeName)); |
| ACPI_FREE (ScopeName); |
| } |
| #endif |
| |
| /* Ignore errors from above */ |
| |
| Status = AE_OK; |
| |
| /* |
| * The _INI method has been run if present; call the Global Initialization |
| * Handler for this device. |
| */ |
| if (AcpiGbl_InitHandler) |
| { |
| Status = AcpiGbl_InitHandler (DeviceNode, ACPI_INIT_DEVICE_INI); |
| } |
| |
| return_ACPI_STATUS (Status); |
| } |