Home | History | Annotate | Line # | Download | only in utilities
utxfinit.c revision 1.1.1.1
      1  1.1  christos /******************************************************************************
      2  1.1  christos  *
      3  1.1  christos  * Module Name: utxfinit - External interfaces for ACPICA initialization
      4  1.1  christos  *
      5  1.1  christos  *****************************************************************************/
      6  1.1  christos 
      7  1.1  christos /*
      8  1.1  christos  * Copyright (C) 2000 - 2013, Intel Corp.
      9  1.1  christos  * All rights reserved.
     10  1.1  christos  *
     11  1.1  christos  * Redistribution and use in source and binary forms, with or without
     12  1.1  christos  * modification, are permitted provided that the following conditions
     13  1.1  christos  * are met:
     14  1.1  christos  * 1. Redistributions of source code must retain the above copyright
     15  1.1  christos  *    notice, this list of conditions, and the following disclaimer,
     16  1.1  christos  *    without modification.
     17  1.1  christos  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18  1.1  christos  *    substantially similar to the "NO WARRANTY" disclaimer below
     19  1.1  christos  *    ("Disclaimer") and any redistribution must be conditioned upon
     20  1.1  christos  *    including a substantially similar Disclaimer requirement for further
     21  1.1  christos  *    binary redistribution.
     22  1.1  christos  * 3. Neither the names of the above-listed copyright holders nor the names
     23  1.1  christos  *    of any contributors may be used to endorse or promote products derived
     24  1.1  christos  *    from this software without specific prior written permission.
     25  1.1  christos  *
     26  1.1  christos  * Alternatively, this software may be distributed under the terms of the
     27  1.1  christos  * GNU General Public License ("GPL") version 2 as published by the Free
     28  1.1  christos  * Software Foundation.
     29  1.1  christos  *
     30  1.1  christos  * NO WARRANTY
     31  1.1  christos  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32  1.1  christos  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33  1.1  christos  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
     34  1.1  christos  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35  1.1  christos  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36  1.1  christos  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37  1.1  christos  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38  1.1  christos  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39  1.1  christos  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40  1.1  christos  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41  1.1  christos  * POSSIBILITY OF SUCH DAMAGES.
     42  1.1  christos  */
     43  1.1  christos 
     44  1.1  christos 
     45  1.1  christos #define __UTXFINIT_C__
     46  1.1  christos #define EXPORT_ACPI_INTERFACES
     47  1.1  christos 
     48  1.1  christos #include "acpi.h"
     49  1.1  christos #include "accommon.h"
     50  1.1  christos #include "acevents.h"
     51  1.1  christos #include "acnamesp.h"
     52  1.1  christos #include "acdebug.h"
     53  1.1  christos #include "actables.h"
     54  1.1  christos 
     55  1.1  christos #define _COMPONENT          ACPI_UTILITIES
     56  1.1  christos         ACPI_MODULE_NAME    ("utxfinit")
     57  1.1  christos 
     58  1.1  christos 
     59  1.1  christos /*******************************************************************************
     60  1.1  christos  *
     61  1.1  christos  * FUNCTION:    AcpiInitializeSubsystem
     62  1.1  christos  *
     63  1.1  christos  * PARAMETERS:  None
     64  1.1  christos  *
     65  1.1  christos  * RETURN:      Status
     66  1.1  christos  *
     67  1.1  christos  * DESCRIPTION: Initializes all global variables. This is the first function
     68  1.1  christos  *              called, so any early initialization belongs here.
     69  1.1  christos  *
     70  1.1  christos  ******************************************************************************/
     71  1.1  christos 
     72  1.1  christos ACPI_STATUS
     73  1.1  christos AcpiInitializeSubsystem (
     74  1.1  christos     void)
     75  1.1  christos {
     76  1.1  christos     ACPI_STATUS             Status;
     77  1.1  christos 
     78  1.1  christos 
     79  1.1  christos     ACPI_FUNCTION_TRACE (AcpiInitializeSubsystem);
     80  1.1  christos 
     81  1.1  christos 
     82  1.1  christos     AcpiGbl_StartupFlags = ACPI_SUBSYSTEM_INITIALIZE;
     83  1.1  christos     ACPI_DEBUG_EXEC (AcpiUtInitStackPtrTrace ());
     84  1.1  christos 
     85  1.1  christos     /* Initialize the OS-Dependent layer */
     86  1.1  christos 
     87  1.1  christos     Status = AcpiOsInitialize ();
     88  1.1  christos     if (ACPI_FAILURE (Status))
     89  1.1  christos     {
     90  1.1  christos         ACPI_EXCEPTION ((AE_INFO, Status, "During OSL initialization"));
     91  1.1  christos         return_ACPI_STATUS (Status);
     92  1.1  christos     }
     93  1.1  christos 
     94  1.1  christos     /* Initialize all globals used by the subsystem */
     95  1.1  christos 
     96  1.1  christos     Status = AcpiUtInitGlobals ();
     97  1.1  christos     if (ACPI_FAILURE (Status))
     98  1.1  christos     {
     99  1.1  christos         ACPI_EXCEPTION ((AE_INFO, Status, "During initialization of globals"));
    100  1.1  christos         return_ACPI_STATUS (Status);
    101  1.1  christos     }
    102  1.1  christos 
    103  1.1  christos     /* Create the default mutex objects */
    104  1.1  christos 
    105  1.1  christos     Status = AcpiUtMutexInitialize ();
    106  1.1  christos     if (ACPI_FAILURE (Status))
    107  1.1  christos     {
    108  1.1  christos         ACPI_EXCEPTION ((AE_INFO, Status, "During Global Mutex creation"));
    109  1.1  christos         return_ACPI_STATUS (Status);
    110  1.1  christos     }
    111  1.1  christos 
    112  1.1  christos     /*
    113  1.1  christos      * Initialize the namespace manager and
    114  1.1  christos      * the root of the namespace tree
    115  1.1  christos      */
    116  1.1  christos     Status = AcpiNsRootInitialize ();
    117  1.1  christos     if (ACPI_FAILURE (Status))
    118  1.1  christos     {
    119  1.1  christos         ACPI_EXCEPTION ((AE_INFO, Status, "During Namespace initialization"));
    120  1.1  christos         return_ACPI_STATUS (Status);
    121  1.1  christos     }
    122  1.1  christos 
    123  1.1  christos     /* Initialize the global OSI interfaces list with the static names */
    124  1.1  christos 
    125  1.1  christos     Status = AcpiUtInitializeInterfaces ();
    126  1.1  christos     if (ACPI_FAILURE (Status))
    127  1.1  christos     {
    128  1.1  christos         ACPI_EXCEPTION ((AE_INFO, Status, "During OSI interfaces initialization"));
    129  1.1  christos         return_ACPI_STATUS (Status);
    130  1.1  christos     }
    131  1.1  christos 
    132  1.1  christos     /* If configured, initialize the AML debugger */
    133  1.1  christos 
    134  1.1  christos #ifdef ACPI_DEBUGGER
    135  1.1  christos     Status = AcpiDbInitialize ();
    136  1.1  christos     if (ACPI_FAILURE (Status))
    137  1.1  christos     {
    138  1.1  christos         ACPI_EXCEPTION ((AE_INFO, Status, "During Debugger initialization"));
    139  1.1  christos         return_ACPI_STATUS (Status);
    140  1.1  christos     }
    141  1.1  christos #endif
    142  1.1  christos 
    143  1.1  christos     return_ACPI_STATUS (AE_OK);
    144  1.1  christos }
    145  1.1  christos 
    146  1.1  christos ACPI_EXPORT_SYMBOL_INIT (AcpiInitializeSubsystem)
    147  1.1  christos 
    148  1.1  christos 
    149  1.1  christos /*******************************************************************************
    150  1.1  christos  *
    151  1.1  christos  * FUNCTION:    AcpiEnableSubsystem
    152  1.1  christos  *
    153  1.1  christos  * PARAMETERS:  Flags               - Init/enable Options
    154  1.1  christos  *
    155  1.1  christos  * RETURN:      Status
    156  1.1  christos  *
    157  1.1  christos  * DESCRIPTION: Completes the subsystem initialization including hardware.
    158  1.1  christos  *              Puts system into ACPI mode if it isn't already.
    159  1.1  christos  *
    160  1.1  christos  ******************************************************************************/
    161  1.1  christos 
    162  1.1  christos ACPI_STATUS
    163  1.1  christos AcpiEnableSubsystem (
    164  1.1  christos     UINT32                  Flags)
    165  1.1  christos {
    166  1.1  christos     ACPI_STATUS             Status = AE_OK;
    167  1.1  christos 
    168  1.1  christos 
    169  1.1  christos     ACPI_FUNCTION_TRACE (AcpiEnableSubsystem);
    170  1.1  christos 
    171  1.1  christos 
    172  1.1  christos #if (!ACPI_REDUCED_HARDWARE)
    173  1.1  christos 
    174  1.1  christos     /* Enable ACPI mode */
    175  1.1  christos 
    176  1.1  christos     if (!(Flags & ACPI_NO_ACPI_ENABLE))
    177  1.1  christos     {
    178  1.1  christos         ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Going into ACPI mode\n"));
    179  1.1  christos 
    180  1.1  christos         AcpiGbl_OriginalMode = AcpiHwGetMode();
    181  1.1  christos 
    182  1.1  christos         Status = AcpiEnable ();
    183  1.1  christos         if (ACPI_FAILURE (Status))
    184  1.1  christos         {
    185  1.1  christos             ACPI_WARNING ((AE_INFO, "AcpiEnable failed"));
    186  1.1  christos             return_ACPI_STATUS (Status);
    187  1.1  christos         }
    188  1.1  christos     }
    189  1.1  christos 
    190  1.1  christos     /*
    191  1.1  christos      * Obtain a permanent mapping for the FACS. This is required for the
    192  1.1  christos      * Global Lock and the Firmware Waking Vector
    193  1.1  christos      */
    194  1.1  christos     Status = AcpiTbInitializeFacs ();
    195  1.1  christos     if (ACPI_FAILURE (Status))
    196  1.1  christos     {
    197  1.1  christos         ACPI_WARNING ((AE_INFO, "Could not map the FACS table"));
    198  1.1  christos         return_ACPI_STATUS (Status);
    199  1.1  christos     }
    200  1.1  christos 
    201  1.1  christos #endif /* !ACPI_REDUCED_HARDWARE */
    202  1.1  christos 
    203  1.1  christos     /*
    204  1.1  christos      * Install the default OpRegion handlers. These are installed unless
    205  1.1  christos      * other handlers have already been installed via the
    206  1.1  christos      * InstallAddressSpaceHandler interface.
    207  1.1  christos      */
    208  1.1  christos     if (!(Flags & ACPI_NO_ADDRESS_SPACE_INIT))
    209  1.1  christos     {
    210  1.1  christos         ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
    211  1.1  christos             "[Init] Installing default address space handlers\n"));
    212  1.1  christos 
    213  1.1  christos         Status = AcpiEvInstallRegionHandlers ();
    214  1.1  christos         if (ACPI_FAILURE (Status))
    215  1.1  christos         {
    216  1.1  christos             return_ACPI_STATUS (Status);
    217  1.1  christos         }
    218  1.1  christos     }
    219  1.1  christos 
    220  1.1  christos #if (!ACPI_REDUCED_HARDWARE)
    221  1.1  christos     /*
    222  1.1  christos      * Initialize ACPI Event handling (Fixed and General Purpose)
    223  1.1  christos      *
    224  1.1  christos      * Note1: We must have the hardware and events initialized before we can
    225  1.1  christos      * execute any control methods safely. Any control method can require
    226  1.1  christos      * ACPI hardware support, so the hardware must be fully initialized before
    227  1.1  christos      * any method execution!
    228  1.1  christos      *
    229  1.1  christos      * Note2: Fixed events are initialized and enabled here. GPEs are
    230  1.1  christos      * initialized, but cannot be enabled until after the hardware is
    231  1.1  christos      * completely initialized (SCI and GlobalLock activated) and the various
    232  1.1  christos      * initialization control methods are run (_REG, _STA, _INI) on the
    233  1.1  christos      * entire namespace.
    234  1.1  christos      */
    235  1.1  christos     if (!(Flags & ACPI_NO_EVENT_INIT))
    236  1.1  christos     {
    237  1.1  christos         ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
    238  1.1  christos             "[Init] Initializing ACPI events\n"));
    239  1.1  christos 
    240  1.1  christos         Status = AcpiEvInitializeEvents ();
    241  1.1  christos         if (ACPI_FAILURE (Status))
    242  1.1  christos         {
    243  1.1  christos             return_ACPI_STATUS (Status);
    244  1.1  christos         }
    245  1.1  christos     }
    246  1.1  christos 
    247  1.1  christos     /*
    248  1.1  christos      * Install the SCI handler and Global Lock handler. This completes the
    249  1.1  christos      * hardware initialization.
    250  1.1  christos      */
    251  1.1  christos     if (!(Flags & ACPI_NO_HANDLER_INIT))
    252  1.1  christos     {
    253  1.1  christos         ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
    254  1.1  christos             "[Init] Installing SCI/GL handlers\n"));
    255  1.1  christos 
    256  1.1  christos         Status = AcpiEvInstallXruptHandlers ();
    257  1.1  christos         if (ACPI_FAILURE (Status))
    258  1.1  christos         {
    259  1.1  christos             return_ACPI_STATUS (Status);
    260  1.1  christos         }
    261  1.1  christos     }
    262  1.1  christos 
    263  1.1  christos #endif /* !ACPI_REDUCED_HARDWARE */
    264  1.1  christos 
    265  1.1  christos     return_ACPI_STATUS (Status);
    266  1.1  christos }
    267  1.1  christos 
    268  1.1  christos ACPI_EXPORT_SYMBOL_INIT (AcpiEnableSubsystem)
    269  1.1  christos 
    270  1.1  christos 
    271  1.1  christos /*******************************************************************************
    272  1.1  christos  *
    273  1.1  christos  * FUNCTION:    AcpiInitializeObjects
    274  1.1  christos  *
    275  1.1  christos  * PARAMETERS:  Flags               - Init/enable Options
    276  1.1  christos  *
    277  1.1  christos  * RETURN:      Status
    278  1.1  christos  *
    279  1.1  christos  * DESCRIPTION: Completes namespace initialization by initializing device
    280  1.1  christos  *              objects and executing AML code for Regions, buffers, etc.
    281  1.1  christos  *
    282  1.1  christos  ******************************************************************************/
    283  1.1  christos 
    284  1.1  christos ACPI_STATUS
    285  1.1  christos AcpiInitializeObjects (
    286  1.1  christos     UINT32                  Flags)
    287  1.1  christos {
    288  1.1  christos     ACPI_STATUS             Status = AE_OK;
    289  1.1  christos 
    290  1.1  christos 
    291  1.1  christos     ACPI_FUNCTION_TRACE (AcpiInitializeObjects);
    292  1.1  christos 
    293  1.1  christos 
    294  1.1  christos     /*
    295  1.1  christos      * Run all _REG methods
    296  1.1  christos      *
    297  1.1  christos      * Note: Any objects accessed by the _REG methods will be automatically
    298  1.1  christos      * initialized, even if they contain executable AML (see the call to
    299  1.1  christos      * AcpiNsInitializeObjects below).
    300  1.1  christos      */
    301  1.1  christos     if (!(Flags & ACPI_NO_ADDRESS_SPACE_INIT))
    302  1.1  christos     {
    303  1.1  christos         ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
    304  1.1  christos             "[Init] Executing _REG OpRegion methods\n"));
    305  1.1  christos 
    306  1.1  christos         Status = AcpiEvInitializeOpRegions ();
    307  1.1  christos         if (ACPI_FAILURE (Status))
    308  1.1  christos         {
    309  1.1  christos             return_ACPI_STATUS (Status);
    310  1.1  christos         }
    311  1.1  christos     }
    312  1.1  christos 
    313  1.1  christos     /*
    314  1.1  christos      * Execute any module-level code that was detected during the table load
    315  1.1  christos      * phase. Although illegal since ACPI 2.0, there are many machines that
    316  1.1  christos      * contain this type of code. Each block of detected executable AML code
    317  1.1  christos      * outside of any control method is wrapped with a temporary control
    318  1.1  christos      * method object and placed on a global list. The methods on this list
    319  1.1  christos      * are executed below.
    320  1.1  christos      */
    321  1.1  christos     AcpiNsExecModuleCodeList ();
    322  1.1  christos 
    323  1.1  christos     /*
    324  1.1  christos      * Initialize the objects that remain uninitialized. This runs the
    325  1.1  christos      * executable AML that may be part of the declaration of these objects:
    326  1.1  christos      * OperationRegions, BufferFields, Buffers, and Packages.
    327  1.1  christos      */
    328  1.1  christos     if (!(Flags & ACPI_NO_OBJECT_INIT))
    329  1.1  christos     {
    330  1.1  christos         ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
    331  1.1  christos             "[Init] Completing Initialization of ACPI Objects\n"));
    332  1.1  christos 
    333  1.1  christos         Status = AcpiNsInitializeObjects ();
    334  1.1  christos         if (ACPI_FAILURE (Status))
    335  1.1  christos         {
    336  1.1  christos             return_ACPI_STATUS (Status);
    337  1.1  christos         }
    338  1.1  christos     }
    339  1.1  christos 
    340  1.1  christos     /*
    341  1.1  christos      * Initialize all device objects in the namespace. This runs the device
    342  1.1  christos      * _STA and _INI methods.
    343  1.1  christos      */
    344  1.1  christos     if (!(Flags & ACPI_NO_DEVICE_INIT))
    345  1.1  christos     {
    346  1.1  christos         ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
    347  1.1  christos             "[Init] Initializing ACPI Devices\n"));
    348  1.1  christos 
    349  1.1  christos         Status = AcpiNsInitializeDevices ();
    350  1.1  christos         if (ACPI_FAILURE (Status))
    351  1.1  christos         {
    352  1.1  christos             return_ACPI_STATUS (Status);
    353  1.1  christos         }
    354  1.1  christos     }
    355  1.1  christos 
    356  1.1  christos     /*
    357  1.1  christos      * Empty the caches (delete the cached objects) on the assumption that
    358  1.1  christos      * the table load filled them up more than they will be at runtime --
    359  1.1  christos      * thus wasting non-paged memory.
    360  1.1  christos      */
    361  1.1  christos     Status = AcpiPurgeCachedObjects ();
    362  1.1  christos 
    363  1.1  christos     AcpiGbl_StartupFlags |= ACPI_INITIALIZED_OK;
    364  1.1  christos     return_ACPI_STATUS (Status);
    365  1.1  christos }
    366  1.1  christos 
    367  1.1  christos ACPI_EXPORT_SYMBOL_INIT (AcpiInitializeObjects)
    368