1 /******************************************************************************
3 * Module Name: evmisc - Miscellaneous event manager support functions
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2012, 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 #include <acpi/acpi.h>
49 #define _COMPONENT ACPI_EVENTS
50 ACPI_MODULE_NAME("evmisc")
52 /* Local prototypes */
53 static void ACPI_SYSTEM_XFACE
acpi_ev_notify_dispatch(void *context
);
55 /*******************************************************************************
57 * FUNCTION: acpi_ev_is_notify_object
59 * PARAMETERS: node - Node to check
61 * RETURN: TRUE if notifies allowed on this object
63 * DESCRIPTION: Check type of node for a object that supports notifies.
65 * TBD: This could be replaced by a flag bit in the node.
67 ******************************************************************************/
69 u8
acpi_ev_is_notify_object(struct acpi_namespace_node
*node
)
72 case ACPI_TYPE_DEVICE
:
73 case ACPI_TYPE_PROCESSOR
:
74 case ACPI_TYPE_THERMAL
:
76 * These are the ONLY objects that can receive ACPI notifications
85 /*******************************************************************************
87 * FUNCTION: acpi_ev_queue_notify_request
89 * PARAMETERS: node - NS node for the notified object
90 * notify_value - Value from the Notify() request
94 * DESCRIPTION: Dispatch a device notification event to a previously
97 ******************************************************************************/
100 acpi_ev_queue_notify_request(struct acpi_namespace_node
* node
,
103 union acpi_operand_object
*obj_desc
;
104 union acpi_operand_object
*handler_list_head
= NULL
;
105 union acpi_generic_state
*info
;
106 u8 handler_list_id
= 0;
107 acpi_status status
= AE_OK
;
109 ACPI_FUNCTION_NAME(ev_queue_notify_request
);
111 /* Are Notifies allowed on this object? */
113 if (!acpi_ev_is_notify_object(node
)) {
117 /* Get the correct notify list type (System or Device) */
119 if (notify_value
<= ACPI_MAX_SYS_NOTIFY
) {
120 handler_list_id
= ACPI_SYSTEM_HANDLER_LIST
;
122 handler_list_id
= ACPI_DEVICE_HANDLER_LIST
;
125 /* Get the notify object attached to the namespace Node */
127 obj_desc
= acpi_ns_get_attached_object(node
);
130 /* We have an attached object, Get the correct handler list */
133 obj_desc
->common_notify
.notify_list
[handler_list_id
];
137 * If there is no notify handler (Global or Local)
138 * for this object, just ignore the notify
140 if (!acpi_gbl_global_notify
[handler_list_id
].handler
141 && !handler_list_head
) {
142 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
143 "No notify handler for Notify, ignoring (%4.4s, %X) node %p\n",
144 acpi_ut_get_node_name(node
), notify_value
,
150 /* Setup notify info and schedule the notify dispatcher */
152 info
= acpi_ut_create_generic_state();
154 return (AE_NO_MEMORY
);
157 info
->common
.descriptor_type
= ACPI_DESC_TYPE_STATE_NOTIFY
;
159 info
->notify
.node
= node
;
160 info
->notify
.value
= (u16
)notify_value
;
161 info
->notify
.handler_list_id
= handler_list_id
;
162 info
->notify
.handler_list_head
= handler_list_head
;
163 info
->notify
.global
= &acpi_gbl_global_notify
[handler_list_id
];
165 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
166 "Dispatching Notify on [%4.4s] (%s) Value 0x%2.2X (%s) Node %p\n",
167 acpi_ut_get_node_name(node
),
168 acpi_ut_get_type_name(node
->type
), notify_value
,
169 acpi_ut_get_notify_name(notify_value
), node
));
171 status
= acpi_os_execute(OSL_NOTIFY_HANDLER
, acpi_ev_notify_dispatch
,
173 if (ACPI_FAILURE(status
)) {
174 acpi_ut_delete_generic_state(info
);
180 /*******************************************************************************
182 * FUNCTION: acpi_ev_notify_dispatch
184 * PARAMETERS: context - To be passed to the notify handler
188 * DESCRIPTION: Dispatch a device notification event to a previously
191 ******************************************************************************/
193 static void ACPI_SYSTEM_XFACE
acpi_ev_notify_dispatch(void *context
)
195 union acpi_generic_state
*info
= (union acpi_generic_state
*)context
;
196 union acpi_operand_object
*handler_obj
;
198 ACPI_FUNCTION_ENTRY();
200 /* Invoke a global notify handler if installed */
202 if (info
->notify
.global
->handler
) {
203 info
->notify
.global
->handler(info
->notify
.node
,
205 info
->notify
.global
->context
);
208 /* Now invoke the local notify handler(s) if any are installed */
210 handler_obj
= info
->notify
.handler_list_head
;
211 while (handler_obj
) {
212 handler_obj
->notify
.handler(info
->notify
.node
,
214 handler_obj
->notify
.context
);
217 handler_obj
->notify
.next
[info
->notify
.handler_list_id
];
220 /* All done with the info object */
222 acpi_ut_delete_generic_state(info
);
225 #if (!ACPI_REDUCED_HARDWARE)
226 /******************************************************************************
228 * FUNCTION: acpi_ev_terminate
234 * DESCRIPTION: Disable events and free memory allocated for table storage.
236 ******************************************************************************/
238 void acpi_ev_terminate(void)
243 ACPI_FUNCTION_TRACE(ev_terminate
);
245 if (acpi_gbl_events_initialized
) {
247 * Disable all event-related functionality. In all cases, on error,
248 * print a message but obviously we don't abort.
251 /* Disable all fixed events */
253 for (i
= 0; i
< ACPI_NUM_FIXED_EVENTS
; i
++) {
254 status
= acpi_disable_event(i
, 0);
255 if (ACPI_FAILURE(status
)) {
257 "Could not disable fixed event %u",
262 /* Disable all GPEs in all GPE blocks */
264 status
= acpi_ev_walk_gpe_list(acpi_hw_disable_gpe_block
, NULL
);
266 /* Remove SCI handler */
268 status
= acpi_ev_remove_sci_handler();
269 if (ACPI_FAILURE(status
)) {
270 ACPI_ERROR((AE_INFO
, "Could not remove SCI handler"));
273 status
= acpi_ev_remove_global_lock_handler();
274 if (ACPI_FAILURE(status
)) {
276 "Could not remove Global Lock handler"));
280 /* Deallocate all handler objects installed within GPE info structs */
282 status
= acpi_ev_walk_gpe_list(acpi_ev_delete_gpe_handlers
, NULL
);
284 /* Return to original mode if necessary */
286 if (acpi_gbl_original_mode
== ACPI_SYS_MODE_LEGACY
) {
287 status
= acpi_disable();
288 if (ACPI_FAILURE(status
)) {
289 ACPI_WARNING((AE_INFO
, "AcpiDisable failed"));
295 #endif /* !ACPI_REDUCED_HARDWARE */