1 // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 2 /****************************************************************************** 3 * 4 * Module Name: evmisc - Miscellaneous event manager support functions 5 * 6 * Copyright (C) 2000 - 2023, Intel Corp. 7 * 8 *****************************************************************************/ 9 10 #include <acpi/acpi.h> 11 #include "accommon.h" 12 #include "acevents.h" 13 #include "acnamesp.h" 14 15 #define _COMPONENT ACPI_EVENTS 16 ACPI_MODULE_NAME("evmisc") 17 18 /* Local prototypes */ 19 static void ACPI_SYSTEM_XFACE acpi_ev_notify_dispatch(void *context); 20 21 /******************************************************************************* 22 * 23 * FUNCTION: acpi_ev_is_notify_object 24 * 25 * PARAMETERS: node - Node to check 26 * 27 * RETURN: TRUE if notifies allowed on this object 28 * 29 * DESCRIPTION: Check type of node for a object that supports notifies. 30 * 31 * TBD: This could be replaced by a flag bit in the node. 32 * 33 ******************************************************************************/ 34 35 u8 acpi_ev_is_notify_object(struct acpi_namespace_node *node) 36 { 37 38 switch (node->type) { 39 case ACPI_TYPE_DEVICE: 40 case ACPI_TYPE_PROCESSOR: 41 case ACPI_TYPE_THERMAL: 42 /* 43 * These are the ONLY objects that can receive ACPI notifications 44 */ 45 return (TRUE); 46 47 default: 48 49 return (FALSE); 50 } 51 } 52 53 /******************************************************************************* 54 * 55 * FUNCTION: acpi_ev_queue_notify_request 56 * 57 * PARAMETERS: node - NS node for the notified object 58 * notify_value - Value from the Notify() request 59 * 60 * RETURN: Status 61 * 62 * DESCRIPTION: Dispatch a device notification event to a previously 63 * installed handler. 64 * 65 ******************************************************************************/ 66 67 acpi_status 68 acpi_ev_queue_notify_request(struct acpi_namespace_node *node, u32 notify_value) 69 { 70 union acpi_operand_object *obj_desc; 71 union acpi_operand_object *handler_list_head = NULL; 72 union acpi_generic_state *info; 73 u8 handler_list_id = 0; 74 acpi_status status = AE_OK; 75 76 ACPI_FUNCTION_NAME(ev_queue_notify_request); 77 78 /* Are Notifies allowed on this object? */ 79 80 if (!acpi_ev_is_notify_object(node)) { 81 return (AE_TYPE); 82 } 83 84 /* Get the correct notify list type (System or Device) */ 85 86 if (notify_value <= ACPI_MAX_SYS_NOTIFY) { 87 handler_list_id = ACPI_SYSTEM_HANDLER_LIST; 88 } else { 89 handler_list_id = ACPI_DEVICE_HANDLER_LIST; 90 } 91 92 /* Get the notify object attached to the namespace Node */ 93 94 obj_desc = acpi_ns_get_attached_object(node); 95 if (obj_desc) { 96 97 /* We have an attached object, Get the correct handler list */ 98 99 handler_list_head = 100 obj_desc->common_notify.notify_list[handler_list_id]; 101 } 102 103 /* 104 * If there is no notify handler (Global or Local) 105 * for this object, just ignore the notify 106 */ 107 if (!acpi_gbl_global_notify[handler_list_id].handler 108 && !handler_list_head) { 109 ACPI_DEBUG_PRINT((ACPI_DB_INFO, 110 "No notify handler for Notify, ignoring (%4.4s, %X) node %p\n", 111 acpi_ut_get_node_name(node), notify_value, 112 node)); 113 114 return (AE_OK); 115 } 116 117 /* Setup notify info and schedule the notify dispatcher */ 118 119 info = acpi_ut_create_generic_state(); 120 if (!info) { 121 return (AE_NO_MEMORY); 122 } 123 124 info->common.descriptor_type = ACPI_DESC_TYPE_STATE_NOTIFY; 125 126 info->notify.node = node; 127 info->notify.value = (u16)notify_value; 128 info->notify.handler_list_id = handler_list_id; 129 info->notify.handler_list_head = handler_list_head; 130 info->notify.global = &acpi_gbl_global_notify[handler_list_id]; 131 132 ACPI_DEBUG_PRINT((ACPI_DB_INFO, 133 "Dispatching Notify on [%4.4s] (%s) Value 0x%2.2X (%s) Node %p\n", 134 acpi_ut_get_node_name(node), 135 acpi_ut_get_type_name(node->type), notify_value, 136 acpi_ut_get_notify_name(notify_value, ACPI_TYPE_ANY), 137 node)); 138 139 status = acpi_os_execute(OSL_NOTIFY_HANDLER, 140 acpi_ev_notify_dispatch, info); 141 if (ACPI_FAILURE(status)) { 142 acpi_ut_delete_generic_state(info); 143 } 144 145 return (status); 146 } 147 148 /******************************************************************************* 149 * 150 * FUNCTION: acpi_ev_notify_dispatch 151 * 152 * PARAMETERS: context - To be passed to the notify handler 153 * 154 * RETURN: None. 155 * 156 * DESCRIPTION: Dispatch a device notification event to a previously 157 * installed handler. 158 * 159 ******************************************************************************/ 160 161 static void ACPI_SYSTEM_XFACE acpi_ev_notify_dispatch(void *context) 162 { 163 union acpi_generic_state *info = (union acpi_generic_state *)context; 164 union acpi_operand_object *handler_obj; 165 166 ACPI_FUNCTION_ENTRY(); 167 168 /* Invoke a global notify handler if installed */ 169 170 if (info->notify.global->handler) { 171 info->notify.global->handler(info->notify.node, 172 info->notify.value, 173 info->notify.global->context); 174 } 175 176 /* Now invoke the local notify handler(s) if any are installed */ 177 178 handler_obj = info->notify.handler_list_head; 179 while (handler_obj) { 180 handler_obj->notify.handler(info->notify.node, 181 info->notify.value, 182 handler_obj->notify.context); 183 184 handler_obj = 185 handler_obj->notify.next[info->notify.handler_list_id]; 186 } 187 188 /* All done with the info object */ 189 190 acpi_ut_delete_generic_state(info); 191 } 192 193 #if (!ACPI_REDUCED_HARDWARE) 194 /****************************************************************************** 195 * 196 * FUNCTION: acpi_ev_terminate 197 * 198 * PARAMETERS: none 199 * 200 * RETURN: none 201 * 202 * DESCRIPTION: Disable events and free memory allocated for table storage. 203 * 204 ******************************************************************************/ 205 206 void acpi_ev_terminate(void) 207 { 208 u32 i; 209 acpi_status status; 210 211 ACPI_FUNCTION_TRACE(ev_terminate); 212 213 if (acpi_gbl_events_initialized) { 214 /* 215 * Disable all event-related functionality. In all cases, on error, 216 * print a message but obviously we don't abort. 217 */ 218 219 /* Disable all fixed events */ 220 221 for (i = 0; i < ACPI_NUM_FIXED_EVENTS; i++) { 222 status = acpi_disable_event(i, 0); 223 if (ACPI_FAILURE(status)) { 224 ACPI_ERROR((AE_INFO, 225 "Could not disable fixed event %u", 226 (u32) i)); 227 } 228 } 229 230 /* Disable all GPEs in all GPE blocks */ 231 232 status = acpi_ev_walk_gpe_list(acpi_hw_disable_gpe_block, NULL); 233 if (ACPI_FAILURE(status)) { 234 ACPI_EXCEPTION((AE_INFO, status, 235 "Could not disable GPEs in GPE block")); 236 } 237 238 status = acpi_ev_remove_global_lock_handler(); 239 if (ACPI_FAILURE(status)) { 240 ACPI_EXCEPTION((AE_INFO, status, 241 "Could not remove Global Lock handler")); 242 } 243 244 acpi_gbl_events_initialized = FALSE; 245 } 246 247 /* Remove SCI handlers */ 248 249 status = acpi_ev_remove_all_sci_handlers(); 250 if (ACPI_FAILURE(status)) { 251 ACPI_ERROR((AE_INFO, "Could not remove SCI handler")); 252 } 253 254 /* Deallocate all handler objects installed within GPE info structs */ 255 256 status = acpi_ev_walk_gpe_list(acpi_ev_delete_gpe_handlers, NULL); 257 if (ACPI_FAILURE(status)) { 258 ACPI_EXCEPTION((AE_INFO, status, 259 "Could not delete GPE handlers")); 260 } 261 262 /* Return to original mode if necessary */ 263 264 if (acpi_gbl_original_mode == ACPI_SYS_MODE_LEGACY) { 265 status = acpi_disable(); 266 if (ACPI_FAILURE(status)) { 267 ACPI_WARNING((AE_INFO, "AcpiDisable failed")); 268 } 269 } 270 return_VOID; 271 } 272 273 #endif /* !ACPI_REDUCED_HARDWARE */ 274