26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * Module Name: evxfgpe - External Interfaces for General Purpose Events (GPEs)
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross *****************************************************************************/
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * Copyright (C) 2000 - 2016, Intel Corp.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * All rights reserved.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * Redistribution and use in source and binary forms, with or without
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * modification, are permitted provided that the following conditions
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * 1. Redistributions of source code must retain the above copyright
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * notice, this list of conditions, and the following disclaimer,
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * without modification.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * 2. Redistributions in binary form must reproduce at minimum a disclaimer
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * substantially similar to the "NO WARRANTY" disclaimer below
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * ("Disclaimer") and any redistribution must be conditioned upon
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * including a substantially similar Disclaimer requirement for further
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * binary redistribution.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * 3. Neither the names of the above-listed copyright holders nor the names
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * of any contributors may be used to endorse or promote products derived
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * from this software without specific prior written permission.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * Alternatively, this software may be distributed under the terms of the
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GNU General Public License ("GPL") version 2 as published by the Free
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * Software Foundation.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * NO WARRANTY
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * POSSIBILITY OF SUCH DAMAGES.
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek#if (!ACPI_REDUCED_HARDWARE) /* Entire module */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/*******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiUpdateAllGpes
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: None
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Complete GPE initialization and enable all GPEs that have
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * associated _Lxx or _Exx methods and are not pointed to by any
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * device _PRW methods (this indicates that these GPEs are
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * generally intended for system or device wakeup. Such GPEs
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * have to be enabled directly when the devices whose _PRW
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * methods point to them are set up for wakeup signaling.)
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * NOTE: Should be called after any GPEs are added to the system. Primarily,
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * after the system _PRW methods have been run, but also after a GPE Block
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * Device has been added or if any new GPE methods have been added via a
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * dynamic table load.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross Status = AcpiEvWalkGpeList (AcpiEvInitializeGpeBlock, NULL);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/*******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiEnableGpe
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: GpeDevice - Parent GPE Device. NULL for GPE0/GPE1
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GpeNumber - GPE level within the GPE block
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Add a reference to a GPE. On the first reference, the GPE is
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * hardware-enabled.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * Ensure that we have a valid GPE number and that there is some way
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * of handling the GPE (handler or a GPE method). In other words, we
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * won't allow a valid GPE to be enabled if there is no way to handle it.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross GpeEventInfo = AcpiEvGetGpeEventInfo (GpeDevice, GpeNumber);
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek if (ACPI_GPE_DISPATCH_TYPE (GpeEventInfo->Flags) !=
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek Status = AcpiEvAddGpeReference (GpeEventInfo);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/*******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiDisableGpe
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: GpeDevice - Parent GPE Device. NULL for GPE0/GPE1
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GpeNumber - GPE level within the GPE block
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Remove a reference to a GPE. When the last reference is
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * removed, only then is the GPE disabled (for runtime GPEs), or
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * the GPE mask bit disabled (for wake GPEs)
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Ensure that we have a valid GPE number */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross GpeEventInfo = AcpiEvGetGpeEventInfo (GpeDevice, GpeNumber);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross Status = AcpiEvRemoveGpeReference (GpeEventInfo);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/*******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiSetGpe
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: GpeDevice - Parent GPE Device. NULL for GPE0/GPE1
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GpeNumber - GPE level within the GPE block
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * Action - ACPI_GPE_ENABLE or ACPI_GPE_DISABLE
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Enable or disable an individual GPE. This function bypasses
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * the reference count mechanism used in the AcpiEnableGpe(),
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * AcpiDisableGpe() interfaces.
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * This API is typically used by the GPE raw handler mode driver
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * to switch between the polling mode and the interrupt mode after
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * the driver has enabled the GPE.
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * The APIs should be invoked in this order:
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * AcpiEnableGpe() <- Ensure the reference count > 0
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * AcpiSetGpe(ACPI_GPE_DISABLE) <- Enter polling mode
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * AcpiSetGpe(ACPI_GPE_ENABLE) <- Leave polling mode
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * AcpiDisableGpe() <- Decrease the reference count
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * Note: If a GPE is shared by 2 silicon components, then both the drivers
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * should support GPE polling mode or disabling the GPE for long period
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * for one driver may break the other. So use it with care since all
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * firmware _Lxx/_Exx handlers currently rely on the GPE interrupt mode.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Ensure that we have a valid GPE number */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross GpeEventInfo = AcpiEvGetGpeEventInfo (GpeDevice, GpeNumber);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Perform the action */
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek Status = AcpiHwLowSetGpe (GpeEventInfo, ACPI_GPE_ENABLE);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross Status = AcpiHwLowSetGpe (GpeEventInfo, ACPI_GPE_DISABLE);
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek/*******************************************************************************
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * FUNCTION: AcpiMarkGpeForWake
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * PARAMETERS: GpeDevice - Parent GPE Device. NULL for GPE0/GPE1
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * GpeNumber - GPE level within the GPE block
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * RETURN: Status
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * DESCRIPTION: Mark a GPE as having the ability to wake the system. Simply
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * sets the ACPI_GPE_CAN_WAKE flag.
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * Some potential callers of AcpiSetupGpeForWake may know in advance that
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * there won't be any notify handlers installed for device wake notifications
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * from the given GPE (one example is a button GPE in Linux). For these cases,
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * AcpiMarkGpeForWake should be used instead of AcpiSetupGpeForWake.
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * This will set the ACPI_GPE_CAN_WAKE flag for the GPE without trying to
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * setup implicit wake notification for it (since there's no handler method).
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek ******************************************************************************/
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek /* Ensure that we have a valid GPE number */
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek GpeEventInfo = AcpiEvGetGpeEventInfo (GpeDevice, GpeNumber);
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek /* Mark the GPE as a possible wake event */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/*******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiSetupGpeForWake
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: WakeDevice - Device associated with the GPE (via _PRW)
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GpeDevice - Parent GPE Device. NULL for GPE0/GPE1
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GpeNumber - GPE level within the GPE block
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Mark a GPE as having the ability to wake the system. This
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * interface is intended to be used as the host executes the
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * _PRW methods (Power Resources for Wake) in the system tables.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * Each _PRW appears under a Device Object (The WakeDevice), and
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * contains the info for the wake GPE associated with the
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * WakeDevice.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Parameter Validation */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * By forcing WakeDevice to be valid, we automatically enable the
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * implicit notify feature on all hosts.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Handle root object case */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross DeviceNode = ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, WakeDevice);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Validate WakeDevice is of type Device */
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * Allocate a new notify object up front, in case it is needed.
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * Memory allocation while holding a spinlock is a big no-no
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * on some hosts.
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek NewNotify = ACPI_ALLOCATE_ZEROED (sizeof (ACPI_GPE_NOTIFY_INFO));
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Ensure that we have a valid GPE number */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross GpeEventInfo = AcpiEvGetGpeEventInfo (GpeDevice, GpeNumber);
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * If there is no method or handler for this GPE, then the
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * WakeDevice will be notified whenever this GPE fires. This is
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * known as an "implicit notify". Note: The GPE is assumed to be
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * level-triggered (for windows compatibility).
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek if (ACPI_GPE_DISPATCH_TYPE (GpeEventInfo->Flags) ==
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * This is the first device for implicit notify on this GPE.
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * Just set the flags here, and enter the NOTIFY block below.
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek (ACPI_GPE_DISPATCH_NOTIFY | ACPI_GPE_LEVEL_TRIGGERED);
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * If we already have an implicit notify on this GPE, add
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * this device to the notify list.
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek if (ACPI_GPE_DISPATCH_TYPE (GpeEventInfo->Flags) ==
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek /* Ensure that the device is not already in the list */
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek /* Add this device to the notify list for this GPE */
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek NewNotify->Next = GpeEventInfo->Dispatch.NotifyList;
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek GpeEventInfo->Dispatch.NotifyList = NewNotify;
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek /* Mark the GPE as a possible wake event */
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek /* Delete the notify object if it was not used above */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/*******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiSetGpeWakeMask
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: GpeDevice - Parent GPE Device. NULL for GPE0/GPE1
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GpeNumber - GPE level within the GPE block
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * Action - Enable or Disable
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Set or clear the GPE's wakeup enable mask bit. The GPE must
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * already be marked as a WAKE GPE.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * Ensure that we have a valid GPE number and that this GPE is in
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * fact a wake GPE
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross GpeEventInfo = AcpiEvGetGpeEventInfo (GpeDevice, GpeNumber);
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek RegisterBit = AcpiHwGetGpeRegisterBit (GpeEventInfo);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Perform the action */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ACPI_SET_BIT (GpeRegisterInfo->EnableForWake, (UINT8) RegisterBit);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ACPI_CLEAR_BIT (GpeRegisterInfo->EnableForWake, (UINT8) RegisterBit);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ACPI_ERROR ((AE_INFO, "%u, Invalid action", Action));
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/*******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiClearGpe
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: GpeDevice - Parent GPE Device. NULL for GPE0/GPE1
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GpeNumber - GPE level within the GPE block
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Clear an ACPI event (general purpose)
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Ensure that we have a valid GPE number */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross GpeEventInfo = AcpiEvGetGpeEventInfo (GpeDevice, GpeNumber);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/*******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiGetGpeStatus
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: GpeDevice - Parent GPE Device. NULL for GPE0/GPE1
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GpeNumber - GPE level within the GPE block
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * EventStatus - Where the current status of the event
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * will be returned
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Get the current status of a GPE (signalled/not_signalled)
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Ensure that we have a valid GPE number */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross GpeEventInfo = AcpiEvGetGpeEventInfo (GpeDevice, GpeNumber);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Obtain status on the requested GPE number */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross Status = AcpiHwGetGpeStatus (GpeEventInfo, EventStatus);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/*******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiFinishGpe
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: GpeDevice - Namespace node for the GPE Block
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * (NULL for FADT defined GPEs)
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GpeNumber - GPE level within the GPE block
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Clear and conditionally reenable a GPE. This completes the GPE
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * processing. Intended for use by asynchronous host-installed
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GPE handlers. The GPE is only reenabled if the EnableForRun bit
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * is set in the GPE info.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Ensure that we have a valid GPE number */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross GpeEventInfo = AcpiEvGetGpeEventInfo (GpeDevice, GpeNumber);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiDisableAllGpes
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: None
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Disable and clear all GPEs in all GPE blocks
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiEnableAllRuntimeGpes
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: None
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Enable all "runtime" GPEs, in all GPE blocks
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek/******************************************************************************
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * FUNCTION: AcpiEnableAllWakeupGpes
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * PARAMETERS: None
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * RETURN: Status
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * DESCRIPTION: Enable all "wakeup" GPEs and disable all of the other GPEs, in
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek * all GPE blocks.
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek ******************************************************************************/
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek ACPI_FUNCTION_TRACE (AcpiEnableAllWakeupGpes);
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek Status = AcpiUtAcquireMutex (ACPI_MTX_EVENTS);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/*******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiInstallGpeBlock
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: GpeDevice - Handle to the parent GPE Block Device
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GpeBlockAddress - Address and SpaceID
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RegisterCount - Number of GPE register pairs in the block
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * InterruptNumber - H/W interrupt for the block
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Create and Install a block of GPE registers. The GPEs are not
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * enabled here.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek /* Validate the parent device */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * For user-installed GPE Block Devices, the GpeBlockBaseNumber
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * is always zero
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek Status = AcpiEvCreateGpeBlock (Node, GpeBlockAddress->Address,
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Install block in the DeviceObject attached to the node */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * No object, create a new one (Device nodes do not always have
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * an attached object)
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ObjDesc = AcpiUtCreateInternalObject (ACPI_TYPE_DEVICE);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross Status = AcpiNsAttachObject (Node, ObjDesc, ACPI_TYPE_DEVICE);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Remove local reference to the object */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Now install the GPE block in the DeviceObject */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/*******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiRemoveGpeBlock
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: GpeDevice - Handle to the parent GPE Block Device
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Remove a previously installed block of GPE registers
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek /* Validate the parent device */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Get the DeviceObject attached to the node */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Delete the GPE block (but not the DeviceObject) */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross Status = AcpiEvDeleteGpeBlock (ObjDesc->Device.GpeBlock);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross/*******************************************************************************
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * FUNCTION: AcpiGetGpeDevice
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * PARAMETERS: Index - System GPE index (0-CurrentGpeCount)
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * GpeDevice - Where the parent GPE Device is returned
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * RETURN: Status
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * DESCRIPTION: Obtain the GPE device associated with the input index. A NULL
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * gpe device indicates that the gpe number is contained in one of
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross * the FADT-defined gpe blocks. Otherwise, the GPE block device.
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross ******************************************************************************/
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross /* Setup and walk the GPE list */
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross Status = AcpiEvWalkGpeList (AcpiEvGetGpeDevice, &Info);
26f3cdf03f1adcc98f6d3d99843ee71e9229a8c0Gordon Ross *GpeDevice = ACPI_CAST_PTR (ACPI_HANDLE, Info.GpeDevice);
7b1019a6d29ccb7999dc76cba3dde1c627e8e609Jerry Jelinek#endif /* !ACPI_REDUCED_HARDWARE */