1 /******************************************************************************
2 *
3 * Module Name: evxfevnt - External Interfaces, ACPI event disable/enable
4 *
5 *****************************************************************************/
6
7 /*
8 * Copyright (C) 2000 - 2011, Intel Corp.
9 * All rights reserved.
10 *
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
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.
25 *
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.
29 *
30 * NO WARRANTY
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.
42 */
43
44 #include <acpi/acpi.h>
45 #include "accommon.h"
46 #include "actables.h"
47
48 #define _COMPONENT ACPI_EVENTS
49 ACPI_MODULE_NAME("evxfevnt")
50
51 /*******************************************************************************
52 *
53 * FUNCTION: acpi_enable
54 *
55 * PARAMETERS: None
56 *
57 * RETURN: Status
58 *
59 * DESCRIPTION: Transfers the system into ACPI mode.
60 *
61 ******************************************************************************/
62
acpi_enable(void)63 acpi_status acpi_enable(void)
64 {
65 acpi_status status;
66 int retry;
67
68 ACPI_FUNCTION_TRACE(acpi_enable);
69
70 /* ACPI tables must be present */
71
72 if (!acpi_tb_tables_loaded()) {
73 return_ACPI_STATUS(AE_NO_ACPI_TABLES);
74 }
75
76 /* Check current mode */
77
78 if (acpi_hw_get_mode() == ACPI_SYS_MODE_ACPI) {
79 ACPI_DEBUG_PRINT((ACPI_DB_INIT,
80 "System is already in ACPI mode\n"));
81 return_ACPI_STATUS(AE_OK);
82 }
83
84 /* Transition to ACPI mode */
85
86 status = acpi_hw_set_mode(ACPI_SYS_MODE_ACPI);
87 if (ACPI_FAILURE(status)) {
88 ACPI_ERROR((AE_INFO,
89 "Could not transition to ACPI mode"));
90 return_ACPI_STATUS(status);
91 }
92
93 /* Sanity check that transition succeeded */
94
95 for (retry = 0; retry < 30000; ++retry) {
96 if (acpi_hw_get_mode() == ACPI_SYS_MODE_ACPI) {
97 if (retry != 0)
98 ACPI_WARNING((AE_INFO,
99 "Platform took > %d00 usec to enter ACPI mode", retry));
100 return_ACPI_STATUS(AE_OK);
101 }
102 acpi_os_stall(100); /* 100 usec */
103 }
104
105 ACPI_ERROR((AE_INFO, "Hardware did not enter ACPI mode"));
106 return_ACPI_STATUS(AE_NO_HARDWARE_RESPONSE);
107 }
108
ACPI_EXPORT_SYMBOL(acpi_enable)109 ACPI_EXPORT_SYMBOL(acpi_enable)
110
111 /*******************************************************************************
112 *
113 * FUNCTION: acpi_disable
114 *
115 * PARAMETERS: None
116 *
117 * RETURN: Status
118 *
119 * DESCRIPTION: Transfers the system into LEGACY (non-ACPI) mode.
120 *
121 ******************************************************************************/
122 acpi_status acpi_disable(void)
123 {
124 acpi_status status = AE_OK;
125
126 ACPI_FUNCTION_TRACE(acpi_disable);
127
128 if (acpi_hw_get_mode() == ACPI_SYS_MODE_LEGACY) {
129 ACPI_DEBUG_PRINT((ACPI_DB_INIT,
130 "System is already in legacy (non-ACPI) mode\n"));
131 } else {
132 /* Transition to LEGACY mode */
133
134 status = acpi_hw_set_mode(ACPI_SYS_MODE_LEGACY);
135
136 if (ACPI_FAILURE(status)) {
137 ACPI_ERROR((AE_INFO,
138 "Could not exit ACPI mode to legacy mode"));
139 return_ACPI_STATUS(status);
140 }
141
142 ACPI_DEBUG_PRINT((ACPI_DB_INIT, "ACPI mode disabled\n"));
143 }
144
145 return_ACPI_STATUS(status);
146 }
147
ACPI_EXPORT_SYMBOL(acpi_disable)148 ACPI_EXPORT_SYMBOL(acpi_disable)
149
150 /*******************************************************************************
151 *
152 * FUNCTION: acpi_enable_event
153 *
154 * PARAMETERS: Event - The fixed eventto be enabled
155 * Flags - Reserved
156 *
157 * RETURN: Status
158 *
159 * DESCRIPTION: Enable an ACPI event (fixed)
160 *
161 ******************************************************************************/
162 acpi_status acpi_enable_event(u32 event, u32 flags)
163 {
164 acpi_status status = AE_OK;
165 u32 value;
166
167 ACPI_FUNCTION_TRACE(acpi_enable_event);
168
169 /* Decode the Fixed Event */
170
171 if (event > ACPI_EVENT_MAX) {
172 return_ACPI_STATUS(AE_BAD_PARAMETER);
173 }
174
175 /*
176 * Enable the requested fixed event (by writing a one to the enable
177 * register bit)
178 */
179 status =
180 acpi_write_bit_register(acpi_gbl_fixed_event_info[event].
181 enable_register_id, ACPI_ENABLE_EVENT);
182 if (ACPI_FAILURE(status)) {
183 return_ACPI_STATUS(status);
184 }
185
186 /* Make sure that the hardware responded */
187
188 status =
189 acpi_read_bit_register(acpi_gbl_fixed_event_info[event].
190 enable_register_id, &value);
191 if (ACPI_FAILURE(status)) {
192 return_ACPI_STATUS(status);
193 }
194
195 if (value != 1) {
196 ACPI_ERROR((AE_INFO,
197 "Could not enable %s event",
198 acpi_ut_get_event_name(event)));
199 return_ACPI_STATUS(AE_NO_HARDWARE_RESPONSE);
200 }
201
202 return_ACPI_STATUS(status);
203 }
204
ACPI_EXPORT_SYMBOL(acpi_enable_event)205 ACPI_EXPORT_SYMBOL(acpi_enable_event)
206
207 /*******************************************************************************
208 *
209 * FUNCTION: acpi_disable_event
210 *
211 * PARAMETERS: Event - The fixed eventto be enabled
212 * Flags - Reserved
213 *
214 * RETURN: Status
215 *
216 * DESCRIPTION: Disable an ACPI event (fixed)
217 *
218 ******************************************************************************/
219 acpi_status acpi_disable_event(u32 event, u32 flags)
220 {
221 acpi_status status = AE_OK;
222 u32 value;
223
224 ACPI_FUNCTION_TRACE(acpi_disable_event);
225
226 /* Decode the Fixed Event */
227
228 if (event > ACPI_EVENT_MAX) {
229 return_ACPI_STATUS(AE_BAD_PARAMETER);
230 }
231
232 /*
233 * Disable the requested fixed event (by writing a zero to the enable
234 * register bit)
235 */
236 status =
237 acpi_write_bit_register(acpi_gbl_fixed_event_info[event].
238 enable_register_id, ACPI_DISABLE_EVENT);
239 if (ACPI_FAILURE(status)) {
240 return_ACPI_STATUS(status);
241 }
242
243 status =
244 acpi_read_bit_register(acpi_gbl_fixed_event_info[event].
245 enable_register_id, &value);
246 if (ACPI_FAILURE(status)) {
247 return_ACPI_STATUS(status);
248 }
249
250 if (value != 0) {
251 ACPI_ERROR((AE_INFO,
252 "Could not disable %s events",
253 acpi_ut_get_event_name(event)));
254 return_ACPI_STATUS(AE_NO_HARDWARE_RESPONSE);
255 }
256
257 return_ACPI_STATUS(status);
258 }
259
ACPI_EXPORT_SYMBOL(acpi_disable_event)260 ACPI_EXPORT_SYMBOL(acpi_disable_event)
261
262 /*******************************************************************************
263 *
264 * FUNCTION: acpi_clear_event
265 *
266 * PARAMETERS: Event - The fixed event to be cleared
267 *
268 * RETURN: Status
269 *
270 * DESCRIPTION: Clear an ACPI event (fixed)
271 *
272 ******************************************************************************/
273 acpi_status acpi_clear_event(u32 event)
274 {
275 acpi_status status = AE_OK;
276
277 ACPI_FUNCTION_TRACE(acpi_clear_event);
278
279 /* Decode the Fixed Event */
280
281 if (event > ACPI_EVENT_MAX) {
282 return_ACPI_STATUS(AE_BAD_PARAMETER);
283 }
284
285 /*
286 * Clear the requested fixed event (By writing a one to the status
287 * register bit)
288 */
289 status =
290 acpi_write_bit_register(acpi_gbl_fixed_event_info[event].
291 status_register_id, ACPI_CLEAR_STATUS);
292
293 return_ACPI_STATUS(status);
294 }
295
ACPI_EXPORT_SYMBOL(acpi_clear_event)296 ACPI_EXPORT_SYMBOL(acpi_clear_event)
297
298 /*******************************************************************************
299 *
300 * FUNCTION: acpi_get_event_status
301 *
302 * PARAMETERS: Event - The fixed event
303 * event_status - Where the current status of the event will
304 * be returned
305 *
306 * RETURN: Status
307 *
308 * DESCRIPTION: Obtains and returns the current status of the event
309 *
310 ******************************************************************************/
311 acpi_status acpi_get_event_status(u32 event, acpi_event_status * event_status)
312 {
313 acpi_status status = AE_OK;
314 u32 value;
315
316 ACPI_FUNCTION_TRACE(acpi_get_event_status);
317
318 if (!event_status) {
319 return_ACPI_STATUS(AE_BAD_PARAMETER);
320 }
321
322 /* Decode the Fixed Event */
323
324 if (event > ACPI_EVENT_MAX) {
325 return_ACPI_STATUS(AE_BAD_PARAMETER);
326 }
327
328 /* Get the status of the requested fixed event */
329
330 status =
331 acpi_read_bit_register(acpi_gbl_fixed_event_info[event].
332 enable_register_id, &value);
333 if (ACPI_FAILURE(status))
334 return_ACPI_STATUS(status);
335
336 *event_status = value;
337
338 status =
339 acpi_read_bit_register(acpi_gbl_fixed_event_info[event].
340 status_register_id, &value);
341 if (ACPI_FAILURE(status))
342 return_ACPI_STATUS(status);
343
344 if (value)
345 *event_status |= ACPI_EVENT_FLAG_SET;
346
347 if (acpi_gbl_fixed_event_handlers[event].handler)
348 *event_status |= ACPI_EVENT_FLAG_HANDLE;
349
350 return_ACPI_STATUS(status);
351 }
352
353 ACPI_EXPORT_SYMBOL(acpi_get_event_status)
354