1 /****************************************************************************** 2 * 3 * Module Name: evxfevnt - External Interfaces, ACPI event disable/enable 4 * 5 *****************************************************************************/ 6 7 /* 8 * Copyright (C) 2000 - 2016, 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 #define EXPORT_ACPI_INTERFACES 45 46 #include "acpi.h" 47 #include "accommon.h" 48 #include "actables.h" 49 50 #define _COMPONENT ACPI_EVENTS 51 ACPI_MODULE_NAME ("evxfevnt") 52 53 54 #if (!ACPI_REDUCED_HARDWARE) /* Entire module */ 55 /******************************************************************************* 56 * 57 * FUNCTION: AcpiEnable 58 * 59 * PARAMETERS: None 60 * 61 * RETURN: Status 62 * 63 * DESCRIPTION: Transfers the system into ACPI mode. 64 * 65 ******************************************************************************/ 66 67 ACPI_STATUS 68 AcpiEnable ( 69 void) 70 { 71 ACPI_STATUS Status = AE_OK; 72 73 74 ACPI_FUNCTION_TRACE (AcpiEnable); 75 76 77 /* ACPI tables must be present */ 78 79 if (AcpiGbl_FadtIndex == ACPI_INVALID_TABLE_INDEX) 80 { 81 return_ACPI_STATUS (AE_NO_ACPI_TABLES); 82 } 83 84 /* If the Hardware Reduced flag is set, machine is always in acpi mode */ 85 86 if (AcpiGbl_ReducedHardware) 87 { 88 return_ACPI_STATUS (AE_OK); 89 } 90 91 /* Check current mode */ 92 93 if (AcpiHwGetMode() == ACPI_SYS_MODE_ACPI) 94 { 95 ACPI_DEBUG_PRINT ((ACPI_DB_INIT, 96 "System is already in ACPI mode\n")); 97 } 98 else 99 { 100 /* Transition to ACPI mode */ 101 102 Status = AcpiHwSetMode (ACPI_SYS_MODE_ACPI); 103 if (ACPI_FAILURE (Status)) 104 { 105 ACPI_ERROR ((AE_INFO, "Could not transition to ACPI mode")); 106 return_ACPI_STATUS (Status); 107 } 108 109 ACPI_DEBUG_PRINT ((ACPI_DB_INIT, 110 "Transition to ACPI mode successful\n")); 111 } 112 113 return_ACPI_STATUS (Status); 114 } 115 116 ACPI_EXPORT_SYMBOL (AcpiEnable) 117 118 119 /******************************************************************************* 120 * 121 * FUNCTION: AcpiDisable 122 * 123 * PARAMETERS: None 124 * 125 * RETURN: Status 126 * 127 * DESCRIPTION: Transfers the system into LEGACY (non-ACPI) mode. 128 * 129 ******************************************************************************/ 130 131 ACPI_STATUS 132 AcpiDisable ( 133 void) 134 { 135 ACPI_STATUS Status = AE_OK; 136 137 138 ACPI_FUNCTION_TRACE (AcpiDisable); 139 140 141 /* If the Hardware Reduced flag is set, machine is always in acpi mode */ 142 143 if (AcpiGbl_ReducedHardware) 144 { 145 return_ACPI_STATUS (AE_OK); 146 } 147 148 if (AcpiHwGetMode() == ACPI_SYS_MODE_LEGACY) 149 { 150 ACPI_DEBUG_PRINT ((ACPI_DB_INIT, 151 "System is already in legacy (non-ACPI) mode\n")); 152 } 153 else 154 { 155 /* Transition to LEGACY mode */ 156 157 Status = AcpiHwSetMode (ACPI_SYS_MODE_LEGACY); 158 159 if (ACPI_FAILURE (Status)) 160 { 161 ACPI_ERROR ((AE_INFO, 162 "Could not exit ACPI mode to legacy mode")); 163 return_ACPI_STATUS (Status); 164 } 165 166 ACPI_DEBUG_PRINT ((ACPI_DB_INIT, 167 "ACPI mode disabled\n")); 168 } 169 170 return_ACPI_STATUS (Status); 171 } 172 173 ACPI_EXPORT_SYMBOL (AcpiDisable) 174 175 176 /******************************************************************************* 177 * 178 * FUNCTION: AcpiEnableEvent 179 * 180 * PARAMETERS: Event - The fixed eventto be enabled 181 * Flags - Reserved 182 * 183 * RETURN: Status 184 * 185 * DESCRIPTION: Enable an ACPI event (fixed) 186 * 187 ******************************************************************************/ 188 189 ACPI_STATUS 190 AcpiEnableEvent ( 191 UINT32 Event, 192 UINT32 Flags) 193 { 194 ACPI_STATUS Status = AE_OK; 195 UINT32 Value; 196 197 198 ACPI_FUNCTION_TRACE (AcpiEnableEvent); 199 200 201 /* Decode the Fixed Event */ 202 203 if (Event > ACPI_EVENT_MAX) 204 { 205 return_ACPI_STATUS (AE_BAD_PARAMETER); 206 } 207 208 /* 209 * Enable the requested fixed event (by writing a one to the enable 210 * register bit) 211 */ 212 Status = AcpiWriteBitRegister ( 213 AcpiGbl_FixedEventInfo[Event].EnableRegisterId, 214 ACPI_ENABLE_EVENT); 215 if (ACPI_FAILURE (Status)) 216 { 217 return_ACPI_STATUS (Status); 218 } 219 220 /* Make sure that the hardware responded */ 221 222 Status = AcpiReadBitRegister ( 223 AcpiGbl_FixedEventInfo[Event].EnableRegisterId, &Value); 224 if (ACPI_FAILURE (Status)) 225 { 226 return_ACPI_STATUS (Status); 227 } 228 229 if (Value != 1) 230 { 231 ACPI_ERROR ((AE_INFO, 232 "Could not enable %s event", AcpiUtGetEventName (Event))); 233 return_ACPI_STATUS (AE_NO_HARDWARE_RESPONSE); 234 } 235 236 return_ACPI_STATUS (Status); 237 } 238 239 ACPI_EXPORT_SYMBOL (AcpiEnableEvent) 240 241 242 /******************************************************************************* 243 * 244 * FUNCTION: AcpiDisableEvent 245 * 246 * PARAMETERS: Event - The fixed event to be disabled 247 * Flags - Reserved 248 * 249 * RETURN: Status 250 * 251 * DESCRIPTION: Disable an ACPI event (fixed) 252 * 253 ******************************************************************************/ 254 255 ACPI_STATUS 256 AcpiDisableEvent ( 257 UINT32 Event, 258 UINT32 Flags) 259 { 260 ACPI_STATUS Status = AE_OK; 261 UINT32 Value; 262 263 264 ACPI_FUNCTION_TRACE (AcpiDisableEvent); 265 266 267 /* Decode the Fixed Event */ 268 269 if (Event > ACPI_EVENT_MAX) 270 { 271 return_ACPI_STATUS (AE_BAD_PARAMETER); 272 } 273 274 /* 275 * Disable the requested fixed event (by writing a zero to the enable 276 * register bit) 277 */ 278 Status = AcpiWriteBitRegister ( 279 AcpiGbl_FixedEventInfo[Event].EnableRegisterId, 280 ACPI_DISABLE_EVENT); 281 if (ACPI_FAILURE (Status)) 282 { 283 return_ACPI_STATUS (Status); 284 } 285 286 Status = AcpiReadBitRegister ( 287 AcpiGbl_FixedEventInfo[Event].EnableRegisterId, &Value); 288 if (ACPI_FAILURE (Status)) 289 { 290 return_ACPI_STATUS (Status); 291 } 292 293 if (Value != 0) 294 { 295 ACPI_ERROR ((AE_INFO, 296 "Could not disable %s events", AcpiUtGetEventName (Event))); 297 return_ACPI_STATUS (AE_NO_HARDWARE_RESPONSE); 298 } 299 300 return_ACPI_STATUS (Status); 301 } 302 303 ACPI_EXPORT_SYMBOL (AcpiDisableEvent) 304 305 306 /******************************************************************************* 307 * 308 * FUNCTION: AcpiClearEvent 309 * 310 * PARAMETERS: Event - The fixed event to be cleared 311 * 312 * RETURN: Status 313 * 314 * DESCRIPTION: Clear an ACPI event (fixed) 315 * 316 ******************************************************************************/ 317 318 ACPI_STATUS 319 AcpiClearEvent ( 320 UINT32 Event) 321 { 322 ACPI_STATUS Status = AE_OK; 323 324 325 ACPI_FUNCTION_TRACE (AcpiClearEvent); 326 327 328 /* Decode the Fixed Event */ 329 330 if (Event > ACPI_EVENT_MAX) 331 { 332 return_ACPI_STATUS (AE_BAD_PARAMETER); 333 } 334 335 /* 336 * Clear the requested fixed event (By writing a one to the status 337 * register bit) 338 */ 339 Status = AcpiWriteBitRegister ( 340 AcpiGbl_FixedEventInfo[Event].StatusRegisterId, 341 ACPI_CLEAR_STATUS); 342 343 return_ACPI_STATUS (Status); 344 } 345 346 ACPI_EXPORT_SYMBOL (AcpiClearEvent) 347 348 349 /******************************************************************************* 350 * 351 * FUNCTION: AcpiGetEventStatus 352 * 353 * PARAMETERS: Event - The fixed event 354 * EventStatus - Where the current status of the event will 355 * be returned 356 * 357 * RETURN: Status 358 * 359 * DESCRIPTION: Obtains and returns the current status of the event 360 * 361 ******************************************************************************/ 362 363 ACPI_STATUS 364 AcpiGetEventStatus ( 365 UINT32 Event, 366 ACPI_EVENT_STATUS *EventStatus) 367 { 368 ACPI_STATUS Status; 369 ACPI_EVENT_STATUS LocalEventStatus = 0; 370 UINT32 InByte; 371 372 373 ACPI_FUNCTION_TRACE (AcpiGetEventStatus); 374 375 376 if (!EventStatus) 377 { 378 return_ACPI_STATUS (AE_BAD_PARAMETER); 379 } 380 381 /* Decode the Fixed Event */ 382 383 if (Event > ACPI_EVENT_MAX) 384 { 385 return_ACPI_STATUS (AE_BAD_PARAMETER); 386 } 387 388 /* Fixed event currently can be dispatched? */ 389 390 if (AcpiGbl_FixedEventHandlers[Event].Handler) 391 { 392 LocalEventStatus |= ACPI_EVENT_FLAG_HAS_HANDLER; 393 } 394 395 /* Fixed event currently enabled? */ 396 397 Status = AcpiReadBitRegister ( 398 AcpiGbl_FixedEventInfo[Event].EnableRegisterId, &InByte); 399 if (ACPI_FAILURE (Status)) 400 { 401 return_ACPI_STATUS (Status); 402 } 403 404 if (InByte) 405 { 406 LocalEventStatus |= 407 (ACPI_EVENT_FLAG_ENABLED | ACPI_EVENT_FLAG_ENABLE_SET); 408 } 409 410 /* Fixed event currently active? */ 411 412 Status = AcpiReadBitRegister ( 413 AcpiGbl_FixedEventInfo[Event].StatusRegisterId, &InByte); 414 if (ACPI_FAILURE (Status)) 415 { 416 return_ACPI_STATUS (Status); 417 } 418 419 if (InByte) 420 { 421 LocalEventStatus |= ACPI_EVENT_FLAG_STATUS_SET; 422 } 423 424 (*EventStatus) = LocalEventStatus; 425 return_ACPI_STATUS (AE_OK); 426 } 427 428 ACPI_EXPORT_SYMBOL (AcpiGetEventStatus) 429 430 #endif /* !ACPI_REDUCED_HARDWARE */ 431