Home | History | Annotate | Line # | Download | only in events
evgpe.c revision 1.1.1.2.8.2
      1  1.1.1.2.8.2  jruoho /******************************************************************************
      2  1.1.1.2.8.2  jruoho  *
      3  1.1.1.2.8.2  jruoho  * Module Name: evgpe - General Purpose Event handling and dispatch
      4  1.1.1.2.8.2  jruoho  *
      5  1.1.1.2.8.2  jruoho  *****************************************************************************/
      6  1.1.1.2.8.2  jruoho 
      7  1.1.1.2.8.2  jruoho /*
      8  1.1.1.2.8.2  jruoho  * Copyright (C) 2000 - 2011, Intel Corp.
      9  1.1.1.2.8.2  jruoho  * All rights reserved.
     10  1.1.1.2.8.2  jruoho  *
     11  1.1.1.2.8.2  jruoho  * Redistribution and use in source and binary forms, with or without
     12  1.1.1.2.8.2  jruoho  * modification, are permitted provided that the following conditions
     13  1.1.1.2.8.2  jruoho  * are met:
     14  1.1.1.2.8.2  jruoho  * 1. Redistributions of source code must retain the above copyright
     15  1.1.1.2.8.2  jruoho  *    notice, this list of conditions, and the following disclaimer,
     16  1.1.1.2.8.2  jruoho  *    without modification.
     17  1.1.1.2.8.2  jruoho  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18  1.1.1.2.8.2  jruoho  *    substantially similar to the "NO WARRANTY" disclaimer below
     19  1.1.1.2.8.2  jruoho  *    ("Disclaimer") and any redistribution must be conditioned upon
     20  1.1.1.2.8.2  jruoho  *    including a substantially similar Disclaimer requirement for further
     21  1.1.1.2.8.2  jruoho  *    binary redistribution.
     22  1.1.1.2.8.2  jruoho  * 3. Neither the names of the above-listed copyright holders nor the names
     23  1.1.1.2.8.2  jruoho  *    of any contributors may be used to endorse or promote products derived
     24  1.1.1.2.8.2  jruoho  *    from this software without specific prior written permission.
     25  1.1.1.2.8.2  jruoho  *
     26  1.1.1.2.8.2  jruoho  * Alternatively, this software may be distributed under the terms of the
     27  1.1.1.2.8.2  jruoho  * GNU General Public License ("GPL") version 2 as published by the Free
     28  1.1.1.2.8.2  jruoho  * Software Foundation.
     29  1.1.1.2.8.2  jruoho  *
     30  1.1.1.2.8.2  jruoho  * NO WARRANTY
     31  1.1.1.2.8.2  jruoho  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32  1.1.1.2.8.2  jruoho  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33  1.1.1.2.8.2  jruoho  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
     34  1.1.1.2.8.2  jruoho  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35  1.1.1.2.8.2  jruoho  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36  1.1.1.2.8.2  jruoho  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37  1.1.1.2.8.2  jruoho  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38  1.1.1.2.8.2  jruoho  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39  1.1.1.2.8.2  jruoho  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40  1.1.1.2.8.2  jruoho  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41  1.1.1.2.8.2  jruoho  * POSSIBILITY OF SUCH DAMAGES.
     42  1.1.1.2.8.2  jruoho  */
     43  1.1.1.2.8.2  jruoho 
     44  1.1.1.2.8.2  jruoho #include "acpi.h"
     45  1.1.1.2.8.2  jruoho #include "accommon.h"
     46  1.1.1.2.8.2  jruoho #include "acevents.h"
     47  1.1.1.2.8.2  jruoho #include "acnamesp.h"
     48  1.1.1.2.8.2  jruoho 
     49  1.1.1.2.8.2  jruoho #define _COMPONENT          ACPI_EVENTS
     50  1.1.1.2.8.2  jruoho         ACPI_MODULE_NAME    ("evgpe")
     51  1.1.1.2.8.2  jruoho 
     52  1.1.1.2.8.2  jruoho /* Local prototypes */
     53  1.1.1.2.8.2  jruoho 
     54  1.1.1.2.8.2  jruoho static void ACPI_SYSTEM_XFACE
     55  1.1.1.2.8.2  jruoho AcpiEvAsynchExecuteGpeMethod (
     56  1.1.1.2.8.2  jruoho     void                    *Context);
     57  1.1.1.2.8.2  jruoho 
     58  1.1.1.2.8.2  jruoho static void ACPI_SYSTEM_XFACE
     59  1.1.1.2.8.2  jruoho AcpiEvAsynchEnableGpe (
     60  1.1.1.2.8.2  jruoho     void                    *Context);
     61  1.1.1.2.8.2  jruoho 
     62  1.1.1.2.8.2  jruoho 
     63  1.1.1.2.8.2  jruoho /*******************************************************************************
     64  1.1.1.2.8.2  jruoho  *
     65  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiEvUpdateGpeEnableMask
     66  1.1.1.2.8.2  jruoho  *
     67  1.1.1.2.8.2  jruoho  * PARAMETERS:  GpeEventInfo            - GPE to update
     68  1.1.1.2.8.2  jruoho  *
     69  1.1.1.2.8.2  jruoho  * RETURN:      Status
     70  1.1.1.2.8.2  jruoho  *
     71  1.1.1.2.8.2  jruoho  * DESCRIPTION: Updates GPE register enable mask based upon whether there are
     72  1.1.1.2.8.2  jruoho  *              runtime references to this GPE
     73  1.1.1.2.8.2  jruoho  *
     74  1.1.1.2.8.2  jruoho  ******************************************************************************/
     75  1.1.1.2.8.2  jruoho 
     76  1.1.1.2.8.2  jruoho ACPI_STATUS
     77  1.1.1.2.8.2  jruoho AcpiEvUpdateGpeEnableMask (
     78  1.1.1.2.8.2  jruoho     ACPI_GPE_EVENT_INFO     *GpeEventInfo)
     79  1.1.1.2.8.2  jruoho {
     80  1.1.1.2.8.2  jruoho     ACPI_GPE_REGISTER_INFO  *GpeRegisterInfo;
     81  1.1.1.2.8.2  jruoho     UINT32                  RegisterBit;
     82  1.1.1.2.8.2  jruoho 
     83  1.1.1.2.8.2  jruoho 
     84  1.1.1.2.8.2  jruoho     ACPI_FUNCTION_TRACE (EvUpdateGpeEnableMask);
     85  1.1.1.2.8.2  jruoho 
     86  1.1.1.2.8.2  jruoho 
     87  1.1.1.2.8.2  jruoho     GpeRegisterInfo = GpeEventInfo->RegisterInfo;
     88  1.1.1.2.8.2  jruoho     if (!GpeRegisterInfo)
     89  1.1.1.2.8.2  jruoho     {
     90  1.1.1.2.8.2  jruoho         return_ACPI_STATUS (AE_NOT_EXIST);
     91  1.1.1.2.8.2  jruoho     }
     92  1.1.1.2.8.2  jruoho 
     93  1.1.1.2.8.2  jruoho     RegisterBit = AcpiHwGetGpeRegisterBit (GpeEventInfo, GpeRegisterInfo);
     94  1.1.1.2.8.2  jruoho 
     95  1.1.1.2.8.2  jruoho     /* Clear the run bit up front */
     96  1.1.1.2.8.2  jruoho 
     97  1.1.1.2.8.2  jruoho     ACPI_CLEAR_BIT (GpeRegisterInfo->EnableForRun, RegisterBit);
     98  1.1.1.2.8.2  jruoho 
     99  1.1.1.2.8.2  jruoho     /* Set the mask bit only if there are references to this GPE */
    100  1.1.1.2.8.2  jruoho 
    101  1.1.1.2.8.2  jruoho     if (GpeEventInfo->RuntimeCount)
    102  1.1.1.2.8.2  jruoho     {
    103  1.1.1.2.8.2  jruoho         ACPI_SET_BIT (GpeRegisterInfo->EnableForRun, (UINT8) RegisterBit);
    104  1.1.1.2.8.2  jruoho     }
    105  1.1.1.2.8.2  jruoho 
    106  1.1.1.2.8.2  jruoho     return_ACPI_STATUS (AE_OK);
    107  1.1.1.2.8.2  jruoho }
    108  1.1.1.2.8.2  jruoho 
    109  1.1.1.2.8.2  jruoho 
    110  1.1.1.2.8.2  jruoho /*******************************************************************************
    111  1.1.1.2.8.2  jruoho  *
    112  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiEvEnableGpe
    113  1.1.1.2.8.2  jruoho  *
    114  1.1.1.2.8.2  jruoho  * PARAMETERS:  GpeEventInfo            - GPE to enable
    115  1.1.1.2.8.2  jruoho  *
    116  1.1.1.2.8.2  jruoho  * RETURN:      Status
    117  1.1.1.2.8.2  jruoho  *
    118  1.1.1.2.8.2  jruoho  * DESCRIPTION: Clear a GPE of stale events and enable it.
    119  1.1.1.2.8.2  jruoho  *
    120  1.1.1.2.8.2  jruoho  ******************************************************************************/
    121  1.1.1.2.8.2  jruoho 
    122  1.1.1.2.8.2  jruoho ACPI_STATUS
    123  1.1.1.2.8.2  jruoho AcpiEvEnableGpe (
    124  1.1.1.2.8.2  jruoho     ACPI_GPE_EVENT_INFO     *GpeEventInfo)
    125  1.1.1.2.8.2  jruoho {
    126  1.1.1.2.8.2  jruoho     ACPI_STATUS             Status;
    127  1.1.1.2.8.2  jruoho 
    128  1.1.1.2.8.2  jruoho 
    129  1.1.1.2.8.2  jruoho     ACPI_FUNCTION_TRACE (EvEnableGpe);
    130  1.1.1.2.8.2  jruoho 
    131  1.1.1.2.8.2  jruoho 
    132  1.1.1.2.8.2  jruoho     /*
    133  1.1.1.2.8.2  jruoho      * We will only allow a GPE to be enabled if it has either an associated
    134  1.1.1.2.8.2  jruoho      * method (_Lxx/_Exx) or a handler, or is using the implicit notify
    135  1.1.1.2.8.2  jruoho      * feature. Otherwise, the GPE will be immediately disabled by
    136  1.1.1.2.8.2  jruoho      * AcpiEvGpeDispatch the first time it fires.
    137  1.1.1.2.8.2  jruoho      */
    138  1.1.1.2.8.2  jruoho     if ((GpeEventInfo->Flags & ACPI_GPE_DISPATCH_MASK) ==
    139  1.1.1.2.8.2  jruoho         ACPI_GPE_DISPATCH_NONE)
    140  1.1.1.2.8.2  jruoho     {
    141  1.1.1.2.8.2  jruoho         return_ACPI_STATUS (AE_NO_HANDLER);
    142  1.1.1.2.8.2  jruoho     }
    143  1.1.1.2.8.2  jruoho 
    144  1.1.1.2.8.2  jruoho     /* Clear the GPE (of stale events) */
    145  1.1.1.2.8.2  jruoho 
    146  1.1.1.2.8.2  jruoho     Status = AcpiHwClearGpe (GpeEventInfo);
    147  1.1.1.2.8.2  jruoho     if (ACPI_FAILURE (Status))
    148  1.1.1.2.8.2  jruoho     {
    149  1.1.1.2.8.2  jruoho         return_ACPI_STATUS (Status);
    150  1.1.1.2.8.2  jruoho     }
    151  1.1.1.2.8.2  jruoho 
    152  1.1.1.2.8.2  jruoho     /* Enable the requested GPE */
    153  1.1.1.2.8.2  jruoho 
    154  1.1.1.2.8.2  jruoho     Status = AcpiHwLowSetGpe (GpeEventInfo, ACPI_GPE_ENABLE);
    155  1.1.1.2.8.2  jruoho     return_ACPI_STATUS (Status);
    156  1.1.1.2.8.2  jruoho }
    157  1.1.1.2.8.2  jruoho 
    158  1.1.1.2.8.2  jruoho 
    159  1.1.1.2.8.2  jruoho /*******************************************************************************
    160  1.1.1.2.8.2  jruoho  *
    161  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiEvAddGpeReference
    162  1.1.1.2.8.2  jruoho  *
    163  1.1.1.2.8.2  jruoho  * PARAMETERS:  GpeEventInfo            - Add a reference to this GPE
    164  1.1.1.2.8.2  jruoho  *
    165  1.1.1.2.8.2  jruoho  * RETURN:      Status
    166  1.1.1.2.8.2  jruoho  *
    167  1.1.1.2.8.2  jruoho  * DESCRIPTION: Add a reference to a GPE. On the first reference, the GPE is
    168  1.1.1.2.8.2  jruoho  *              hardware-enabled.
    169  1.1.1.2.8.2  jruoho  *
    170  1.1.1.2.8.2  jruoho  ******************************************************************************/
    171  1.1.1.2.8.2  jruoho 
    172  1.1.1.2.8.2  jruoho ACPI_STATUS
    173  1.1.1.2.8.2  jruoho AcpiEvAddGpeReference (
    174  1.1.1.2.8.2  jruoho     ACPI_GPE_EVENT_INFO     *GpeEventInfo)
    175  1.1.1.2.8.2  jruoho {
    176  1.1.1.2.8.2  jruoho     ACPI_STATUS             Status = AE_OK;
    177  1.1.1.2.8.2  jruoho 
    178  1.1.1.2.8.2  jruoho 
    179  1.1.1.2.8.2  jruoho     ACPI_FUNCTION_TRACE (EvAddGpeReference);
    180  1.1.1.2.8.2  jruoho 
    181  1.1.1.2.8.2  jruoho 
    182  1.1.1.2.8.2  jruoho     if (GpeEventInfo->RuntimeCount == ACPI_UINT8_MAX)
    183  1.1.1.2.8.2  jruoho     {
    184  1.1.1.2.8.2  jruoho         return_ACPI_STATUS (AE_LIMIT);
    185  1.1.1.2.8.2  jruoho     }
    186  1.1.1.2.8.2  jruoho 
    187  1.1.1.2.8.2  jruoho     GpeEventInfo->RuntimeCount++;
    188  1.1.1.2.8.2  jruoho     if (GpeEventInfo->RuntimeCount == 1)
    189  1.1.1.2.8.2  jruoho     {
    190  1.1.1.2.8.2  jruoho         /* Enable on first reference */
    191  1.1.1.2.8.2  jruoho 
    192  1.1.1.2.8.2  jruoho         Status = AcpiEvUpdateGpeEnableMask (GpeEventInfo);
    193  1.1.1.2.8.2  jruoho         if (ACPI_SUCCESS (Status))
    194  1.1.1.2.8.2  jruoho         {
    195  1.1.1.2.8.2  jruoho             Status = AcpiEvEnableGpe (GpeEventInfo);
    196  1.1.1.2.8.2  jruoho         }
    197  1.1.1.2.8.2  jruoho 
    198  1.1.1.2.8.2  jruoho         if (ACPI_FAILURE (Status))
    199  1.1.1.2.8.2  jruoho         {
    200  1.1.1.2.8.2  jruoho             GpeEventInfo->RuntimeCount--;
    201  1.1.1.2.8.2  jruoho         }
    202  1.1.1.2.8.2  jruoho     }
    203  1.1.1.2.8.2  jruoho 
    204  1.1.1.2.8.2  jruoho     return_ACPI_STATUS (Status);
    205  1.1.1.2.8.2  jruoho }
    206  1.1.1.2.8.2  jruoho 
    207  1.1.1.2.8.2  jruoho 
    208  1.1.1.2.8.2  jruoho /*******************************************************************************
    209  1.1.1.2.8.2  jruoho  *
    210  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiEvRemoveGpeReference
    211  1.1.1.2.8.2  jruoho  *
    212  1.1.1.2.8.2  jruoho  * PARAMETERS:  GpeEventInfo            - Remove a reference to this GPE
    213  1.1.1.2.8.2  jruoho  *
    214  1.1.1.2.8.2  jruoho  * RETURN:      Status
    215  1.1.1.2.8.2  jruoho  *
    216  1.1.1.2.8.2  jruoho  * DESCRIPTION: Remove a reference to a GPE. When the last reference is
    217  1.1.1.2.8.2  jruoho  *              removed, the GPE is hardware-disabled.
    218  1.1.1.2.8.2  jruoho  *
    219  1.1.1.2.8.2  jruoho  ******************************************************************************/
    220  1.1.1.2.8.2  jruoho 
    221  1.1.1.2.8.2  jruoho ACPI_STATUS
    222  1.1.1.2.8.2  jruoho AcpiEvRemoveGpeReference (
    223  1.1.1.2.8.2  jruoho     ACPI_GPE_EVENT_INFO     *GpeEventInfo)
    224  1.1.1.2.8.2  jruoho {
    225  1.1.1.2.8.2  jruoho     ACPI_STATUS             Status = AE_OK;
    226  1.1.1.2.8.2  jruoho 
    227  1.1.1.2.8.2  jruoho 
    228  1.1.1.2.8.2  jruoho     ACPI_FUNCTION_TRACE (EvRemoveGpeReference);
    229  1.1.1.2.8.2  jruoho 
    230  1.1.1.2.8.2  jruoho 
    231  1.1.1.2.8.2  jruoho     if (!GpeEventInfo->RuntimeCount)
    232  1.1.1.2.8.2  jruoho     {
    233  1.1.1.2.8.2  jruoho         return_ACPI_STATUS (AE_LIMIT);
    234  1.1.1.2.8.2  jruoho     }
    235  1.1.1.2.8.2  jruoho 
    236  1.1.1.2.8.2  jruoho     GpeEventInfo->RuntimeCount--;
    237  1.1.1.2.8.2  jruoho     if (!GpeEventInfo->RuntimeCount)
    238  1.1.1.2.8.2  jruoho     {
    239  1.1.1.2.8.2  jruoho         /* Disable on last reference */
    240  1.1.1.2.8.2  jruoho 
    241  1.1.1.2.8.2  jruoho         Status = AcpiEvUpdateGpeEnableMask (GpeEventInfo);
    242  1.1.1.2.8.2  jruoho         if (ACPI_SUCCESS (Status))
    243  1.1.1.2.8.2  jruoho         {
    244  1.1.1.2.8.2  jruoho             Status = AcpiHwLowSetGpe (GpeEventInfo, ACPI_GPE_DISABLE);
    245  1.1.1.2.8.2  jruoho         }
    246  1.1.1.2.8.2  jruoho 
    247  1.1.1.2.8.2  jruoho         if (ACPI_FAILURE (Status))
    248  1.1.1.2.8.2  jruoho         {
    249  1.1.1.2.8.2  jruoho             GpeEventInfo->RuntimeCount++;
    250  1.1.1.2.8.2  jruoho         }
    251  1.1.1.2.8.2  jruoho     }
    252  1.1.1.2.8.2  jruoho 
    253  1.1.1.2.8.2  jruoho     return_ACPI_STATUS (Status);
    254  1.1.1.2.8.2  jruoho }
    255  1.1.1.2.8.2  jruoho 
    256  1.1.1.2.8.2  jruoho 
    257  1.1.1.2.8.2  jruoho /*******************************************************************************
    258  1.1.1.2.8.2  jruoho  *
    259  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiEvLowGetGpeInfo
    260  1.1.1.2.8.2  jruoho  *
    261  1.1.1.2.8.2  jruoho  * PARAMETERS:  GpeNumber           - Raw GPE number
    262  1.1.1.2.8.2  jruoho  *              GpeBlock            - A GPE info block
    263  1.1.1.2.8.2  jruoho  *
    264  1.1.1.2.8.2  jruoho  * RETURN:      A GPE EventInfo struct. NULL if not a valid GPE (The GpeNumber
    265  1.1.1.2.8.2  jruoho  *              is not within the specified GPE block)
    266  1.1.1.2.8.2  jruoho  *
    267  1.1.1.2.8.2  jruoho  * DESCRIPTION: Returns the EventInfo struct associated with this GPE. This is
    268  1.1.1.2.8.2  jruoho  *              the low-level implementation of EvGetGpeEventInfo.
    269  1.1.1.2.8.2  jruoho  *
    270  1.1.1.2.8.2  jruoho  ******************************************************************************/
    271  1.1.1.2.8.2  jruoho 
    272  1.1.1.2.8.2  jruoho ACPI_GPE_EVENT_INFO *
    273  1.1.1.2.8.2  jruoho AcpiEvLowGetGpeInfo (
    274  1.1.1.2.8.2  jruoho     UINT32                  GpeNumber,
    275  1.1.1.2.8.2  jruoho     ACPI_GPE_BLOCK_INFO     *GpeBlock)
    276  1.1.1.2.8.2  jruoho {
    277  1.1.1.2.8.2  jruoho     UINT32                  GpeIndex;
    278  1.1.1.2.8.2  jruoho 
    279  1.1.1.2.8.2  jruoho 
    280  1.1.1.2.8.2  jruoho     /*
    281  1.1.1.2.8.2  jruoho      * Validate that the GpeNumber is within the specified GpeBlock.
    282  1.1.1.2.8.2  jruoho      * (Two steps)
    283  1.1.1.2.8.2  jruoho      */
    284  1.1.1.2.8.2  jruoho     if (!GpeBlock ||
    285  1.1.1.2.8.2  jruoho         (GpeNumber < GpeBlock->BlockBaseNumber))
    286  1.1.1.2.8.2  jruoho     {
    287  1.1.1.2.8.2  jruoho         return (NULL);
    288  1.1.1.2.8.2  jruoho     }
    289  1.1.1.2.8.2  jruoho 
    290  1.1.1.2.8.2  jruoho     GpeIndex = GpeNumber - GpeBlock->BlockBaseNumber;
    291  1.1.1.2.8.2  jruoho     if (GpeIndex >= GpeBlock->GpeCount)
    292  1.1.1.2.8.2  jruoho     {
    293  1.1.1.2.8.2  jruoho         return (NULL);
    294  1.1.1.2.8.2  jruoho     }
    295  1.1.1.2.8.2  jruoho 
    296  1.1.1.2.8.2  jruoho     return (&GpeBlock->EventInfo[GpeIndex]);
    297  1.1.1.2.8.2  jruoho }
    298  1.1.1.2.8.2  jruoho 
    299  1.1.1.2.8.2  jruoho 
    300  1.1.1.2.8.2  jruoho /*******************************************************************************
    301  1.1.1.2.8.2  jruoho  *
    302  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiEvGetGpeEventInfo
    303  1.1.1.2.8.2  jruoho  *
    304  1.1.1.2.8.2  jruoho  * PARAMETERS:  GpeDevice           - Device node. NULL for GPE0/GPE1
    305  1.1.1.2.8.2  jruoho  *              GpeNumber           - Raw GPE number
    306  1.1.1.2.8.2  jruoho  *
    307  1.1.1.2.8.2  jruoho  * RETURN:      A GPE EventInfo struct. NULL if not a valid GPE
    308  1.1.1.2.8.2  jruoho  *
    309  1.1.1.2.8.2  jruoho  * DESCRIPTION: Returns the EventInfo struct associated with this GPE.
    310  1.1.1.2.8.2  jruoho  *              Validates the GpeBlock and the GpeNumber
    311  1.1.1.2.8.2  jruoho  *
    312  1.1.1.2.8.2  jruoho  *              Should be called only when the GPE lists are semaphore locked
    313  1.1.1.2.8.2  jruoho  *              and not subject to change.
    314  1.1.1.2.8.2  jruoho  *
    315  1.1.1.2.8.2  jruoho  ******************************************************************************/
    316  1.1.1.2.8.2  jruoho 
    317  1.1.1.2.8.2  jruoho ACPI_GPE_EVENT_INFO *
    318  1.1.1.2.8.2  jruoho AcpiEvGetGpeEventInfo (
    319  1.1.1.2.8.2  jruoho     ACPI_HANDLE             GpeDevice,
    320  1.1.1.2.8.2  jruoho     UINT32                  GpeNumber)
    321  1.1.1.2.8.2  jruoho {
    322  1.1.1.2.8.2  jruoho     ACPI_OPERAND_OBJECT     *ObjDesc;
    323  1.1.1.2.8.2  jruoho     ACPI_GPE_EVENT_INFO     *GpeInfo;
    324  1.1.1.2.8.2  jruoho     UINT32                  i;
    325  1.1.1.2.8.2  jruoho 
    326  1.1.1.2.8.2  jruoho 
    327  1.1.1.2.8.2  jruoho     ACPI_FUNCTION_ENTRY ();
    328  1.1.1.2.8.2  jruoho 
    329  1.1.1.2.8.2  jruoho 
    330  1.1.1.2.8.2  jruoho     /* A NULL GpeDevice means use the FADT-defined GPE block(s) */
    331  1.1.1.2.8.2  jruoho 
    332  1.1.1.2.8.2  jruoho     if (!GpeDevice)
    333  1.1.1.2.8.2  jruoho     {
    334  1.1.1.2.8.2  jruoho         /* Examine GPE Block 0 and 1 (These blocks are permanent) */
    335  1.1.1.2.8.2  jruoho 
    336  1.1.1.2.8.2  jruoho         for (i = 0; i < ACPI_MAX_GPE_BLOCKS; i++)
    337  1.1.1.2.8.2  jruoho         {
    338  1.1.1.2.8.2  jruoho             GpeInfo = AcpiEvLowGetGpeInfo (GpeNumber,
    339  1.1.1.2.8.2  jruoho                         AcpiGbl_GpeFadtBlocks[i]);
    340  1.1.1.2.8.2  jruoho             if (GpeInfo)
    341  1.1.1.2.8.2  jruoho             {
    342  1.1.1.2.8.2  jruoho                 return (GpeInfo);
    343  1.1.1.2.8.2  jruoho             }
    344  1.1.1.2.8.2  jruoho         }
    345  1.1.1.2.8.2  jruoho 
    346  1.1.1.2.8.2  jruoho         /* The GpeNumber was not in the range of either FADT GPE block */
    347  1.1.1.2.8.2  jruoho 
    348  1.1.1.2.8.2  jruoho         return (NULL);
    349  1.1.1.2.8.2  jruoho     }
    350  1.1.1.2.8.2  jruoho 
    351  1.1.1.2.8.2  jruoho     /* A Non-NULL GpeDevice means this is a GPE Block Device */
    352  1.1.1.2.8.2  jruoho 
    353  1.1.1.2.8.2  jruoho     ObjDesc = AcpiNsGetAttachedObject ((ACPI_NAMESPACE_NODE *) GpeDevice);
    354  1.1.1.2.8.2  jruoho     if (!ObjDesc ||
    355  1.1.1.2.8.2  jruoho         !ObjDesc->Device.GpeBlock)
    356  1.1.1.2.8.2  jruoho     {
    357  1.1.1.2.8.2  jruoho         return (NULL);
    358  1.1.1.2.8.2  jruoho     }
    359  1.1.1.2.8.2  jruoho 
    360  1.1.1.2.8.2  jruoho     return (AcpiEvLowGetGpeInfo (GpeNumber, ObjDesc->Device.GpeBlock));
    361  1.1.1.2.8.2  jruoho }
    362  1.1.1.2.8.2  jruoho 
    363  1.1.1.2.8.2  jruoho 
    364  1.1.1.2.8.2  jruoho /*******************************************************************************
    365  1.1.1.2.8.2  jruoho  *
    366  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiEvGpeDetect
    367  1.1.1.2.8.2  jruoho  *
    368  1.1.1.2.8.2  jruoho  * PARAMETERS:  GpeXruptList        - Interrupt block for this interrupt.
    369  1.1.1.2.8.2  jruoho  *                                    Can have multiple GPE blocks attached.
    370  1.1.1.2.8.2  jruoho  *
    371  1.1.1.2.8.2  jruoho  * RETURN:      INTERRUPT_HANDLED or INTERRUPT_NOT_HANDLED
    372  1.1.1.2.8.2  jruoho  *
    373  1.1.1.2.8.2  jruoho  * DESCRIPTION: Detect if any GP events have occurred. This function is
    374  1.1.1.2.8.2  jruoho  *              executed at interrupt level.
    375  1.1.1.2.8.2  jruoho  *
    376  1.1.1.2.8.2  jruoho  ******************************************************************************/
    377  1.1.1.2.8.2  jruoho 
    378  1.1.1.2.8.2  jruoho UINT32
    379  1.1.1.2.8.2  jruoho AcpiEvGpeDetect (
    380  1.1.1.2.8.2  jruoho     ACPI_GPE_XRUPT_INFO     *GpeXruptList)
    381  1.1.1.2.8.2  jruoho {
    382  1.1.1.2.8.2  jruoho     ACPI_STATUS             Status;
    383  1.1.1.2.8.2  jruoho     ACPI_GPE_BLOCK_INFO     *GpeBlock;
    384  1.1.1.2.8.2  jruoho     ACPI_GPE_REGISTER_INFO  *GpeRegisterInfo;
    385  1.1.1.2.8.2  jruoho     UINT32                  IntStatus = ACPI_INTERRUPT_NOT_HANDLED;
    386  1.1.1.2.8.2  jruoho     UINT8                   EnabledStatusByte;
    387  1.1.1.2.8.2  jruoho     UINT32                  StatusReg;
    388  1.1.1.2.8.2  jruoho     UINT32                  EnableReg;
    389  1.1.1.2.8.2  jruoho     ACPI_CPU_FLAGS          Flags;
    390  1.1.1.2.8.2  jruoho     UINT32                  i;
    391  1.1.1.2.8.2  jruoho     UINT32                  j;
    392  1.1.1.2.8.2  jruoho 
    393  1.1.1.2.8.2  jruoho 
    394  1.1.1.2.8.2  jruoho     ACPI_FUNCTION_NAME (EvGpeDetect);
    395  1.1.1.2.8.2  jruoho 
    396  1.1.1.2.8.2  jruoho     /* Check for the case where there are no GPEs */
    397  1.1.1.2.8.2  jruoho 
    398  1.1.1.2.8.2  jruoho     if (!GpeXruptList)
    399  1.1.1.2.8.2  jruoho     {
    400  1.1.1.2.8.2  jruoho         return (IntStatus);
    401  1.1.1.2.8.2  jruoho     }
    402  1.1.1.2.8.2  jruoho 
    403  1.1.1.2.8.2  jruoho     /*
    404  1.1.1.2.8.2  jruoho      * We need to obtain the GPE lock for both the data structs and registers
    405  1.1.1.2.8.2  jruoho      * Note: Not necessary to obtain the hardware lock, since the GPE
    406  1.1.1.2.8.2  jruoho      * registers are owned by the GpeLock.
    407  1.1.1.2.8.2  jruoho      */
    408  1.1.1.2.8.2  jruoho     Flags = AcpiOsAcquireLock (AcpiGbl_GpeLock);
    409  1.1.1.2.8.2  jruoho 
    410  1.1.1.2.8.2  jruoho     /* Examine all GPE blocks attached to this interrupt level */
    411  1.1.1.2.8.2  jruoho 
    412  1.1.1.2.8.2  jruoho     GpeBlock = GpeXruptList->GpeBlockListHead;
    413  1.1.1.2.8.2  jruoho     while (GpeBlock)
    414  1.1.1.2.8.2  jruoho     {
    415  1.1.1.2.8.2  jruoho         /*
    416  1.1.1.2.8.2  jruoho          * Read all of the 8-bit GPE status and enable registers in this GPE
    417  1.1.1.2.8.2  jruoho          * block, saving all of them. Find all currently active GP events.
    418  1.1.1.2.8.2  jruoho          */
    419  1.1.1.2.8.2  jruoho         for (i = 0; i < GpeBlock->RegisterCount; i++)
    420  1.1.1.2.8.2  jruoho         {
    421  1.1.1.2.8.2  jruoho             /* Get the next status/enable pair */
    422  1.1.1.2.8.2  jruoho 
    423  1.1.1.2.8.2  jruoho             GpeRegisterInfo = &GpeBlock->RegisterInfo[i];
    424  1.1.1.2.8.2  jruoho 
    425  1.1.1.2.8.2  jruoho             /*
    426  1.1.1.2.8.2  jruoho              * Optimization: If there are no GPEs enabled within this
    427  1.1.1.2.8.2  jruoho              * register, we can safely ignore the entire register.
    428  1.1.1.2.8.2  jruoho              */
    429  1.1.1.2.8.2  jruoho             if (!(GpeRegisterInfo->EnableForRun |
    430  1.1.1.2.8.2  jruoho                   GpeRegisterInfo->EnableForWake))
    431  1.1.1.2.8.2  jruoho             {
    432  1.1.1.2.8.2  jruoho                 continue;
    433  1.1.1.2.8.2  jruoho             }
    434  1.1.1.2.8.2  jruoho 
    435  1.1.1.2.8.2  jruoho             /* Read the Status Register */
    436  1.1.1.2.8.2  jruoho 
    437  1.1.1.2.8.2  jruoho             Status = AcpiHwRead (&StatusReg, &GpeRegisterInfo->StatusAddress);
    438  1.1.1.2.8.2  jruoho             if (ACPI_FAILURE (Status))
    439  1.1.1.2.8.2  jruoho             {
    440  1.1.1.2.8.2  jruoho                 goto UnlockAndExit;
    441  1.1.1.2.8.2  jruoho             }
    442  1.1.1.2.8.2  jruoho 
    443  1.1.1.2.8.2  jruoho             /* Read the Enable Register */
    444  1.1.1.2.8.2  jruoho 
    445  1.1.1.2.8.2  jruoho             Status = AcpiHwRead (&EnableReg, &GpeRegisterInfo->EnableAddress);
    446  1.1.1.2.8.2  jruoho             if (ACPI_FAILURE (Status))
    447  1.1.1.2.8.2  jruoho             {
    448  1.1.1.2.8.2  jruoho                 goto UnlockAndExit;
    449  1.1.1.2.8.2  jruoho             }
    450  1.1.1.2.8.2  jruoho 
    451  1.1.1.2.8.2  jruoho             ACPI_DEBUG_PRINT ((ACPI_DB_INTERRUPTS,
    452  1.1.1.2.8.2  jruoho                 "Read GPE Register at GPE%02X: Status=%02X, Enable=%02X\n",
    453  1.1.1.2.8.2  jruoho                 GpeRegisterInfo->BaseGpeNumber, StatusReg, EnableReg));
    454  1.1.1.2.8.2  jruoho 
    455  1.1.1.2.8.2  jruoho             /* Check if there is anything active at all in this register */
    456  1.1.1.2.8.2  jruoho 
    457  1.1.1.2.8.2  jruoho             EnabledStatusByte = (UINT8) (StatusReg & EnableReg);
    458  1.1.1.2.8.2  jruoho             if (!EnabledStatusByte)
    459  1.1.1.2.8.2  jruoho             {
    460  1.1.1.2.8.2  jruoho                 /* No active GPEs in this register, move on */
    461  1.1.1.2.8.2  jruoho 
    462  1.1.1.2.8.2  jruoho                 continue;
    463  1.1.1.2.8.2  jruoho             }
    464  1.1.1.2.8.2  jruoho 
    465  1.1.1.2.8.2  jruoho             /* Now look at the individual GPEs in this byte register */
    466  1.1.1.2.8.2  jruoho 
    467  1.1.1.2.8.2  jruoho             for (j = 0; j < ACPI_GPE_REGISTER_WIDTH; j++)
    468  1.1.1.2.8.2  jruoho             {
    469  1.1.1.2.8.2  jruoho                 /* Examine one GPE bit */
    470  1.1.1.2.8.2  jruoho 
    471  1.1.1.2.8.2  jruoho                 if (EnabledStatusByte & (1 << j))
    472  1.1.1.2.8.2  jruoho                 {
    473  1.1.1.2.8.2  jruoho                     /*
    474  1.1.1.2.8.2  jruoho                      * Found an active GPE. Dispatch the event to a handler
    475  1.1.1.2.8.2  jruoho                      * or method.
    476  1.1.1.2.8.2  jruoho                      */
    477  1.1.1.2.8.2  jruoho                     IntStatus |= AcpiEvGpeDispatch (GpeBlock->Node,
    478  1.1.1.2.8.2  jruoho                         &GpeBlock->EventInfo[((ACPI_SIZE) i *
    479  1.1.1.2.8.2  jruoho                             ACPI_GPE_REGISTER_WIDTH) + j],
    480  1.1.1.2.8.2  jruoho                         j + GpeRegisterInfo->BaseGpeNumber);
    481  1.1.1.2.8.2  jruoho                 }
    482  1.1.1.2.8.2  jruoho             }
    483  1.1.1.2.8.2  jruoho         }
    484  1.1.1.2.8.2  jruoho 
    485  1.1.1.2.8.2  jruoho         GpeBlock = GpeBlock->Next;
    486  1.1.1.2.8.2  jruoho     }
    487  1.1.1.2.8.2  jruoho 
    488  1.1.1.2.8.2  jruoho UnlockAndExit:
    489  1.1.1.2.8.2  jruoho 
    490  1.1.1.2.8.2  jruoho     AcpiOsReleaseLock (AcpiGbl_GpeLock, Flags);
    491  1.1.1.2.8.2  jruoho     return (IntStatus);
    492  1.1.1.2.8.2  jruoho }
    493  1.1.1.2.8.2  jruoho 
    494  1.1.1.2.8.2  jruoho 
    495  1.1.1.2.8.2  jruoho /*******************************************************************************
    496  1.1.1.2.8.2  jruoho  *
    497  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiEvAsynchExecuteGpeMethod
    498  1.1.1.2.8.2  jruoho  *
    499  1.1.1.2.8.2  jruoho  * PARAMETERS:  Context (GpeEventInfo) - Info for this GPE
    500  1.1.1.2.8.2  jruoho  *
    501  1.1.1.2.8.2  jruoho  * RETURN:      None
    502  1.1.1.2.8.2  jruoho  *
    503  1.1.1.2.8.2  jruoho  * DESCRIPTION: Perform the actual execution of a GPE control method. This
    504  1.1.1.2.8.2  jruoho  *              function is called from an invocation of AcpiOsExecute and
    505  1.1.1.2.8.2  jruoho  *              therefore does NOT execute at interrupt level - so that
    506  1.1.1.2.8.2  jruoho  *              the control method itself is not executed in the context of
    507  1.1.1.2.8.2  jruoho  *              an interrupt handler.
    508  1.1.1.2.8.2  jruoho  *
    509  1.1.1.2.8.2  jruoho  ******************************************************************************/
    510  1.1.1.2.8.2  jruoho 
    511  1.1.1.2.8.2  jruoho static void ACPI_SYSTEM_XFACE
    512  1.1.1.2.8.2  jruoho AcpiEvAsynchExecuteGpeMethod (
    513  1.1.1.2.8.2  jruoho     void                    *Context)
    514  1.1.1.2.8.2  jruoho {
    515  1.1.1.2.8.2  jruoho     ACPI_GPE_EVENT_INFO     *GpeEventInfo = Context;
    516  1.1.1.2.8.2  jruoho     ACPI_STATUS             Status;
    517  1.1.1.2.8.2  jruoho     ACPI_GPE_EVENT_INFO     *LocalGpeEventInfo;
    518  1.1.1.2.8.2  jruoho     ACPI_EVALUATE_INFO      *Info;
    519  1.1.1.2.8.2  jruoho 
    520  1.1.1.2.8.2  jruoho 
    521  1.1.1.2.8.2  jruoho     ACPI_FUNCTION_TRACE (EvAsynchExecuteGpeMethod);
    522  1.1.1.2.8.2  jruoho 
    523  1.1.1.2.8.2  jruoho 
    524  1.1.1.2.8.2  jruoho     /* Allocate a local GPE block */
    525  1.1.1.2.8.2  jruoho 
    526  1.1.1.2.8.2  jruoho     LocalGpeEventInfo = ACPI_ALLOCATE_ZEROED (sizeof (ACPI_GPE_EVENT_INFO));
    527  1.1.1.2.8.2  jruoho     if (!LocalGpeEventInfo)
    528  1.1.1.2.8.2  jruoho     {
    529  1.1.1.2.8.2  jruoho         ACPI_EXCEPTION ((AE_INFO, AE_NO_MEMORY,
    530  1.1.1.2.8.2  jruoho             "while handling a GPE"));
    531  1.1.1.2.8.2  jruoho         return_VOID;
    532  1.1.1.2.8.2  jruoho     }
    533  1.1.1.2.8.2  jruoho 
    534  1.1.1.2.8.2  jruoho     Status = AcpiUtAcquireMutex (ACPI_MTX_EVENTS);
    535  1.1.1.2.8.2  jruoho     if (ACPI_FAILURE (Status))
    536  1.1.1.2.8.2  jruoho     {
    537  1.1.1.2.8.2  jruoho         return_VOID;
    538  1.1.1.2.8.2  jruoho     }
    539  1.1.1.2.8.2  jruoho 
    540  1.1.1.2.8.2  jruoho     /* Must revalidate the GpeNumber/GpeBlock */
    541  1.1.1.2.8.2  jruoho 
    542  1.1.1.2.8.2  jruoho     if (!AcpiEvValidGpeEvent (GpeEventInfo))
    543  1.1.1.2.8.2  jruoho     {
    544  1.1.1.2.8.2  jruoho         Status = AcpiUtReleaseMutex (ACPI_MTX_EVENTS);
    545  1.1.1.2.8.2  jruoho         return_VOID;
    546  1.1.1.2.8.2  jruoho     }
    547  1.1.1.2.8.2  jruoho 
    548  1.1.1.2.8.2  jruoho     /*
    549  1.1.1.2.8.2  jruoho      * Take a snapshot of the GPE info for this level - we copy the info to
    550  1.1.1.2.8.2  jruoho      * prevent a race condition with RemoveHandler/RemoveBlock.
    551  1.1.1.2.8.2  jruoho      */
    552  1.1.1.2.8.2  jruoho     ACPI_MEMCPY (LocalGpeEventInfo, GpeEventInfo,
    553  1.1.1.2.8.2  jruoho         sizeof (ACPI_GPE_EVENT_INFO));
    554  1.1.1.2.8.2  jruoho 
    555  1.1.1.2.8.2  jruoho     Status = AcpiUtReleaseMutex (ACPI_MTX_EVENTS);
    556  1.1.1.2.8.2  jruoho     if (ACPI_FAILURE (Status))
    557  1.1.1.2.8.2  jruoho     {
    558  1.1.1.2.8.2  jruoho         return_VOID;
    559  1.1.1.2.8.2  jruoho     }
    560  1.1.1.2.8.2  jruoho 
    561  1.1.1.2.8.2  jruoho     /* Do the correct dispatch - normal method or implicit notify */
    562  1.1.1.2.8.2  jruoho 
    563  1.1.1.2.8.2  jruoho     switch (LocalGpeEventInfo->Flags & ACPI_GPE_DISPATCH_MASK)
    564  1.1.1.2.8.2  jruoho     {
    565  1.1.1.2.8.2  jruoho     case ACPI_GPE_DISPATCH_NOTIFY:
    566  1.1.1.2.8.2  jruoho 
    567  1.1.1.2.8.2  jruoho         /*
    568  1.1.1.2.8.2  jruoho          * Implicit notify.
    569  1.1.1.2.8.2  jruoho          * Dispatch a DEVICE_WAKE notify to the appropriate handler.
    570  1.1.1.2.8.2  jruoho          * NOTE: the request is queued for execution after this method
    571  1.1.1.2.8.2  jruoho          * completes. The notify handlers are NOT invoked synchronously
    572  1.1.1.2.8.2  jruoho          * from this thread -- because handlers may in turn run other
    573  1.1.1.2.8.2  jruoho          * control methods.
    574  1.1.1.2.8.2  jruoho          */
    575  1.1.1.2.8.2  jruoho         Status = AcpiEvQueueNotifyRequest (
    576  1.1.1.2.8.2  jruoho                     LocalGpeEventInfo->Dispatch.DeviceNode,
    577  1.1.1.2.8.2  jruoho                     ACPI_NOTIFY_DEVICE_WAKE);
    578  1.1.1.2.8.2  jruoho         break;
    579  1.1.1.2.8.2  jruoho 
    580  1.1.1.2.8.2  jruoho     case ACPI_GPE_DISPATCH_METHOD:
    581  1.1.1.2.8.2  jruoho 
    582  1.1.1.2.8.2  jruoho         /* Allocate the evaluation information block */
    583  1.1.1.2.8.2  jruoho 
    584  1.1.1.2.8.2  jruoho         Info = ACPI_ALLOCATE_ZEROED (sizeof (ACPI_EVALUATE_INFO));
    585  1.1.1.2.8.2  jruoho         if (!Info)
    586  1.1.1.2.8.2  jruoho         {
    587  1.1.1.2.8.2  jruoho             Status = AE_NO_MEMORY;
    588  1.1.1.2.8.2  jruoho         }
    589  1.1.1.2.8.2  jruoho         else
    590  1.1.1.2.8.2  jruoho         {
    591  1.1.1.2.8.2  jruoho             /*
    592  1.1.1.2.8.2  jruoho              * Invoke the GPE Method (_Lxx, _Exx) i.e., evaluate the
    593  1.1.1.2.8.2  jruoho              * _Lxx/_Exx control method that corresponds to this GPE
    594  1.1.1.2.8.2  jruoho              */
    595  1.1.1.2.8.2  jruoho             Info->PrefixNode = LocalGpeEventInfo->Dispatch.MethodNode;
    596  1.1.1.2.8.2  jruoho             Info->Flags = ACPI_IGNORE_RETURN_VALUE;
    597  1.1.1.2.8.2  jruoho 
    598  1.1.1.2.8.2  jruoho             Status = AcpiNsEvaluate (Info);
    599  1.1.1.2.8.2  jruoho             ACPI_FREE (Info);
    600  1.1.1.2.8.2  jruoho         }
    601  1.1.1.2.8.2  jruoho 
    602  1.1.1.2.8.2  jruoho         if (ACPI_FAILURE (Status))
    603  1.1.1.2.8.2  jruoho         {
    604  1.1.1.2.8.2  jruoho             ACPI_EXCEPTION ((AE_INFO, Status,
    605  1.1.1.2.8.2  jruoho                 "while evaluating GPE method [%4.4s]",
    606  1.1.1.2.8.2  jruoho                 AcpiUtGetNodeName (LocalGpeEventInfo->Dispatch.MethodNode)));
    607  1.1.1.2.8.2  jruoho         }
    608  1.1.1.2.8.2  jruoho 
    609  1.1.1.2.8.2  jruoho         break;
    610  1.1.1.2.8.2  jruoho 
    611  1.1.1.2.8.2  jruoho     default:
    612  1.1.1.2.8.2  jruoho         return_VOID; /* Should never happen */
    613  1.1.1.2.8.2  jruoho     }
    614  1.1.1.2.8.2  jruoho 
    615  1.1.1.2.8.2  jruoho     /* Defer enabling of GPE until all notify handlers are done */
    616  1.1.1.2.8.2  jruoho 
    617  1.1.1.2.8.2  jruoho     Status = AcpiOsExecute (OSL_NOTIFY_HANDLER,
    618  1.1.1.2.8.2  jruoho                 AcpiEvAsynchEnableGpe, LocalGpeEventInfo);
    619  1.1.1.2.8.2  jruoho     if (ACPI_FAILURE (Status))
    620  1.1.1.2.8.2  jruoho     {
    621  1.1.1.2.8.2  jruoho         ACPI_FREE (LocalGpeEventInfo);
    622  1.1.1.2.8.2  jruoho     }
    623  1.1.1.2.8.2  jruoho     return_VOID;
    624  1.1.1.2.8.2  jruoho }
    625  1.1.1.2.8.2  jruoho 
    626  1.1.1.2.8.2  jruoho 
    627  1.1.1.2.8.2  jruoho /*******************************************************************************
    628  1.1.1.2.8.2  jruoho  *
    629  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiEvAsynchEnableGpe
    630  1.1.1.2.8.2  jruoho  *
    631  1.1.1.2.8.2  jruoho  * PARAMETERS:  Context (GpeEventInfo) - Info for this GPE
    632  1.1.1.2.8.2  jruoho  *              Callback from AcpiOsExecute
    633  1.1.1.2.8.2  jruoho  *
    634  1.1.1.2.8.2  jruoho  * RETURN:      None
    635  1.1.1.2.8.2  jruoho  *
    636  1.1.1.2.8.2  jruoho  * DESCRIPTION: Asynchronous clear/enable for GPE. This allows the GPE to
    637  1.1.1.2.8.2  jruoho  *              complete (i.e., finish execution of Notify)
    638  1.1.1.2.8.2  jruoho  *
    639  1.1.1.2.8.2  jruoho  ******************************************************************************/
    640  1.1.1.2.8.2  jruoho 
    641  1.1.1.2.8.2  jruoho static void ACPI_SYSTEM_XFACE
    642  1.1.1.2.8.2  jruoho AcpiEvAsynchEnableGpe (
    643  1.1.1.2.8.2  jruoho     void                    *Context)
    644  1.1.1.2.8.2  jruoho {
    645  1.1.1.2.8.2  jruoho     ACPI_GPE_EVENT_INFO     *GpeEventInfo = Context;
    646  1.1.1.2.8.2  jruoho 
    647  1.1.1.2.8.2  jruoho 
    648  1.1.1.2.8.2  jruoho     (void) AcpiEvFinishGpe (GpeEventInfo);
    649  1.1.1.2.8.2  jruoho 
    650  1.1.1.2.8.2  jruoho     ACPI_FREE (GpeEventInfo);
    651  1.1.1.2.8.2  jruoho     return;
    652  1.1.1.2.8.2  jruoho }
    653  1.1.1.2.8.2  jruoho 
    654  1.1.1.2.8.2  jruoho 
    655  1.1.1.2.8.2  jruoho /*******************************************************************************
    656  1.1.1.2.8.2  jruoho  *
    657  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiEvFinishGpe
    658  1.1.1.2.8.2  jruoho  *
    659  1.1.1.2.8.2  jruoho  * PARAMETERS:  GpeEventInfo        - Info for this GPE
    660  1.1.1.2.8.2  jruoho  *
    661  1.1.1.2.8.2  jruoho  * RETURN:      Status
    662  1.1.1.2.8.2  jruoho  *
    663  1.1.1.2.8.2  jruoho  * DESCRIPTION: Clear/Enable a GPE. Common code that is used after execution
    664  1.1.1.2.8.2  jruoho  *              of a GPE method or a synchronous or asynchronous GPE handler.
    665  1.1.1.2.8.2  jruoho  *
    666  1.1.1.2.8.2  jruoho  ******************************************************************************/
    667  1.1.1.2.8.2  jruoho 
    668  1.1.1.2.8.2  jruoho ACPI_STATUS
    669  1.1.1.2.8.2  jruoho AcpiEvFinishGpe (
    670  1.1.1.2.8.2  jruoho     ACPI_GPE_EVENT_INFO     *GpeEventInfo)
    671  1.1.1.2.8.2  jruoho {
    672  1.1.1.2.8.2  jruoho     ACPI_STATUS             Status;
    673  1.1.1.2.8.2  jruoho 
    674  1.1.1.2.8.2  jruoho 
    675  1.1.1.2.8.2  jruoho     if ((GpeEventInfo->Flags & ACPI_GPE_XRUPT_TYPE_MASK) ==
    676  1.1.1.2.8.2  jruoho             ACPI_GPE_LEVEL_TRIGGERED)
    677  1.1.1.2.8.2  jruoho     {
    678  1.1.1.2.8.2  jruoho         /*
    679  1.1.1.2.8.2  jruoho          * GPE is level-triggered, we clear the GPE status bit after
    680  1.1.1.2.8.2  jruoho          * handling the event.
    681  1.1.1.2.8.2  jruoho          */
    682  1.1.1.2.8.2  jruoho         Status = AcpiHwClearGpe (GpeEventInfo);
    683  1.1.1.2.8.2  jruoho         if (ACPI_FAILURE (Status))
    684  1.1.1.2.8.2  jruoho         {
    685  1.1.1.2.8.2  jruoho             return (Status);
    686  1.1.1.2.8.2  jruoho         }
    687  1.1.1.2.8.2  jruoho     }
    688  1.1.1.2.8.2  jruoho 
    689  1.1.1.2.8.2  jruoho     /*
    690  1.1.1.2.8.2  jruoho      * Enable this GPE, conditionally. This means that the GPE will
    691  1.1.1.2.8.2  jruoho      * only be physically enabled if the EnableForRun bit is set
    692  1.1.1.2.8.2  jruoho      * in the EventInfo.
    693  1.1.1.2.8.2  jruoho      */
    694  1.1.1.2.8.2  jruoho     (void) AcpiHwLowSetGpe (GpeEventInfo, ACPI_GPE_CONDITIONAL_ENABLE);
    695  1.1.1.2.8.2  jruoho     return (AE_OK);
    696  1.1.1.2.8.2  jruoho }
    697  1.1.1.2.8.2  jruoho 
    698  1.1.1.2.8.2  jruoho 
    699  1.1.1.2.8.2  jruoho /*******************************************************************************
    700  1.1.1.2.8.2  jruoho  *
    701  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiEvGpeDispatch
    702  1.1.1.2.8.2  jruoho  *
    703  1.1.1.2.8.2  jruoho  * PARAMETERS:  GpeDevice           - Device node. NULL for GPE0/GPE1
    704  1.1.1.2.8.2  jruoho  *              GpeEventInfo        - Info for this GPE
    705  1.1.1.2.8.2  jruoho  *              GpeNumber           - Number relative to the parent GPE block
    706  1.1.1.2.8.2  jruoho  *
    707  1.1.1.2.8.2  jruoho  * RETURN:      INTERRUPT_HANDLED or INTERRUPT_NOT_HANDLED
    708  1.1.1.2.8.2  jruoho  *
    709  1.1.1.2.8.2  jruoho  * DESCRIPTION: Dispatch a General Purpose Event to either a function (e.g. EC)
    710  1.1.1.2.8.2  jruoho  *              or method (e.g. _Lxx/_Exx) handler.
    711  1.1.1.2.8.2  jruoho  *
    712  1.1.1.2.8.2  jruoho  *              This function executes at interrupt level.
    713  1.1.1.2.8.2  jruoho  *
    714  1.1.1.2.8.2  jruoho  ******************************************************************************/
    715  1.1.1.2.8.2  jruoho 
    716  1.1.1.2.8.2  jruoho UINT32
    717  1.1.1.2.8.2  jruoho AcpiEvGpeDispatch (
    718  1.1.1.2.8.2  jruoho     ACPI_NAMESPACE_NODE     *GpeDevice,
    719  1.1.1.2.8.2  jruoho     ACPI_GPE_EVENT_INFO     *GpeEventInfo,
    720  1.1.1.2.8.2  jruoho     UINT32                  GpeNumber)
    721  1.1.1.2.8.2  jruoho {
    722  1.1.1.2.8.2  jruoho     ACPI_STATUS             Status;
    723  1.1.1.2.8.2  jruoho     UINT32                  ReturnValue;
    724  1.1.1.2.8.2  jruoho 
    725  1.1.1.2.8.2  jruoho 
    726  1.1.1.2.8.2  jruoho     ACPI_FUNCTION_TRACE (EvGpeDispatch);
    727  1.1.1.2.8.2  jruoho 
    728  1.1.1.2.8.2  jruoho 
    729  1.1.1.2.8.2  jruoho     /* Invoke global event handler if present */
    730  1.1.1.2.8.2  jruoho 
    731  1.1.1.2.8.2  jruoho     AcpiGpeCount++;
    732  1.1.1.2.8.2  jruoho     if (AcpiGbl_GlobalEventHandler)
    733  1.1.1.2.8.2  jruoho     {
    734  1.1.1.2.8.2  jruoho         AcpiGbl_GlobalEventHandler (ACPI_EVENT_TYPE_GPE, GpeDevice,
    735  1.1.1.2.8.2  jruoho              GpeNumber, AcpiGbl_GlobalEventHandlerContext);
    736  1.1.1.2.8.2  jruoho     }
    737  1.1.1.2.8.2  jruoho 
    738  1.1.1.2.8.2  jruoho     /*
    739  1.1.1.2.8.2  jruoho      * If edge-triggered, clear the GPE status bit now. Note that
    740  1.1.1.2.8.2  jruoho      * level-triggered events are cleared after the GPE is serviced.
    741  1.1.1.2.8.2  jruoho      */
    742  1.1.1.2.8.2  jruoho     if ((GpeEventInfo->Flags & ACPI_GPE_XRUPT_TYPE_MASK) ==
    743  1.1.1.2.8.2  jruoho             ACPI_GPE_EDGE_TRIGGERED)
    744  1.1.1.2.8.2  jruoho     {
    745  1.1.1.2.8.2  jruoho         Status = AcpiHwClearGpe (GpeEventInfo);
    746  1.1.1.2.8.2  jruoho         if (ACPI_FAILURE (Status))
    747  1.1.1.2.8.2  jruoho         {
    748  1.1.1.2.8.2  jruoho             ACPI_EXCEPTION ((AE_INFO, Status,
    749  1.1.1.2.8.2  jruoho                 "Unable to clear GPE%02X", GpeNumber));
    750  1.1.1.2.8.2  jruoho             return_UINT32 (ACPI_INTERRUPT_NOT_HANDLED);
    751  1.1.1.2.8.2  jruoho         }
    752  1.1.1.2.8.2  jruoho     }
    753  1.1.1.2.8.2  jruoho 
    754  1.1.1.2.8.2  jruoho     /*
    755  1.1.1.2.8.2  jruoho      * Always disable the GPE so that it does not keep firing before
    756  1.1.1.2.8.2  jruoho      * any asynchronous activity completes (either from the execution
    757  1.1.1.2.8.2  jruoho      * of a GPE method or an asynchronous GPE handler.)
    758  1.1.1.2.8.2  jruoho      *
    759  1.1.1.2.8.2  jruoho      * If there is no handler or method to run, just disable the
    760  1.1.1.2.8.2  jruoho      * GPE and leave it disabled permanently to prevent further such
    761  1.1.1.2.8.2  jruoho      * pointless events from firing.
    762  1.1.1.2.8.2  jruoho      */
    763  1.1.1.2.8.2  jruoho     Status = AcpiHwLowSetGpe (GpeEventInfo, ACPI_GPE_DISABLE);
    764  1.1.1.2.8.2  jruoho     if (ACPI_FAILURE (Status))
    765  1.1.1.2.8.2  jruoho     {
    766  1.1.1.2.8.2  jruoho         ACPI_EXCEPTION ((AE_INFO, Status,
    767  1.1.1.2.8.2  jruoho             "Unable to disable GPE%02X", GpeNumber));
    768  1.1.1.2.8.2  jruoho         return_UINT32 (ACPI_INTERRUPT_NOT_HANDLED);
    769  1.1.1.2.8.2  jruoho     }
    770  1.1.1.2.8.2  jruoho 
    771  1.1.1.2.8.2  jruoho     /*
    772  1.1.1.2.8.2  jruoho      * Dispatch the GPE to either an installed handler or the control
    773  1.1.1.2.8.2  jruoho      * method associated with this GPE (_Lxx or _Exx). If a handler
    774  1.1.1.2.8.2  jruoho      * exists, we invoke it and do not attempt to run the method.
    775  1.1.1.2.8.2  jruoho      * If there is neither a handler nor a method, leave the GPE
    776  1.1.1.2.8.2  jruoho      * disabled.
    777  1.1.1.2.8.2  jruoho      */
    778  1.1.1.2.8.2  jruoho     switch (GpeEventInfo->Flags & ACPI_GPE_DISPATCH_MASK)
    779  1.1.1.2.8.2  jruoho     {
    780  1.1.1.2.8.2  jruoho     case ACPI_GPE_DISPATCH_HANDLER:
    781  1.1.1.2.8.2  jruoho 
    782  1.1.1.2.8.2  jruoho         /* Invoke the installed handler (at interrupt level) */
    783  1.1.1.2.8.2  jruoho 
    784  1.1.1.2.8.2  jruoho         ReturnValue = GpeEventInfo->Dispatch.Handler->Address (
    785  1.1.1.2.8.2  jruoho             GpeDevice, GpeNumber,
    786  1.1.1.2.8.2  jruoho             GpeEventInfo->Dispatch.Handler->Context);
    787  1.1.1.2.8.2  jruoho 
    788  1.1.1.2.8.2  jruoho         /* If requested, clear (if level-triggered) and reenable the GPE */
    789  1.1.1.2.8.2  jruoho 
    790  1.1.1.2.8.2  jruoho         if (ReturnValue & ACPI_REENABLE_GPE)
    791  1.1.1.2.8.2  jruoho         {
    792  1.1.1.2.8.2  jruoho             (void) AcpiEvFinishGpe (GpeEventInfo);
    793  1.1.1.2.8.2  jruoho         }
    794  1.1.1.2.8.2  jruoho         break;
    795  1.1.1.2.8.2  jruoho 
    796  1.1.1.2.8.2  jruoho     case ACPI_GPE_DISPATCH_METHOD:
    797  1.1.1.2.8.2  jruoho     case ACPI_GPE_DISPATCH_NOTIFY:
    798  1.1.1.2.8.2  jruoho 
    799  1.1.1.2.8.2  jruoho         /*
    800  1.1.1.2.8.2  jruoho          * Execute the method associated with the GPE
    801  1.1.1.2.8.2  jruoho          * NOTE: Level-triggered GPEs are cleared after the method completes.
    802  1.1.1.2.8.2  jruoho          */
    803  1.1.1.2.8.2  jruoho         Status = AcpiOsExecute (OSL_GPE_HANDLER,
    804  1.1.1.2.8.2  jruoho                     AcpiEvAsynchExecuteGpeMethod, GpeEventInfo);
    805  1.1.1.2.8.2  jruoho         if (ACPI_FAILURE (Status))
    806  1.1.1.2.8.2  jruoho         {
    807  1.1.1.2.8.2  jruoho             ACPI_EXCEPTION ((AE_INFO, Status,
    808  1.1.1.2.8.2  jruoho                 "Unable to queue handler for GPE%02X - event disabled",
    809  1.1.1.2.8.2  jruoho                 GpeNumber));
    810  1.1.1.2.8.2  jruoho         }
    811  1.1.1.2.8.2  jruoho         break;
    812  1.1.1.2.8.2  jruoho 
    813  1.1.1.2.8.2  jruoho     default:
    814  1.1.1.2.8.2  jruoho 
    815  1.1.1.2.8.2  jruoho         /*
    816  1.1.1.2.8.2  jruoho          * No handler or method to run!
    817  1.1.1.2.8.2  jruoho          * 03/2010: This case should no longer be possible. We will not allow
    818  1.1.1.2.8.2  jruoho          * a GPE to be enabled if it has no handler or method.
    819  1.1.1.2.8.2  jruoho          */
    820  1.1.1.2.8.2  jruoho         ACPI_ERROR ((AE_INFO,
    821  1.1.1.2.8.2  jruoho             "No handler or method for GPE%02X, disabling event",
    822  1.1.1.2.8.2  jruoho             GpeNumber));
    823  1.1.1.2.8.2  jruoho         break;
    824  1.1.1.2.8.2  jruoho     }
    825  1.1.1.2.8.2  jruoho 
    826  1.1.1.2.8.2  jruoho     return_UINT32 (ACPI_INTERRUPT_HANDLED);
    827  1.1.1.2.8.2  jruoho }
    828  1.1.1.2.8.2  jruoho 
    829