1 /******************************************************************************
3 * Name: acevents.h - Event subcomponent prototypes and defines
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2016, Intel Corp.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions, and the following disclaimer,
16 * without modification.
17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 * substantially similar to the "NO WARRANTY" disclaimer below
19 * ("Disclaimer") and any redistribution must be conditioned upon
20 * including a substantially similar Disclaimer requirement for further
21 * binary redistribution.
22 * 3. Neither the names of the above-listed copyright holders nor the names
23 * of any contributors may be used to endorse or promote products derived
24 * from this software without specific prior written permission.
26 * Alternatively, this software may be distributed under the terms of the
27 * GNU General Public License ("GPL") version 2 as published by the Free
28 * Software Foundation.
31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 * POSSIBILITY OF SUCH DAMAGES.
44 #ifndef __ACEVENTS_H__
45 #define __ACEVENTS_H__
52 AcpiEvInitializeEvents (
56 AcpiEvInstallXruptHandlers (
60 AcpiEvFixedEventDetect (
68 AcpiEvIsNotifyObject (
69 ACPI_NAMESPACE_NODE *Node);
72 AcpiEvGetGpeNumberIndex (
76 AcpiEvQueueNotifyRequest (
77 ACPI_NAMESPACE_NODE *Node,
82 * evglock - Global Lock support
85 AcpiEvInitGlobalLockHandler (
88 ACPI_HW_DEPENDENT_RETURN_OK (
90 AcpiEvAcquireGlobalLock(
93 ACPI_HW_DEPENDENT_RETURN_OK (
95 AcpiEvReleaseGlobalLock(
99 AcpiEvRemoveGlobalLockHandler (
104 * evgpe - Low-level GPE support
108 ACPI_GPE_XRUPT_INFO *GpeXruptList);
111 AcpiEvUpdateGpeEnableMask (
112 ACPI_GPE_EVENT_INFO *GpeEventInfo);
116 ACPI_GPE_EVENT_INFO *GpeEventInfo);
120 ACPI_GPE_EVENT_INFO *GpeEventInfo,
124 AcpiEvAddGpeReference (
125 ACPI_GPE_EVENT_INFO *GpeEventInfo);
128 AcpiEvRemoveGpeReference (
129 ACPI_GPE_EVENT_INFO *GpeEventInfo);
131 ACPI_GPE_EVENT_INFO *
132 AcpiEvGetGpeEventInfo (
133 ACPI_HANDLE GpeDevice,
136 ACPI_GPE_EVENT_INFO *
137 AcpiEvLowGetGpeInfo (
139 ACPI_GPE_BLOCK_INFO *GpeBlock);
143 ACPI_GPE_EVENT_INFO *GpeEventInfo);
147 * evgpeblk - Upper-level GPE block support
150 AcpiEvCreateGpeBlock (
151 ACPI_NAMESPACE_NODE *GpeDevice,
154 UINT32 RegisterCount,
155 UINT16 GpeBlockBaseNumber,
156 UINT32 InterruptNumber,
157 ACPI_GPE_BLOCK_INFO **ReturnGpeBlock);
160 AcpiEvInitializeGpeBlock (
161 ACPI_GPE_XRUPT_INFO *GpeXruptInfo,
162 ACPI_GPE_BLOCK_INFO *GpeBlock,
165 ACPI_HW_DEPENDENT_RETURN_OK (
167 AcpiEvDeleteGpeBlock (
168 ACPI_GPE_BLOCK_INFO *GpeBlock))
172 ACPI_NAMESPACE_NODE *GpeDevice,
173 ACPI_GPE_EVENT_INFO *GpeEventInfo,
178 * evgpeinit - GPE initialization and update
181 AcpiEvGpeInitialize (
184 ACPI_HW_DEPENDENT_RETURN_VOID (
187 ACPI_OWNER_ID TableOwnerId))
190 AcpiEvMatchGpeMethod (
191 ACPI_HANDLE ObjHandle,
198 * evgpeutil - GPE utilities
202 ACPI_GPE_CALLBACK GpeWalkCallback,
207 ACPI_GPE_XRUPT_INFO *GpeXruptInfo,
208 ACPI_GPE_BLOCK_INFO *GpeBlock,
212 AcpiEvGetGpeXruptBlock (
213 UINT32 InterruptNumber,
214 ACPI_GPE_XRUPT_INFO **GpeXruptBlock);
217 AcpiEvDeleteGpeXrupt (
218 ACPI_GPE_XRUPT_INFO *GpeXrupt);
221 AcpiEvDeleteGpeHandlers (
222 ACPI_GPE_XRUPT_INFO *GpeXruptInfo,
223 ACPI_GPE_BLOCK_INFO *GpeBlock,
228 * evhandler - Address space handling
230 ACPI_OPERAND_OBJECT *
231 AcpiEvFindRegionHandler (
232 ACPI_ADR_SPACE_TYPE SpaceId,
233 ACPI_OPERAND_OBJECT *HandlerObj);
236 AcpiEvHasDefaultHandler (
237 ACPI_NAMESPACE_NODE *Node,
238 ACPI_ADR_SPACE_TYPE SpaceId);
241 AcpiEvInstallRegionHandlers (
245 AcpiEvInstallSpaceHandler (
246 ACPI_NAMESPACE_NODE *Node,
247 ACPI_ADR_SPACE_TYPE SpaceId,
248 ACPI_ADR_SPACE_HANDLER Handler,
249 ACPI_ADR_SPACE_SETUP Setup,
254 * evregion - Operation region support
257 AcpiEvInitializeOpRegions (
261 AcpiEvAddressSpaceDispatch (
262 ACPI_OPERAND_OBJECT *RegionObj,
263 ACPI_OPERAND_OBJECT *FieldObj,
271 ACPI_OPERAND_OBJECT *HandlerObj,
272 ACPI_OPERAND_OBJECT *RegionObj,
273 BOOLEAN AcpiNsIsLocked);
277 ACPI_OPERAND_OBJECT *RegionObj,
278 BOOLEAN AcpiNsIsLocked);
281 AcpiEvExecuteRegMethods (
282 ACPI_NAMESPACE_NODE *Node,
283 ACPI_ADR_SPACE_TYPE SpaceId,
287 AcpiEvExecuteRegMethod (
288 ACPI_OPERAND_OBJECT *RegionObj,
293 * evregini - Region initialization and setup
296 AcpiEvSystemMemoryRegionSetup (
299 void *HandlerContext,
300 void **RegionContext);
303 AcpiEvIoSpaceRegionSetup (
306 void *HandlerContext,
307 void **RegionContext);
310 AcpiEvPciConfigRegionSetup (
313 void *HandlerContext,
314 void **RegionContext);
317 AcpiEvCmosRegionSetup (
320 void *HandlerContext,
321 void **RegionContext);
324 AcpiEvPciBarRegionSetup (
327 void *HandlerContext,
328 void **RegionContext);
331 AcpiEvDefaultRegionSetup (
334 void *HandlerContext,
335 void **RegionContext);
338 AcpiEvInitializeRegion (
339 ACPI_OPERAND_OBJECT *RegionObj);
343 * evsci - SCI (System Control Interrupt) handling/dispatch
345 UINT32 ACPI_SYSTEM_XFACE
346 AcpiEvGpeXruptHandler (
354 AcpiEvInstallSciHandler (
358 AcpiEvRemoveAllSciHandlers (
361 ACPI_HW_DEPENDENT_RETURN_VOID (
366 #endif /* __ACEVENTS_H__ */