2 /******************************************************************************
4 * Module Name: hwgpe - Low level GPE enable/disable/clear functions
6 *****************************************************************************/
9 * Copyright (C) 2000 - 2006, R. Byron Moore
10 * All rights reserved.
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
15 * 1. Redistributions of source code must retain the above copyright
16 * notice, this list of conditions, and the following disclaimer,
17 * without modification.
18 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
19 * substantially similar to the "NO WARRANTY" disclaimer below
20 * ("Disclaimer") and any redistribution must be conditioned upon
21 * including a substantially similar Disclaimer requirement for further
22 * binary redistribution.
23 * 3. Neither the names of the above-listed copyright holders nor the names
24 * of any contributors may be used to endorse or promote products derived
25 * from this software without specific prior written permission.
27 * Alternatively, this software may be distributed under the terms of the
28 * GNU General Public License ("GPL") version 2 as published by the Free
29 * Software Foundation.
32 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
33 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
34 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
35 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
36 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
37 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
38 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
39 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
40 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
41 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
42 * POSSIBILITY OF SUCH DAMAGES.
45 #include <acpi/acpi.h>
46 #include <acpi/acevents.h>
48 #define _COMPONENT ACPI_HARDWARE
49 ACPI_MODULE_NAME("hwgpe")
51 /* Local prototypes */
53 acpi_hw_enable_wakeup_gpe_block(struct acpi_gpe_xrupt_info *gpe_xrupt_info,
54 struct acpi_gpe_block_info *gpe_block);
56 /******************************************************************************
58 * FUNCTION: acpi_hw_write_gpe_enable_reg
60 * PARAMETERS: gpe_event_info - Info block for the GPE to be enabled
64 * DESCRIPTION: Write a GPE enable register. Note: The bit for this GPE must
65 * already be cleared or set in the parent register
66 * enable_for_run mask.
68 ******************************************************************************/
71 acpi_hw_write_gpe_enable_reg(struct acpi_gpe_event_info *gpe_event_info)
73 struct acpi_gpe_register_info *gpe_register_info;
76 ACPI_FUNCTION_ENTRY();
78 /* Get the info block for the entire GPE register */
80 gpe_register_info = gpe_event_info->register_info;
81 if (!gpe_register_info) {
82 return (AE_NOT_EXIST);
85 /* Write the entire GPE (runtime) enable register */
87 status = acpi_hw_low_level_write(8, gpe_register_info->enable_for_run,
88 &gpe_register_info->enable_address);
93 /******************************************************************************
95 * FUNCTION: acpi_hw_clear_gpe
97 * PARAMETERS: gpe_event_info - Info block for the GPE to be cleared
101 * DESCRIPTION: Clear the status bit for a single GPE.
103 ******************************************************************************/
105 acpi_status acpi_hw_clear_gpe(struct acpi_gpe_event_info * gpe_event_info)
109 ACPI_FUNCTION_ENTRY();
112 * Write a one to the appropriate bit in the status register to
115 status = acpi_hw_low_level_write(8, gpe_event_info->register_bit,
116 &gpe_event_info->register_info->
122 /******************************************************************************
124 * FUNCTION: acpi_hw_get_gpe_status
126 * PARAMETERS: gpe_event_info - Info block for the GPE to queried
127 * event_status - Where the GPE status is returned
131 * DESCRIPTION: Return the status of a single GPE.
133 ******************************************************************************/
135 #ifdef ACPI_FUTURE_USAGE
137 acpi_hw_get_gpe_status(struct acpi_gpe_event_info * gpe_event_info,
138 acpi_event_status * event_status)
142 struct acpi_gpe_register_info *gpe_register_info;
144 acpi_event_status local_event_status = 0;
146 ACPI_FUNCTION_ENTRY();
149 return (AE_BAD_PARAMETER);
152 /* Get the info block for the entire GPE register */
154 gpe_register_info = gpe_event_info->register_info;
156 /* Get the register bitmask for this GPE */
158 register_bit = gpe_event_info->register_bit;
160 /* GPE currently enabled? (enabled for runtime?) */
162 if (register_bit & gpe_register_info->enable_for_run) {
163 local_event_status |= ACPI_EVENT_FLAG_ENABLED;
166 /* GPE enabled for wake? */
168 if (register_bit & gpe_register_info->enable_for_wake) {
169 local_event_status |= ACPI_EVENT_FLAG_WAKE_ENABLED;
172 /* GPE currently active (status bit == 1)? */
175 acpi_hw_low_level_read(8, &in_byte,
176 &gpe_register_info->status_address);
177 if (ACPI_FAILURE(status)) {
178 goto unlock_and_exit;
181 if (register_bit & in_byte) {
182 local_event_status |= ACPI_EVENT_FLAG_SET;
185 /* Set return value */
187 (*event_status) = local_event_status;
192 #endif /* ACPI_FUTURE_USAGE */
194 /******************************************************************************
196 * FUNCTION: acpi_hw_disable_gpe_block
198 * PARAMETERS: gpe_xrupt_info - GPE Interrupt info
199 * gpe_block - Gpe Block info
203 * DESCRIPTION: Disable all GPEs within a single GPE block
205 ******************************************************************************/
208 acpi_hw_disable_gpe_block(struct acpi_gpe_xrupt_info * gpe_xrupt_info,
209 struct acpi_gpe_block_info * gpe_block)
214 /* Examine each GPE Register within the block */
216 for (i = 0; i < gpe_block->register_count; i++) {
218 /* Disable all GPEs in this register */
220 status = acpi_hw_low_level_write(8, 0x00,
221 &gpe_block->register_info[i].
223 if (ACPI_FAILURE(status)) {
231 /******************************************************************************
233 * FUNCTION: acpi_hw_clear_gpe_block
235 * PARAMETERS: gpe_xrupt_info - GPE Interrupt info
236 * gpe_block - Gpe Block info
240 * DESCRIPTION: Clear status bits for all GPEs within a single GPE block
242 ******************************************************************************/
245 acpi_hw_clear_gpe_block(struct acpi_gpe_xrupt_info * gpe_xrupt_info,
246 struct acpi_gpe_block_info * gpe_block)
251 /* Examine each GPE Register within the block */
253 for (i = 0; i < gpe_block->register_count; i++) {
255 /* Clear status on all GPEs in this register */
257 status = acpi_hw_low_level_write(8, 0xFF,
258 &gpe_block->register_info[i].
260 if (ACPI_FAILURE(status)) {
268 /******************************************************************************
270 * FUNCTION: acpi_hw_enable_runtime_gpe_block
272 * PARAMETERS: gpe_xrupt_info - GPE Interrupt info
273 * gpe_block - Gpe Block info
277 * DESCRIPTION: Enable all "runtime" GPEs within a single GPE block. Includes
278 * combination wake/run GPEs.
280 ******************************************************************************/
283 acpi_hw_enable_runtime_gpe_block(struct acpi_gpe_xrupt_info * gpe_xrupt_info,
284 struct acpi_gpe_block_info * gpe_block)
289 /* NOTE: assumes that all GPEs are currently disabled */
291 /* Examine each GPE Register within the block */
293 for (i = 0; i < gpe_block->register_count; i++) {
294 if (!gpe_block->register_info[i].enable_for_run) {
298 /* Enable all "runtime" GPEs in this register */
301 acpi_hw_low_level_write(8,
302 gpe_block->register_info[i].
304 &gpe_block->register_info[i].
306 if (ACPI_FAILURE(status)) {
314 /******************************************************************************
316 * FUNCTION: acpi_hw_enable_wakeup_gpe_block
318 * PARAMETERS: gpe_xrupt_info - GPE Interrupt info
319 * gpe_block - Gpe Block info
323 * DESCRIPTION: Enable all "wake" GPEs within a single GPE block. Includes
324 * combination wake/run GPEs.
326 ******************************************************************************/
329 acpi_hw_enable_wakeup_gpe_block(struct acpi_gpe_xrupt_info *gpe_xrupt_info,
330 struct acpi_gpe_block_info *gpe_block)
335 /* Examine each GPE Register within the block */
337 for (i = 0; i < gpe_block->register_count; i++) {
338 if (!gpe_block->register_info[i].enable_for_wake) {
342 /* Enable all "wake" GPEs in this register */
344 status = acpi_hw_low_level_write(8,
345 gpe_block->register_info[i].
347 &gpe_block->register_info[i].
349 if (ACPI_FAILURE(status)) {
357 /******************************************************************************
359 * FUNCTION: acpi_hw_disable_all_gpes
365 * DESCRIPTION: Disable and clear all GPEs in all GPE blocks
367 ******************************************************************************/
369 acpi_status acpi_hw_disable_all_gpes(void)
373 ACPI_FUNCTION_TRACE(hw_disable_all_gpes);
375 status = acpi_ev_walk_gpe_list(acpi_hw_disable_gpe_block);
376 status = acpi_ev_walk_gpe_list(acpi_hw_clear_gpe_block);
377 return_ACPI_STATUS(status);
380 /******************************************************************************
382 * FUNCTION: acpi_hw_enable_all_runtime_gpes
388 * DESCRIPTION: Enable all "runtime" GPEs, in all GPE blocks
390 ******************************************************************************/
392 acpi_status acpi_hw_enable_all_runtime_gpes(void)
396 ACPI_FUNCTION_TRACE(hw_enable_all_runtime_gpes);
398 status = acpi_ev_walk_gpe_list(acpi_hw_enable_runtime_gpe_block);
399 return_ACPI_STATUS(status);
402 /******************************************************************************
404 * FUNCTION: acpi_hw_enable_all_wakeup_gpes
410 * DESCRIPTION: Enable all "wakeup" GPEs, in all GPE blocks
412 ******************************************************************************/
414 acpi_status acpi_hw_enable_all_wakeup_gpes(void)
418 ACPI_FUNCTION_TRACE(hw_enable_all_wakeup_gpes);
420 status = acpi_ev_walk_gpe_list(acpi_hw_enable_wakeup_gpe_block);
421 return_ACPI_STATUS(status);