1 // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 2 /******************************************************************************* 3 * 4 * Module Name: evsci - System Control Interrupt configuration and 5 * legacy to ACPI mode state transition functions 6 * 7 ******************************************************************************/ 8 9 #include <acpi/acpi.h> 10 #include "accommon.h" 11 #include "acevents.h" 12 13 #define _COMPONENT ACPI_EVENTS 14 ACPI_MODULE_NAME("evsci") 15 #if (!ACPI_REDUCED_HARDWARE) /* Entire module */ 16 /* Local prototypes */ 17 static u32 ACPI_SYSTEM_XFACE acpi_ev_sci_xrupt_handler(void *context); 18 19 /******************************************************************************* 20 * 21 * FUNCTION: acpi_ev_sci_dispatch 22 * 23 * PARAMETERS: None 24 * 25 * RETURN: Status code indicates whether interrupt was handled. 26 * 27 * DESCRIPTION: Dispatch the SCI to all host-installed SCI handlers. 28 * 29 ******************************************************************************/ 30 acpi_ev_sci_dispatch(void)31u32 acpi_ev_sci_dispatch(void) 32 { 33 struct acpi_sci_handler_info *sci_handler; 34 acpi_cpu_flags flags; 35 u32 int_status = ACPI_INTERRUPT_NOT_HANDLED; 36 37 ACPI_FUNCTION_NAME(ev_sci_dispatch); 38 39 /* Are there any host-installed SCI handlers? */ 40 41 if (!acpi_gbl_sci_handler_list) { 42 return (int_status); 43 } 44 45 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 46 47 /* Invoke all host-installed SCI handlers */ 48 49 sci_handler = acpi_gbl_sci_handler_list; 50 while (sci_handler) { 51 52 /* Invoke the installed handler (at interrupt level) */ 53 54 int_status |= sci_handler->address(sci_handler->context); 55 56 sci_handler = sci_handler->next; 57 } 58 59 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 60 return (int_status); 61 } 62 63 /******************************************************************************* 64 * 65 * FUNCTION: acpi_ev_sci_xrupt_handler 66 * 67 * PARAMETERS: context - Calling Context 68 * 69 * RETURN: Status code indicates whether interrupt was handled. 70 * 71 * DESCRIPTION: Interrupt handler that will figure out what function or 72 * control method to call to deal with a SCI. 73 * 74 ******************************************************************************/ 75 acpi_ev_sci_xrupt_handler(void * context)76static u32 ACPI_SYSTEM_XFACE acpi_ev_sci_xrupt_handler(void *context) 77 { 78 struct acpi_gpe_xrupt_info *gpe_xrupt_list = context; 79 u32 interrupt_handled = ACPI_INTERRUPT_NOT_HANDLED; 80 81 ACPI_FUNCTION_TRACE(ev_sci_xrupt_handler); 82 83 /* 84 * We are guaranteed by the ACPICA initialization/shutdown code that 85 * if this interrupt handler is installed, ACPI is enabled. 86 */ 87 88 /* 89 * Fixed Events: 90 * Check for and dispatch any Fixed Events that have occurred 91 */ 92 interrupt_handled |= acpi_ev_fixed_event_detect(); 93 94 /* 95 * General Purpose Events: 96 * Check for and dispatch any GPEs that have occurred 97 */ 98 interrupt_handled |= acpi_ev_gpe_detect(gpe_xrupt_list); 99 100 /* Invoke all host-installed SCI handlers */ 101 102 interrupt_handled |= acpi_ev_sci_dispatch(); 103 104 acpi_sci_count++; 105 return_UINT32(interrupt_handled); 106 } 107 108 /******************************************************************************* 109 * 110 * FUNCTION: acpi_ev_gpe_xrupt_handler 111 * 112 * PARAMETERS: context - Calling Context 113 * 114 * RETURN: Status code indicates whether interrupt was handled. 115 * 116 * DESCRIPTION: Handler for GPE Block Device interrupts 117 * 118 ******************************************************************************/ 119 acpi_ev_gpe_xrupt_handler(void * context)120u32 ACPI_SYSTEM_XFACE acpi_ev_gpe_xrupt_handler(void *context) 121 { 122 struct acpi_gpe_xrupt_info *gpe_xrupt_list = context; 123 u32 interrupt_handled = ACPI_INTERRUPT_NOT_HANDLED; 124 125 ACPI_FUNCTION_TRACE(ev_gpe_xrupt_handler); 126 127 /* 128 * We are guaranteed by the ACPICA initialization/shutdown code that 129 * if this interrupt handler is installed, ACPI is enabled. 130 */ 131 132 /* GPEs: Check for and dispatch any GPEs that have occurred */ 133 134 interrupt_handled |= acpi_ev_gpe_detect(gpe_xrupt_list); 135 return_UINT32(interrupt_handled); 136 } 137 138 /****************************************************************************** 139 * 140 * FUNCTION: acpi_ev_install_sci_handler 141 * 142 * PARAMETERS: none 143 * 144 * RETURN: Status 145 * 146 * DESCRIPTION: Installs SCI handler. 147 * 148 ******************************************************************************/ 149 acpi_ev_install_sci_handler(void)150u32 acpi_ev_install_sci_handler(void) 151 { 152 u32 status = AE_OK; 153 154 ACPI_FUNCTION_TRACE(ev_install_sci_handler); 155 156 status = 157 acpi_os_install_interrupt_handler((u32) acpi_gbl_FADT.sci_interrupt, 158 acpi_ev_sci_xrupt_handler, 159 acpi_gbl_gpe_xrupt_list_head); 160 return_ACPI_STATUS(status); 161 } 162 163 /****************************************************************************** 164 * 165 * FUNCTION: acpi_ev_remove_all_sci_handlers 166 * 167 * PARAMETERS: none 168 * 169 * RETURN: AE_OK if handler uninstalled, AE_ERROR if handler was not 170 * installed to begin with 171 * 172 * DESCRIPTION: Remove the SCI interrupt handler. No further SCIs will be 173 * taken. Remove all host-installed SCI handlers. 174 * 175 * Note: It doesn't seem important to disable all events or set the event 176 * enable registers to their original values. The OS should disable 177 * the SCI interrupt level when the handler is removed, so no more 178 * events will come in. 179 * 180 ******************************************************************************/ 181 acpi_ev_remove_all_sci_handlers(void)182acpi_status acpi_ev_remove_all_sci_handlers(void) 183 { 184 struct acpi_sci_handler_info *sci_handler; 185 acpi_cpu_flags flags; 186 acpi_status status; 187 188 ACPI_FUNCTION_TRACE(ev_remove_all_sci_handlers); 189 190 /* Just let the OS remove the handler and disable the level */ 191 192 status = 193 acpi_os_remove_interrupt_handler((u32) acpi_gbl_FADT.sci_interrupt, 194 acpi_ev_sci_xrupt_handler); 195 196 if (!acpi_gbl_sci_handler_list) { 197 return (status); 198 } 199 200 flags = acpi_os_acquire_lock(acpi_gbl_gpe_lock); 201 202 /* Free all host-installed SCI handlers */ 203 204 while (acpi_gbl_sci_handler_list) { 205 sci_handler = acpi_gbl_sci_handler_list; 206 acpi_gbl_sci_handler_list = sci_handler->next; 207 ACPI_FREE(sci_handler); 208 } 209 210 acpi_os_release_lock(acpi_gbl_gpe_lock, flags); 211 return_ACPI_STATUS(status); 212 } 213 214 #endif /* !ACPI_REDUCED_HARDWARE */ 215