nsinit.c revision 71867
167754Smsmith/****************************************************************************** 267754Smsmith * 367754Smsmith * Module Name: nsinit - namespace initialization 471867Smsmith * $Revision: 12 $ 567754Smsmith * 667754Smsmith *****************************************************************************/ 767754Smsmith 867754Smsmith/****************************************************************************** 967754Smsmith * 1067754Smsmith * 1. Copyright Notice 1167754Smsmith * 1271867Smsmith * Some or all of this work - Copyright (c) 1999, 2000, 2001, Intel Corp. 1370243Smsmith * All rights reserved. 1467754Smsmith * 1567754Smsmith * 2. License 1667754Smsmith * 1767754Smsmith * 2.1. This is your license from Intel Corp. under its intellectual property 1867754Smsmith * rights. You may have additional license terms from the party that provided 1967754Smsmith * you this software, covering your right to use that party's intellectual 2067754Smsmith * property rights. 2167754Smsmith * 2267754Smsmith * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a 2367754Smsmith * copy of the source code appearing in this file ("Covered Code") an 2467754Smsmith * irrevocable, perpetual, worldwide license under Intel's copyrights in the 2567754Smsmith * base code distributed originally by Intel ("Original Intel Code") to copy, 2667754Smsmith * make derivatives, distribute, use and display any portion of the Covered 2767754Smsmith * Code in any form, with the right to sublicense such rights; and 2867754Smsmith * 2967754Smsmith * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent 3067754Smsmith * license (with the right to sublicense), under only those claims of Intel 3167754Smsmith * patents that are infringed by the Original Intel Code, to make, use, sell, 3267754Smsmith * offer to sell, and import the Covered Code and derivative works thereof 3367754Smsmith * solely to the minimum extent necessary to exercise the above copyright 3467754Smsmith * license, and in no event shall the patent license extend to any additions 3567754Smsmith * to or modifications of the Original Intel Code. No other license or right 3667754Smsmith * is granted directly or by implication, estoppel or otherwise; 3767754Smsmith * 3867754Smsmith * The above copyright and patent license is granted only if the following 3967754Smsmith * conditions are met: 4067754Smsmith * 4167754Smsmith * 3. Conditions 4267754Smsmith * 4367754Smsmith * 3.1. Redistribution of Source with Rights to Further Distribute Source. 4467754Smsmith * Redistribution of source code of any substantial portion of the Covered 4567754Smsmith * Code or modification with rights to further distribute source must include 4667754Smsmith * the above Copyright Notice, the above License, this list of Conditions, 4767754Smsmith * and the following Disclaimer and Export Compliance provision. In addition, 4867754Smsmith * Licensee must cause all Covered Code to which Licensee contributes to 4967754Smsmith * contain a file documenting the changes Licensee made to create that Covered 5067754Smsmith * Code and the date of any change. Licensee must include in that file the 5167754Smsmith * documentation of any changes made by any predecessor Licensee. Licensee 5267754Smsmith * must include a prominent statement that the modification is derived, 5367754Smsmith * directly or indirectly, from Original Intel Code. 5467754Smsmith * 5567754Smsmith * 3.2. Redistribution of Source with no Rights to Further Distribute Source. 5667754Smsmith * Redistribution of source code of any substantial portion of the Covered 5767754Smsmith * Code or modification without rights to further distribute source must 5867754Smsmith * include the following Disclaimer and Export Compliance provision in the 5967754Smsmith * documentation and/or other materials provided with distribution. In 6067754Smsmith * addition, Licensee may not authorize further sublicense of source of any 6167754Smsmith * portion of the Covered Code, and must include terms to the effect that the 6267754Smsmith * license from Licensee to its licensee is limited to the intellectual 6367754Smsmith * property embodied in the software Licensee provides to its licensee, and 6467754Smsmith * not to intellectual property embodied in modifications its licensee may 6567754Smsmith * make. 6667754Smsmith * 6767754Smsmith * 3.3. Redistribution of Executable. Redistribution in executable form of any 6867754Smsmith * substantial portion of the Covered Code or modification must reproduce the 6967754Smsmith * above Copyright Notice, and the following Disclaimer and Export Compliance 7067754Smsmith * provision in the documentation and/or other materials provided with the 7167754Smsmith * distribution. 7267754Smsmith * 7367754Smsmith * 3.4. Intel retains all right, title, and interest in and to the Original 7467754Smsmith * Intel Code. 7567754Smsmith * 7667754Smsmith * 3.5. Neither the name Intel nor any other trademark owned or controlled by 7767754Smsmith * Intel shall be used in advertising or otherwise to promote the sale, use or 7867754Smsmith * other dealings in products derived from or relating to the Covered Code 7967754Smsmith * without prior written authorization from Intel. 8067754Smsmith * 8167754Smsmith * 4. Disclaimer and Export Compliance 8267754Smsmith * 8367754Smsmith * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED 8467754Smsmith * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE 8567754Smsmith * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE, 8667754Smsmith * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY 8767754Smsmith * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY 8867754Smsmith * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A 8967754Smsmith * PARTICULAR PURPOSE. 9067754Smsmith * 9167754Smsmith * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES 9267754Smsmith * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR 9367754Smsmith * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT, 9467754Smsmith * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY 9567754Smsmith * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL 9667754Smsmith * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS 9767754Smsmith * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY 9867754Smsmith * LIMITED REMEDY. 9967754Smsmith * 10067754Smsmith * 4.3. Licensee shall not export, either directly or indirectly, any of this 10167754Smsmith * software or system incorporating such software without first obtaining any 10267754Smsmith * required license or other approval from the U. S. Department of Commerce or 10367754Smsmith * any other agency or department of the United States Government. In the 10467754Smsmith * event Licensee exports any such software from the United States or 10567754Smsmith * re-exports any such software from a foreign destination, Licensee shall 10667754Smsmith * ensure that the distribution and export/re-export of the software is in 10767754Smsmith * compliance with all laws, regulations, orders, or other restrictions of the 10867754Smsmith * U.S. Export Administration Regulations. Licensee agrees that neither it nor 10967754Smsmith * any of its subsidiaries will export/re-export any technical data, process, 11067754Smsmith * software, or service, directly or indirectly, to any country for which the 11167754Smsmith * United States government or any agency thereof requires an export license, 11267754Smsmith * other governmental approval, or letter of assurance, without first obtaining 11367754Smsmith * such license, approval or letter. 11467754Smsmith * 11567754Smsmith *****************************************************************************/ 11667754Smsmith 11767754Smsmith 11867754Smsmith#define __NSXFINIT_C__ 11967754Smsmith 12067754Smsmith#include "acpi.h" 12167754Smsmith#include "acnamesp.h" 12267754Smsmith#include "acdispat.h" 12367754Smsmith 12467754Smsmith#define _COMPONENT NAMESPACE 12567754Smsmith MODULE_NAME ("nsinit") 12667754Smsmith 12767754Smsmith 12867754Smsmith/******************************************************************************* 12967754Smsmith * 13067754Smsmith * FUNCTION: AcpiNsInitializeObjects 13167754Smsmith * 13267754Smsmith * PARAMETERS: None 13367754Smsmith * 13467754Smsmith * RETURN: Status 13567754Smsmith * 13667754Smsmith * DESCRIPTION: Walk the entire namespace and perform any necessary 13767754Smsmith * initialization on the objects found therein 13867754Smsmith * 13967754Smsmith ******************************************************************************/ 14067754Smsmith 14167754SmsmithACPI_STATUS 14267754SmsmithAcpiNsInitializeObjects ( 14367754Smsmith void) 14467754Smsmith{ 14567754Smsmith ACPI_STATUS Status; 14667754Smsmith ACPI_INIT_WALK_INFO Info; 14767754Smsmith 14867754Smsmith 14967754Smsmith FUNCTION_TRACE ("NsInitializeObjects"); 15067754Smsmith 15167754Smsmith 15267754Smsmith DEBUG_PRINT (TRACE_DISPATCH, 15367754Smsmith ("NsInitializeObjects: **** Starting initialization of namespace objects ****\n")); 15467754Smsmith DEBUG_PRINT_RAW (ACPI_OK, ("Completing Region and Field initialization:")); 15567754Smsmith 15667754Smsmith 15767754Smsmith Info.FieldCount = 0; 15867754Smsmith Info.FieldInit = 0; 15967754Smsmith Info.OpRegionCount = 0; 16067754Smsmith Info.OpRegionInit = 0; 16167754Smsmith Info.ObjectCount = 0; 16267754Smsmith 16367754Smsmith 16467754Smsmith /* Walk entire namespace from the supplied root */ 16567754Smsmith 16667754Smsmith Status = AcpiWalkNamespace (ACPI_TYPE_ANY, ACPI_ROOT_OBJECT, 16767754Smsmith ACPI_UINT32_MAX, AcpiNsInitOneObject, 16867754Smsmith &Info, NULL); 16967754Smsmith if (ACPI_FAILURE (Status)) 17067754Smsmith { 17167754Smsmith DEBUG_PRINT (ACPI_ERROR, 17267754Smsmith ("NsInitializeObjects: WalkNamespace failed! %x\n", Status)); 17367754Smsmith } 17467754Smsmith 17567754Smsmith DEBUG_PRINT_RAW (ACPI_OK, 17667754Smsmith ("\n%d/%d Regions, %d/%d Fields initialized (%d nodes total)\n", 17767754Smsmith Info.OpRegionInit, Info.OpRegionCount, Info.FieldInit, Info.FieldCount, Info.ObjectCount)); 17867754Smsmith DEBUG_PRINT (TRACE_DISPATCH, 17967754Smsmith ("NsInitializeObjects: %d Control Methods found\n", Info.MethodCount)); 18067754Smsmith DEBUG_PRINT (TRACE_DISPATCH, 18167754Smsmith ("NsInitializeObjects: %d Op Regions found\n", Info.OpRegionCount)); 18267754Smsmith 18367754Smsmith return_ACPI_STATUS (AE_OK); 18467754Smsmith} 18567754Smsmith 18667754Smsmith 18767754Smsmith/****************************************************************************** 18867754Smsmith * 18967754Smsmith * FUNCTION: AcpiNsInitializeDevices 19067754Smsmith * 19167754Smsmith * PARAMETERS: None 19267754Smsmith * 19367754Smsmith * RETURN: ACPI_STATUS 19467754Smsmith * 19567754Smsmith * DESCRIPTION: Walk the entire namespace and initialize all ACPI devices. 19667754Smsmith * This means running _INI on all present devices. 19767754Smsmith * 19867754Smsmith * Also: Install PCI config space handler for all PCI root bridges. 19967754Smsmith * A PCI root bridge is found by searching for devices containing 20067754Smsmith * a HID with the value EISAID("PNP0A03") 20167754Smsmith * 20267754Smsmith *****************************************************************************/ 20367754Smsmith 20467754SmsmithACPI_STATUS 20567754SmsmithAcpiNsInitializeDevices ( 20667754Smsmith UINT32 Flags) 20767754Smsmith{ 20867754Smsmith ACPI_STATUS Status; 20967754Smsmith ACPI_DEVICE_WALK_INFO Info; 21067754Smsmith 21167754Smsmith 21267754Smsmith FUNCTION_TRACE ("NsInitializeDevices"); 21367754Smsmith 21467754Smsmith 21567754Smsmith Info.Flags = Flags; 21667754Smsmith Info.DeviceCount = 0; 21767754Smsmith Info.Num_STA = 0; 21867754Smsmith Info.Num_INI = 0; 21967754Smsmith 22067754Smsmith 22167754Smsmith DEBUG_PRINT_RAW (ACPI_OK, ("Executing device _INI methods:")); 22267754Smsmith 22367754Smsmith Status = AcpiNsWalkNamespace (ACPI_TYPE_DEVICE, ACPI_ROOT_OBJECT, ACPI_UINT32_MAX, 22467754Smsmith FALSE, AcpiNsInitOneDevice, &Info, NULL); 22567754Smsmith 22667754Smsmith if (ACPI_FAILURE (Status)) 22767754Smsmith { 22867754Smsmith DEBUG_PRINT (ACPI_ERROR, 22967754Smsmith ("NsInitializeDevices: WalkNamespace failed! %x\n", Status)); 23067754Smsmith } 23167754Smsmith 23267754Smsmith 23367754Smsmith DEBUG_PRINT_RAW (ACPI_OK, 23469746Smsmith ("\n%d Devices found: %d _STA, %d _INI\n", 23569746Smsmith Info.DeviceCount, Info.Num_STA, Info.Num_INI)); 23667754Smsmith 23767754Smsmith return_ACPI_STATUS (Status); 23867754Smsmith} 23967754Smsmith 24067754Smsmith 24167754Smsmith/******************************************************************************* 24267754Smsmith * 24367754Smsmith * FUNCTION: AcpiNsInitOneObject 24467754Smsmith * 24567754Smsmith * PARAMETERS: ObjHandle - Node 24667754Smsmith * Level - Current nesting level 24767754Smsmith * Context - Points to a init info struct 24867754Smsmith * ReturnValue - Not used 24967754Smsmith * 25067754Smsmith * RETURN: Status 25167754Smsmith * 25267754Smsmith * DESCRIPTION: Callback from AcpiWalkNamespace. Invoked for every object 25367754Smsmith * within the namespace. 25467754Smsmith * 25567754Smsmith * Currently, the only objects that require initialization are: 25667754Smsmith * 1) Methods 25767754Smsmith * 2) Op Regions 25867754Smsmith * 25967754Smsmith ******************************************************************************/ 26067754Smsmith 26167754SmsmithACPI_STATUS 26267754SmsmithAcpiNsInitOneObject ( 26367754Smsmith ACPI_HANDLE ObjHandle, 26467754Smsmith UINT32 Level, 26567754Smsmith void *Context, 26667754Smsmith void **ReturnValue) 26767754Smsmith{ 26867754Smsmith OBJECT_TYPE_INTERNAL Type; 26967754Smsmith ACPI_STATUS Status; 27067754Smsmith ACPI_INIT_WALK_INFO *Info = (ACPI_INIT_WALK_INFO *) Context; 27167754Smsmith ACPI_NAMESPACE_NODE *Node = (ACPI_NAMESPACE_NODE *) ObjHandle; 27267754Smsmith ACPI_OPERAND_OBJECT *ObjDesc; 27367754Smsmith 27467754Smsmith 27567754Smsmith Info->ObjectCount++; 27667754Smsmith 27767754Smsmith 27867754Smsmith /* And even then, we are only interested in a few object types */ 27967754Smsmith 28067754Smsmith Type = AcpiNsGetType (ObjHandle); 28167754Smsmith ObjDesc = Node->Object; 28267754Smsmith if (!ObjDesc) 28367754Smsmith { 28467754Smsmith return (AE_OK); 28567754Smsmith } 28667754Smsmith 28767754Smsmith switch (Type) 28867754Smsmith { 28967754Smsmith 29067754Smsmith case ACPI_TYPE_REGION: 29167754Smsmith 29267754Smsmith Info->OpRegionCount++; 29367754Smsmith if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID) 29467754Smsmith { 29567754Smsmith break; 29667754Smsmith } 29767754Smsmith 29867754Smsmith Info->OpRegionInit++; 29967754Smsmith Status = AcpiDsGetRegionArguments (ObjDesc); 30069746Smsmith if (ACPI_FAILURE (Status)) 30169746Smsmith { 30269746Smsmith DEBUG_PRINT_RAW (ACPI_ERROR, ("\n")); 30370243Smsmith DEBUG_PRINT (ACPI_ERROR, ("%s while getting region arguments [%4.4s]\n", 30469746Smsmith AcpiCmFormatException (Status), &Node->Name)); 30569746Smsmith } 30669746Smsmith 30767754Smsmith DEBUG_PRINT_RAW (ACPI_OK, (".")); 30867754Smsmith break; 30967754Smsmith 31067754Smsmith 31167754Smsmith case ACPI_TYPE_FIELD_UNIT: 31267754Smsmith 31367754Smsmith Info->FieldCount++; 31467754Smsmith if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID) 31567754Smsmith { 31667754Smsmith break; 31767754Smsmith } 31867754Smsmith 31967754Smsmith Info->FieldInit++; 32067754Smsmith Status = AcpiDsGetFieldUnitArguments (ObjDesc); 32169746Smsmith if (ACPI_FAILURE (Status)) 32269746Smsmith { 32369746Smsmith DEBUG_PRINT_RAW (ACPI_ERROR, ("\n")); 32470243Smsmith DEBUG_PRINT (ACPI_ERROR, ("%s while getting field arguments [%4.4s]\n", 32569746Smsmith AcpiCmFormatException (Status), &Node->Name)); 32669746Smsmith } 32767754Smsmith DEBUG_PRINT_RAW (ACPI_OK, (".")); 32867754Smsmith 32967754Smsmith break; 33067754Smsmith 33167754Smsmith default: 33267754Smsmith break; 33367754Smsmith } 33467754Smsmith 33567754Smsmith /* 33667754Smsmith * We ignore errors from above, and always return OK, since 33767754Smsmith * we don't want to abort the walk on a single error. 33867754Smsmith */ 33967754Smsmith return (AE_OK); 34067754Smsmith} 34167754Smsmith 34267754Smsmith 34367754Smsmith/****************************************************************************** 34467754Smsmith * 34567754Smsmith * FUNCTION: AcpiNsInitOneDevice 34667754Smsmith * 34767754Smsmith * PARAMETERS: The usual "I'm a namespace callback" stuff 34867754Smsmith * 34967754Smsmith * RETURN: ACPI_STATUS 35067754Smsmith * 35167754Smsmith * DESCRIPTION: This is called once per device soon after ACPI is enabled 35267754Smsmith * to initialize each device. It determines if the device is 35367754Smsmith * present, and if so, calls _INI. 35467754Smsmith * 35567754Smsmith *****************************************************************************/ 35667754Smsmith 35767754SmsmithACPI_STATUS 35867754SmsmithAcpiNsInitOneDevice ( 35967754Smsmith ACPI_HANDLE ObjHandle, 36067754Smsmith UINT32 NestingLevel, 36167754Smsmith void *Context, 36267754Smsmith void **ReturnValue) 36367754Smsmith{ 36467754Smsmith ACPI_STATUS Status; 36567754Smsmith ACPI_NAMESPACE_NODE *Node; 36667754Smsmith UINT32 Flags; 36767754Smsmith ACPI_DEVICE_WALK_INFO *Info = (ACPI_DEVICE_WALK_INFO *) Context; 36867754Smsmith 36967754Smsmith 37067754Smsmith FUNCTION_TRACE ("AcpiNsInitOneDevice"); 37167754Smsmith 37267754Smsmith 37367754Smsmith DEBUG_PRINT_RAW (ACPI_OK, (".")); 37467754Smsmith Info->DeviceCount++; 37567754Smsmith 37667754Smsmith AcpiCmAcquireMutex (ACPI_MTX_NAMESPACE); 37767754Smsmith 37867754Smsmith Node = AcpiNsConvertHandleToEntry (ObjHandle); 37967754Smsmith if (!Node) 38067754Smsmith { 38167754Smsmith AcpiCmReleaseMutex (ACPI_MTX_NAMESPACE); 38267754Smsmith return (AE_BAD_PARAMETER); 38367754Smsmith } 38467754Smsmith 38567754Smsmith AcpiCmReleaseMutex (ACPI_MTX_NAMESPACE); 38667754Smsmith 38767754Smsmith /* 38867754Smsmith * Run _STA to determine if we can run _INI on the device. 38967754Smsmith */ 39067754Smsmith 39167754Smsmith Status = AcpiCmExecute_STA (Node, &Flags); 39267754Smsmith if (ACPI_FAILURE (Status)) 39367754Smsmith { 39471867Smsmith /* Ignore error and move on to next device */ 39571867Smsmith 39671867Smsmith return_ACPI_STATUS (AE_OK); 39767754Smsmith } 39867754Smsmith 39967754Smsmith Info->Num_STA++; 40067754Smsmith 40167754Smsmith if (!(Flags & 0x01)) 40267754Smsmith { 40367754Smsmith /* don't look at children of a not present device */ 40467754Smsmith return_ACPI_STATUS(AE_CTRL_DEPTH); 40567754Smsmith } 40667754Smsmith 40767754Smsmith /* 40867754Smsmith * The device is present. Run _INI. 40967754Smsmith */ 41067754Smsmith 41167754Smsmith Status = AcpiNsEvaluateRelative (ObjHandle, "_INI", NULL, NULL); 41267754Smsmith if (AE_NOT_FOUND == Status) 41367754Smsmith { 41469746Smsmith /* No _INI means device requires no initialization */ 41569746Smsmith Status = AE_OK; 41667754Smsmith } 41767754Smsmith 41867754Smsmith else if (ACPI_FAILURE (Status)) 41967754Smsmith { 42071867Smsmith /* Ignore error and move on to next device */ 42171867Smsmith 42267754Smsmith#ifdef ACPI_DEBUG 42367754Smsmith NATIVE_CHAR *ScopeName = AcpiNsGetTablePathname (ObjHandle); 42467754Smsmith 42571867Smsmith DEBUG_PRINT (ACPI_WARN, ("%s._INI failed: %s\n", 42667754Smsmith ScopeName, AcpiCmFormatException (Status))); 42767754Smsmith 42867754Smsmith AcpiCmFree (ScopeName); 42967754Smsmith#endif 43067754Smsmith } 43167754Smsmith 43267754Smsmith else 43367754Smsmith { 43471867Smsmith /* Count of successfull INIs */ 43571867Smsmith 43667754Smsmith Info->Num_INI++; 43767754Smsmith } 43867754Smsmith 43971867Smsmith return_ACPI_STATUS (AE_OK); 44067754Smsmith} 441