nsinit.c revision 80062
167754Smsmith/****************************************************************************** 267754Smsmith * 367754Smsmith * Module Name: nsinit - namespace initialization 480062Smsmith * $Revision: 28 $ 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" 12380062Smsmith#include "acinterp.h" 12467754Smsmith 12577424Smsmith#define _COMPONENT ACPI_NAMESPACE 12667754Smsmith MODULE_NAME ("nsinit") 12767754Smsmith 12867754Smsmith 12967754Smsmith/******************************************************************************* 13067754Smsmith * 13167754Smsmith * FUNCTION: AcpiNsInitializeObjects 13267754Smsmith * 13367754Smsmith * PARAMETERS: None 13467754Smsmith * 13567754Smsmith * RETURN: Status 13667754Smsmith * 13767754Smsmith * DESCRIPTION: Walk the entire namespace and perform any necessary 13867754Smsmith * initialization on the objects found therein 13967754Smsmith * 14067754Smsmith ******************************************************************************/ 14167754Smsmith 14267754SmsmithACPI_STATUS 14367754SmsmithAcpiNsInitializeObjects ( 14467754Smsmith void) 14567754Smsmith{ 14667754Smsmith ACPI_STATUS Status; 14767754Smsmith ACPI_INIT_WALK_INFO Info; 14867754Smsmith 14967754Smsmith 15067754Smsmith FUNCTION_TRACE ("NsInitializeObjects"); 15167754Smsmith 15267754Smsmith 15377424Smsmith DEBUG_PRINTP (TRACE_DISPATCH, 15477424Smsmith ("**** Starting initialization of namespace objects ****\n")); 15567754Smsmith DEBUG_PRINT_RAW (ACPI_OK, ("Completing Region and Field initialization:")); 15667754Smsmith 15767754Smsmith 15867754Smsmith Info.FieldCount = 0; 15967754Smsmith Info.FieldInit = 0; 16067754Smsmith Info.OpRegionCount = 0; 16167754Smsmith Info.OpRegionInit = 0; 16267754Smsmith Info.ObjectCount = 0; 16367754Smsmith 16467754Smsmith 16567754Smsmith /* Walk entire namespace from the supplied root */ 16667754Smsmith 16767754Smsmith Status = AcpiWalkNamespace (ACPI_TYPE_ANY, ACPI_ROOT_OBJECT, 16867754Smsmith ACPI_UINT32_MAX, AcpiNsInitOneObject, 16967754Smsmith &Info, NULL); 17067754Smsmith if (ACPI_FAILURE (Status)) 17167754Smsmith { 17277424Smsmith DEBUG_PRINTP (ACPI_ERROR, ("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", 17777424Smsmith Info.OpRegionInit, Info.OpRegionCount, Info.FieldInit, 17877424Smsmith Info.FieldCount, Info.ObjectCount)); 17977424Smsmith DEBUG_PRINTP (TRACE_DISPATCH, 18077424Smsmith ("%d Control Methods found\n", Info.MethodCount)); 18177424Smsmith DEBUG_PRINTP (TRACE_DISPATCH, 18277424Smsmith ("%d Op Regions found\n", Info.OpRegionCount)); 18367754Smsmith 18467754Smsmith return_ACPI_STATUS (AE_OK); 18567754Smsmith} 18667754Smsmith 18767754Smsmith 18877424Smsmith/******************************************************************************* 18967754Smsmith * 19067754Smsmith * FUNCTION: AcpiNsInitializeDevices 19167754Smsmith * 19267754Smsmith * PARAMETERS: None 19367754Smsmith * 19467754Smsmith * RETURN: ACPI_STATUS 19567754Smsmith * 19667754Smsmith * DESCRIPTION: Walk the entire namespace and initialize all ACPI devices. 19767754Smsmith * This means running _INI on all present devices. 19867754Smsmith * 19977424Smsmith * Note: We install PCI config space handler on region access, 20077424Smsmith * not here. 20167754Smsmith * 20277424Smsmith ******************************************************************************/ 20367754Smsmith 20467754SmsmithACPI_STATUS 20567754SmsmithAcpiNsInitializeDevices ( 20673561Smsmith void) 20767754Smsmith{ 20867754Smsmith ACPI_STATUS Status; 20967754Smsmith ACPI_DEVICE_WALK_INFO Info; 21067754Smsmith 21167754Smsmith 21267754Smsmith FUNCTION_TRACE ("NsInitializeDevices"); 21367754Smsmith 21467754Smsmith 21567754Smsmith Info.DeviceCount = 0; 21667754Smsmith Info.Num_STA = 0; 21767754Smsmith Info.Num_INI = 0; 21867754Smsmith 21967754Smsmith 22067754Smsmith DEBUG_PRINT_RAW (ACPI_OK, ("Executing device _INI methods:")); 22167754Smsmith 22277424Smsmith Status = AcpiNsWalkNamespace (ACPI_TYPE_DEVICE, ACPI_ROOT_OBJECT, 22377424Smsmith ACPI_UINT32_MAX, FALSE, AcpiNsInitOneDevice, &Info, NULL); 22467754Smsmith 22567754Smsmith if (ACPI_FAILURE (Status)) 22667754Smsmith { 22777424Smsmith DEBUG_PRINTP (ACPI_ERROR, ("WalkNamespace failed! %x\n", Status)); 22867754Smsmith } 22967754Smsmith 23067754Smsmith 23167754Smsmith DEBUG_PRINT_RAW (ACPI_OK, 23269746Smsmith ("\n%d Devices found: %d _STA, %d _INI\n", 23369746Smsmith Info.DeviceCount, Info.Num_STA, Info.Num_INI)); 23467754Smsmith 23567754Smsmith return_ACPI_STATUS (Status); 23667754Smsmith} 23767754Smsmith 23867754Smsmith 23967754Smsmith/******************************************************************************* 24067754Smsmith * 24167754Smsmith * FUNCTION: AcpiNsInitOneObject 24267754Smsmith * 24367754Smsmith * PARAMETERS: ObjHandle - Node 24467754Smsmith * Level - Current nesting level 24567754Smsmith * Context - Points to a init info struct 24667754Smsmith * ReturnValue - Not used 24767754Smsmith * 24867754Smsmith * RETURN: Status 24967754Smsmith * 25067754Smsmith * DESCRIPTION: Callback from AcpiWalkNamespace. Invoked for every object 25167754Smsmith * within the namespace. 25267754Smsmith * 25367754Smsmith * Currently, the only objects that require initialization are: 25467754Smsmith * 1) Methods 25567754Smsmith * 2) Op Regions 25667754Smsmith * 25767754Smsmith ******************************************************************************/ 25867754Smsmith 25967754SmsmithACPI_STATUS 26067754SmsmithAcpiNsInitOneObject ( 26167754Smsmith ACPI_HANDLE ObjHandle, 26267754Smsmith UINT32 Level, 26367754Smsmith void *Context, 26467754Smsmith void **ReturnValue) 26567754Smsmith{ 26677424Smsmith ACPI_OBJECT_TYPE8 Type; 26767754Smsmith ACPI_STATUS Status; 26867754Smsmith ACPI_INIT_WALK_INFO *Info = (ACPI_INIT_WALK_INFO *) Context; 26967754Smsmith ACPI_NAMESPACE_NODE *Node = (ACPI_NAMESPACE_NODE *) ObjHandle; 27067754Smsmith ACPI_OPERAND_OBJECT *ObjDesc; 27167754Smsmith 27267754Smsmith 27367754Smsmith Info->ObjectCount++; 27467754Smsmith 27567754Smsmith 27667754Smsmith /* And even then, we are only interested in a few object types */ 27767754Smsmith 27867754Smsmith Type = AcpiNsGetType (ObjHandle); 27967754Smsmith ObjDesc = Node->Object; 28067754Smsmith if (!ObjDesc) 28167754Smsmith { 28267754Smsmith return (AE_OK); 28367754Smsmith } 28467754Smsmith 28580062Smsmith if ((Type != ACPI_TYPE_REGION) && 28680062Smsmith (Type != ACPI_TYPE_BUFFER_FIELD)) 28780062Smsmith { 28880062Smsmith return (AE_OK); 28980062Smsmith } 29080062Smsmith 29180062Smsmith 29280062Smsmith /* 29380062Smsmith * Must lock the interpreter before executing AML code 29480062Smsmith */ 29580062Smsmith Status = AcpiExEnterInterpreter (); 29680062Smsmith if (ACPI_FAILURE (Status)) 29780062Smsmith { 29880062Smsmith return (Status); 29980062Smsmith } 30080062Smsmith 30167754Smsmith switch (Type) 30267754Smsmith { 30367754Smsmith 30467754Smsmith case ACPI_TYPE_REGION: 30567754Smsmith 30667754Smsmith Info->OpRegionCount++; 30767754Smsmith if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID) 30867754Smsmith { 30967754Smsmith break; 31067754Smsmith } 31167754Smsmith 31267754Smsmith Info->OpRegionInit++; 31367754Smsmith Status = AcpiDsGetRegionArguments (ObjDesc); 31469746Smsmith if (ACPI_FAILURE (Status)) 31569746Smsmith { 31669746Smsmith DEBUG_PRINT_RAW (ACPI_ERROR, ("\n")); 31777424Smsmith DEBUG_PRINT (ACPI_ERROR, 31877424Smsmith ("%s while getting region arguments [%4.4s]\n", 31980062Smsmith AcpiFormatException (Status), &Node->Name)); 32069746Smsmith } 32169746Smsmith 32273561Smsmith if (!(AcpiDbgLevel & TRACE_INIT)) 32373561Smsmith { 32473561Smsmith DEBUG_PRINT_RAW (ACPI_OK, (".")); 32573561Smsmith } 32673561Smsmith 32767754Smsmith break; 32867754Smsmith 32967754Smsmith 33077424Smsmith case ACPI_TYPE_BUFFER_FIELD: 33167754Smsmith 33267754Smsmith Info->FieldCount++; 33367754Smsmith if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID) 33467754Smsmith { 33567754Smsmith break; 33667754Smsmith } 33767754Smsmith 33867754Smsmith Info->FieldInit++; 33977424Smsmith Status = AcpiDsGetBufferFieldArguments (ObjDesc); 34069746Smsmith if (ACPI_FAILURE (Status)) 34169746Smsmith { 34269746Smsmith DEBUG_PRINT_RAW (ACPI_ERROR, ("\n")); 34377424Smsmith DEBUG_PRINT (ACPI_ERROR, 34477424Smsmith ("%s while getting buffer field arguments [%4.4s]\n", 34580062Smsmith AcpiFormatException (Status), &Node->Name)); 34669746Smsmith } 34773561Smsmith if (!(AcpiDbgLevel & TRACE_INIT)) 34873561Smsmith { 34973561Smsmith DEBUG_PRINT_RAW (ACPI_OK, (".")); 35073561Smsmith } 35167754Smsmith 35273561Smsmith 35367754Smsmith break; 35467754Smsmith 35567754Smsmith default: 35667754Smsmith break; 35767754Smsmith } 35867754Smsmith 35980062Smsmith 36067754Smsmith /* 36167754Smsmith * We ignore errors from above, and always return OK, since 36267754Smsmith * we don't want to abort the walk on a single error. 36367754Smsmith */ 36480062Smsmith AcpiExExitInterpreter (); 36567754Smsmith return (AE_OK); 36667754Smsmith} 36767754Smsmith 36867754Smsmith 36977424Smsmith/******************************************************************************* 37067754Smsmith * 37167754Smsmith * FUNCTION: AcpiNsInitOneDevice 37267754Smsmith * 37377424Smsmith * PARAMETERS: ACPI_WALK_CALLBACK 37467754Smsmith * 37567754Smsmith * RETURN: ACPI_STATUS 37667754Smsmith * 37767754Smsmith * DESCRIPTION: This is called once per device soon after ACPI is enabled 37867754Smsmith * to initialize each device. It determines if the device is 37967754Smsmith * present, and if so, calls _INI. 38067754Smsmith * 38177424Smsmith ******************************************************************************/ 38267754Smsmith 38367754SmsmithACPI_STATUS 38467754SmsmithAcpiNsInitOneDevice ( 38567754Smsmith ACPI_HANDLE ObjHandle, 38667754Smsmith UINT32 NestingLevel, 38767754Smsmith void *Context, 38867754Smsmith void **ReturnValue) 38967754Smsmith{ 39067754Smsmith ACPI_STATUS Status; 39167754Smsmith ACPI_NAMESPACE_NODE *Node; 39267754Smsmith UINT32 Flags; 39367754Smsmith ACPI_DEVICE_WALK_INFO *Info = (ACPI_DEVICE_WALK_INFO *) Context; 39467754Smsmith 39567754Smsmith 39667754Smsmith FUNCTION_TRACE ("AcpiNsInitOneDevice"); 39767754Smsmith 39867754Smsmith 39973561Smsmith if (!(AcpiDbgLevel & TRACE_INIT)) 40073561Smsmith { 40173561Smsmith DEBUG_PRINT_RAW (ACPI_OK, (".")); 40273561Smsmith } 40373561Smsmith 40467754Smsmith Info->DeviceCount++; 40567754Smsmith 40677424Smsmith AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE); 40767754Smsmith 40867754Smsmith Node = AcpiNsConvertHandleToEntry (ObjHandle); 40967754Smsmith if (!Node) 41067754Smsmith { 41177424Smsmith AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE); 41267754Smsmith return (AE_BAD_PARAMETER); 41367754Smsmith } 41467754Smsmith 41577424Smsmith AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE); 41667754Smsmith 41767754Smsmith /* 41867754Smsmith * Run _STA to determine if we can run _INI on the device. 41967754Smsmith */ 42067754Smsmith 42177424Smsmith DEBUG_EXEC (AcpiUtDisplayInitPathname (Node, "_STA [Method]")); 42277424Smsmith Status = AcpiUtExecute_STA (Node, &Flags); 42367754Smsmith if (ACPI_FAILURE (Status)) 42467754Smsmith { 42571867Smsmith /* Ignore error and move on to next device */ 42671867Smsmith 42771867Smsmith return_ACPI_STATUS (AE_OK); 42867754Smsmith } 42967754Smsmith 43067754Smsmith Info->Num_STA++; 43167754Smsmith 43267754Smsmith if (!(Flags & 0x01)) 43367754Smsmith { 43467754Smsmith /* don't look at children of a not present device */ 43577424Smsmith 43667754Smsmith return_ACPI_STATUS(AE_CTRL_DEPTH); 43767754Smsmith } 43867754Smsmith 43973561Smsmith 44067754Smsmith /* 44167754Smsmith * The device is present. Run _INI. 44267754Smsmith */ 44377424Smsmith DEBUG_EXEC (AcpiUtDisplayInitPathname (ObjHandle, "_INI [Method]")); 44467754Smsmith Status = AcpiNsEvaluateRelative (ObjHandle, "_INI", NULL, NULL); 44567754Smsmith if (AE_NOT_FOUND == Status) 44667754Smsmith { 44769746Smsmith /* No _INI means device requires no initialization */ 44877424Smsmith 44969746Smsmith Status = AE_OK; 45067754Smsmith } 45167754Smsmith 45267754Smsmith else if (ACPI_FAILURE (Status)) 45367754Smsmith { 45471867Smsmith /* Ignore error and move on to next device */ 45571867Smsmith 45667754Smsmith#ifdef ACPI_DEBUG 45767754Smsmith NATIVE_CHAR *ScopeName = AcpiNsGetTablePathname (ObjHandle); 45867754Smsmith 45977424Smsmith DEBUG_PRINTP (ACPI_WARN, ("%s._INI failed: %s\n", 46080062Smsmith ScopeName, AcpiFormatException (Status))); 46167754Smsmith 46280062Smsmith ACPI_MEM_FREE (ScopeName); 46367754Smsmith#endif 46467754Smsmith } 46567754Smsmith 46667754Smsmith else 46767754Smsmith { 46877424Smsmith /* Count of successful INIs */ 46971867Smsmith 47067754Smsmith Info->Num_INI++; 47167754Smsmith } 47267754Smsmith 47371867Smsmith return_ACPI_STATUS (AE_OK); 47467754Smsmith} 475