Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /****************************************************************************** |
| 2 | * |
| 3 | * Module Name: utxface - External interfaces for "global" ACPI functions |
| 4 | * |
| 5 | *****************************************************************************/ |
| 6 | |
| 7 | /* |
Bob Moore | 6c9deb7 | 2007-02-02 19:48:24 +0300 | [diff] [blame] | 8 | * Copyright (C) 2000 - 2007, R. Byron Moore |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 44 | #include <acpi/acpi.h> |
| 45 | #include <acpi/acevents.h> |
| 46 | #include <acpi/acnamesp.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 47 | #include <acpi/acdebug.h> |
| 48 | |
| 49 | #define _COMPONENT ACPI_UTILITIES |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 50 | ACPI_MODULE_NAME("utxface") |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 51 | |
Bob Moore | e20a679 | 2008-04-10 19:06:38 +0400 | [diff] [blame^] | 52 | #ifndef ACPI_ASL_COMPILER |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 53 | /******************************************************************************* |
| 54 | * |
| 55 | * FUNCTION: acpi_initialize_subsystem |
| 56 | * |
| 57 | * PARAMETERS: None |
| 58 | * |
| 59 | * RETURN: Status |
| 60 | * |
| 61 | * DESCRIPTION: Initializes all global variables. This is the first function |
| 62 | * called, so any early initialization belongs here. |
| 63 | * |
| 64 | ******************************************************************************/ |
Len Brown | dd272b5 | 2007-05-30 00:26:11 -0400 | [diff] [blame] | 65 | acpi_status __init acpi_initialize_subsystem(void) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 66 | { |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 67 | acpi_status status; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 68 | |
Bob Moore | b229cf9 | 2006-04-21 17:15:00 -0400 | [diff] [blame] | 69 | ACPI_FUNCTION_TRACE(acpi_initialize_subsystem); |
Robert Moore | 44f6c01 | 2005-04-18 22:49:35 -0400 | [diff] [blame] | 70 | |
Bob Moore | cb219bb | 2007-02-02 19:48:21 +0300 | [diff] [blame] | 71 | acpi_gbl_startup_flags = ACPI_SUBSYSTEM_INITIALIZE; |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 72 | ACPI_DEBUG_EXEC(acpi_ut_init_stack_ptr_trace()); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 73 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 74 | /* Initialize the OS-Dependent layer */ |
| 75 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 76 | status = acpi_os_initialize(); |
| 77 | if (ACPI_FAILURE(status)) { |
Bob Moore | b8e4d89 | 2006-01-27 16:43:00 -0500 | [diff] [blame] | 78 | ACPI_EXCEPTION((AE_INFO, status, "During OSL initialization")); |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 79 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 80 | } |
| 81 | |
Robert Moore | 73459f7 | 2005-06-24 00:00:00 -0400 | [diff] [blame] | 82 | /* Initialize all globals used by the subsystem */ |
| 83 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 84 | acpi_ut_init_globals(); |
Robert Moore | 73459f7 | 2005-06-24 00:00:00 -0400 | [diff] [blame] | 85 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 86 | /* Create the default mutex objects */ |
| 87 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 88 | status = acpi_ut_mutex_initialize(); |
| 89 | if (ACPI_FAILURE(status)) { |
Bob Moore | b8e4d89 | 2006-01-27 16:43:00 -0500 | [diff] [blame] | 90 | ACPI_EXCEPTION((AE_INFO, status, |
| 91 | "During Global Mutex creation")); |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 92 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 93 | } |
| 94 | |
| 95 | /* |
| 96 | * Initialize the namespace manager and |
| 97 | * the root of the namespace tree |
| 98 | */ |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 99 | status = acpi_ns_root_initialize(); |
| 100 | if (ACPI_FAILURE(status)) { |
Bob Moore | b8e4d89 | 2006-01-27 16:43:00 -0500 | [diff] [blame] | 101 | ACPI_EXCEPTION((AE_INFO, status, |
| 102 | "During Namespace initialization")); |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 103 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 104 | } |
| 105 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 106 | /* If configured, initialize the AML debugger */ |
| 107 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 108 | ACPI_DEBUGGER_EXEC(status = acpi_db_initialize()); |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 109 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 110 | } |
| 111 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 112 | /******************************************************************************* |
| 113 | * |
| 114 | * FUNCTION: acpi_enable_subsystem |
| 115 | * |
| 116 | * PARAMETERS: Flags - Init/enable Options |
| 117 | * |
| 118 | * RETURN: Status |
| 119 | * |
| 120 | * DESCRIPTION: Completes the subsystem initialization including hardware. |
| 121 | * Puts system into ACPI mode if it isn't already. |
| 122 | * |
| 123 | ******************************************************************************/ |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 124 | acpi_status acpi_enable_subsystem(u32 flags) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 125 | { |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 126 | acpi_status status = AE_OK; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 127 | |
Bob Moore | b229cf9 | 2006-04-21 17:15:00 -0400 | [diff] [blame] | 128 | ACPI_FUNCTION_TRACE(acpi_enable_subsystem); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 129 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 130 | /* Enable ACPI mode */ |
| 131 | |
| 132 | if (!(flags & ACPI_NO_ACPI_ENABLE)) { |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 133 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
| 134 | "[Init] Going into ACPI mode\n")); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 135 | |
| 136 | acpi_gbl_original_mode = acpi_hw_get_mode(); |
| 137 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 138 | status = acpi_enable(); |
| 139 | if (ACPI_FAILURE(status)) { |
Bob Moore | b229cf9 | 2006-04-21 17:15:00 -0400 | [diff] [blame] | 140 | ACPI_WARNING((AE_INFO, "AcpiEnable failed")); |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 141 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 142 | } |
| 143 | } |
| 144 | |
| 145 | /* |
| 146 | * Install the default op_region handlers. These are installed unless |
| 147 | * other handlers have already been installed via the |
| 148 | * install_address_space_handler interface. |
| 149 | */ |
| 150 | if (!(flags & ACPI_NO_ADDRESS_SPACE_INIT)) { |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 151 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
| 152 | "[Init] Installing default address space handlers\n")); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 153 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 154 | status = acpi_ev_install_region_handlers(); |
| 155 | if (ACPI_FAILURE(status)) { |
| 156 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 157 | } |
| 158 | } |
| 159 | |
| 160 | /* |
| 161 | * Initialize ACPI Event handling (Fixed and General Purpose) |
| 162 | * |
Bob Moore | 96db255 | 2005-11-02 00:00:00 -0500 | [diff] [blame] | 163 | * Note1: We must have the hardware and events initialized before we can |
| 164 | * execute any control methods safely. Any control method can require |
| 165 | * ACPI hardware support, so the hardware must be fully initialized before |
| 166 | * any method execution! |
| 167 | * |
| 168 | * Note2: Fixed events are initialized and enabled here. GPEs are |
| 169 | * initialized, but cannot be enabled until after the hardware is |
| 170 | * completely initialized (SCI and global_lock activated) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 171 | */ |
| 172 | if (!(flags & ACPI_NO_EVENT_INIT)) { |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 173 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
| 174 | "[Init] Initializing ACPI events\n")); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 175 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 176 | status = acpi_ev_initialize_events(); |
| 177 | if (ACPI_FAILURE(status)) { |
| 178 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 179 | } |
| 180 | } |
| 181 | |
Bob Moore | 96db255 | 2005-11-02 00:00:00 -0500 | [diff] [blame] | 182 | /* |
| 183 | * Install the SCI handler and Global Lock handler. This completes the |
| 184 | * hardware initialization. |
| 185 | */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 186 | if (!(flags & ACPI_NO_HANDLER_INIT)) { |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 187 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
| 188 | "[Init] Installing SCI/GL handlers\n")); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 189 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 190 | status = acpi_ev_install_xrupt_handlers(); |
| 191 | if (ACPI_FAILURE(status)) { |
| 192 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 193 | } |
| 194 | } |
| 195 | |
Bob Moore | 96db255 | 2005-11-02 00:00:00 -0500 | [diff] [blame] | 196 | /* |
| 197 | * Complete the GPE initialization for the GPE blocks defined in the FADT |
| 198 | * (GPE block 0 and 1). |
| 199 | * |
| 200 | * Note1: This is where the _PRW methods are executed for the GPEs. These |
| 201 | * methods can only be executed after the SCI and Global Lock handlers are |
| 202 | * installed and initialized. |
| 203 | * |
| 204 | * Note2: Currently, there seems to be no need to run the _REG methods |
| 205 | * before execution of the _PRW methods and enabling of the GPEs. |
| 206 | */ |
| 207 | if (!(flags & ACPI_NO_EVENT_INIT)) { |
| 208 | status = acpi_ev_install_fadt_gpes(); |
| 209 | if (ACPI_FAILURE(status)) { |
| 210 | return (status); |
| 211 | } |
| 212 | } |
| 213 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 214 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 215 | } |
| 216 | |
Bob Moore | 8313524 | 2006-10-03 00:00:00 -0400 | [diff] [blame] | 217 | ACPI_EXPORT_SYMBOL(acpi_enable_subsystem) |
| 218 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 219 | /******************************************************************************* |
| 220 | * |
| 221 | * FUNCTION: acpi_initialize_objects |
| 222 | * |
| 223 | * PARAMETERS: Flags - Init/enable Options |
| 224 | * |
| 225 | * RETURN: Status |
| 226 | * |
| 227 | * DESCRIPTION: Completes namespace initialization by initializing device |
| 228 | * objects and executing AML code for Regions, buffers, etc. |
| 229 | * |
| 230 | ******************************************************************************/ |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 231 | acpi_status acpi_initialize_objects(u32 flags) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 232 | { |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 233 | acpi_status status = AE_OK; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 234 | |
Bob Moore | b229cf9 | 2006-04-21 17:15:00 -0400 | [diff] [blame] | 235 | ACPI_FUNCTION_TRACE(acpi_initialize_objects); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 236 | |
| 237 | /* |
| 238 | * Run all _REG methods |
| 239 | * |
Bob Moore | 96db255 | 2005-11-02 00:00:00 -0500 | [diff] [blame] | 240 | * Note: Any objects accessed by the _REG methods will be automatically |
| 241 | * initialized, even if they contain executable AML (see the call to |
| 242 | * acpi_ns_initialize_objects below). |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 243 | */ |
| 244 | if (!(flags & ACPI_NO_ADDRESS_SPACE_INIT)) { |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 245 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
Bob Moore | b229cf9 | 2006-04-21 17:15:00 -0400 | [diff] [blame] | 246 | "[Init] Executing _REG OpRegion methods\n")); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 247 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 248 | status = acpi_ev_initialize_op_regions(); |
| 249 | if (ACPI_FAILURE(status)) { |
| 250 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 251 | } |
| 252 | } |
| 253 | |
| 254 | /* |
Bob Moore | 96db255 | 2005-11-02 00:00:00 -0500 | [diff] [blame] | 255 | * Initialize the objects that remain uninitialized. This runs the |
| 256 | * executable AML that may be part of the declaration of these objects: |
| 257 | * operation_regions, buffer_fields, Buffers, and Packages. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 258 | */ |
| 259 | if (!(flags & ACPI_NO_OBJECT_INIT)) { |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 260 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
| 261 | "[Init] Completing Initialization of ACPI Objects\n")); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 262 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 263 | status = acpi_ns_initialize_objects(); |
| 264 | if (ACPI_FAILURE(status)) { |
| 265 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 266 | } |
| 267 | } |
| 268 | |
| 269 | /* |
Bob Moore | 96db255 | 2005-11-02 00:00:00 -0500 | [diff] [blame] | 270 | * Initialize all device objects in the namespace. This runs the device |
| 271 | * _STA and _INI methods. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 272 | */ |
| 273 | if (!(flags & ACPI_NO_DEVICE_INIT)) { |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 274 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
| 275 | "[Init] Initializing ACPI Devices\n")); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 276 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 277 | status = acpi_ns_initialize_devices(); |
| 278 | if (ACPI_FAILURE(status)) { |
| 279 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 280 | } |
| 281 | } |
| 282 | |
| 283 | /* |
| 284 | * Empty the caches (delete the cached objects) on the assumption that |
| 285 | * the table load filled them up more than they will be at runtime -- |
| 286 | * thus wasting non-paged memory. |
| 287 | */ |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 288 | status = acpi_purge_cached_objects(); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 289 | |
| 290 | acpi_gbl_startup_flags |= ACPI_INITIALIZED_OK; |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 291 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 292 | } |
| 293 | |
Bob Moore | 8313524 | 2006-10-03 00:00:00 -0400 | [diff] [blame] | 294 | ACPI_EXPORT_SYMBOL(acpi_initialize_objects) |
| 295 | |
Bob Moore | e20a679 | 2008-04-10 19:06:38 +0400 | [diff] [blame^] | 296 | #endif |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 297 | /******************************************************************************* |
| 298 | * |
| 299 | * FUNCTION: acpi_terminate |
| 300 | * |
| 301 | * PARAMETERS: None |
| 302 | * |
| 303 | * RETURN: Status |
| 304 | * |
| 305 | * DESCRIPTION: Shutdown the ACPI subsystem. Release all resources. |
| 306 | * |
| 307 | ******************************************************************************/ |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 308 | acpi_status acpi_terminate(void) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 309 | { |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 310 | acpi_status status; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 311 | |
Bob Moore | b229cf9 | 2006-04-21 17:15:00 -0400 | [diff] [blame] | 312 | ACPI_FUNCTION_TRACE(acpi_terminate); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 313 | |
| 314 | /* Terminate the AML Debugger if present */ |
| 315 | |
| 316 | ACPI_DEBUGGER_EXEC(acpi_gbl_db_terminate_threads = TRUE); |
| 317 | |
| 318 | /* Shutdown and free all resources */ |
| 319 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 320 | acpi_ut_subsystem_shutdown(); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 321 | |
| 322 | /* Free the mutex objects */ |
| 323 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 324 | acpi_ut_mutex_terminate(); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 325 | |
| 326 | #ifdef ACPI_DEBUGGER |
| 327 | |
| 328 | /* Shut down the debugger */ |
| 329 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 330 | acpi_db_terminate(); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 331 | #endif |
| 332 | |
| 333 | /* Now we can shutdown the OS-dependent layer */ |
| 334 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 335 | status = acpi_os_terminate(); |
| 336 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 337 | } |
| 338 | |
Bob Moore | 8313524 | 2006-10-03 00:00:00 -0400 | [diff] [blame] | 339 | ACPI_EXPORT_SYMBOL(acpi_terminate) |
Bob Moore | e20a679 | 2008-04-10 19:06:38 +0400 | [diff] [blame^] | 340 | #ifndef ACPI_ASL_COMPILER |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 341 | #ifdef ACPI_FUTURE_USAGE |
Robert Moore | 44f6c01 | 2005-04-18 22:49:35 -0400 | [diff] [blame] | 342 | /******************************************************************************* |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 343 | * |
| 344 | * FUNCTION: acpi_subsystem_status |
| 345 | * |
| 346 | * PARAMETERS: None |
| 347 | * |
| 348 | * RETURN: Status of the ACPI subsystem |
| 349 | * |
| 350 | * DESCRIPTION: Other drivers that use the ACPI subsystem should call this |
Robert Moore | 44f6c01 | 2005-04-18 22:49:35 -0400 | [diff] [blame] | 351 | * before making any other calls, to ensure the subsystem |
| 352 | * initialized successfully. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 353 | * |
Robert Moore | 44f6c01 | 2005-04-18 22:49:35 -0400 | [diff] [blame] | 354 | ******************************************************************************/ |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 355 | acpi_status acpi_subsystem_status(void) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 356 | { |
Robert Moore | 44f6c01 | 2005-04-18 22:49:35 -0400 | [diff] [blame] | 357 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 358 | if (acpi_gbl_startup_flags & ACPI_INITIALIZED_OK) { |
| 359 | return (AE_OK); |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 360 | } else { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 361 | return (AE_ERROR); |
| 362 | } |
| 363 | } |
| 364 | |
Bob Moore | 8313524 | 2006-10-03 00:00:00 -0400 | [diff] [blame] | 365 | ACPI_EXPORT_SYMBOL(acpi_subsystem_status) |
| 366 | |
Robert Moore | 44f6c01 | 2005-04-18 22:49:35 -0400 | [diff] [blame] | 367 | /******************************************************************************* |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 368 | * |
| 369 | * FUNCTION: acpi_get_system_info |
| 370 | * |
Robert Moore | 44f6c01 | 2005-04-18 22:49:35 -0400 | [diff] [blame] | 371 | * PARAMETERS: out_buffer - A buffer to receive the resources for the |
| 372 | * device |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 373 | * |
| 374 | * RETURN: Status - the status of the call |
| 375 | * |
| 376 | * DESCRIPTION: This function is called to get information about the current |
| 377 | * state of the ACPI subsystem. It will return system information |
| 378 | * in the out_buffer. |
| 379 | * |
| 380 | * If the function fails an appropriate status will be returned |
| 381 | * and the value of out_buffer is undefined. |
| 382 | * |
| 383 | ******************************************************************************/ |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 384 | acpi_status acpi_get_system_info(struct acpi_buffer * out_buffer) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 385 | { |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 386 | struct acpi_system_info *info_ptr; |
| 387 | acpi_status status; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 388 | |
Bob Moore | b229cf9 | 2006-04-21 17:15:00 -0400 | [diff] [blame] | 389 | ACPI_FUNCTION_TRACE(acpi_get_system_info); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 390 | |
| 391 | /* Parameter validation */ |
| 392 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 393 | status = acpi_ut_validate_buffer(out_buffer); |
| 394 | if (ACPI_FAILURE(status)) { |
| 395 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 396 | } |
| 397 | |
| 398 | /* Validate/Allocate/Clear caller buffer */ |
| 399 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 400 | status = |
| 401 | acpi_ut_initialize_buffer(out_buffer, |
| 402 | sizeof(struct acpi_system_info)); |
| 403 | if (ACPI_FAILURE(status)) { |
| 404 | return_ACPI_STATUS(status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 405 | } |
| 406 | |
| 407 | /* |
| 408 | * Populate the return buffer |
| 409 | */ |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 410 | info_ptr = (struct acpi_system_info *)out_buffer->pointer; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 411 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 412 | info_ptr->acpi_ca_version = ACPI_CA_VERSION; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 413 | |
| 414 | /* System flags (ACPI capabilities) */ |
| 415 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 416 | info_ptr->flags = ACPI_SYS_MODE_ACPI; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 417 | |
| 418 | /* Timer resolution - 24 or 32 bits */ |
| 419 | |
Bob Moore | f3d2e78 | 2007-02-02 19:48:18 +0300 | [diff] [blame] | 420 | if (acpi_gbl_FADT.flags & ACPI_FADT_32BIT_TIMER) { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 421 | info_ptr->timer_resolution = 24; |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 422 | } else { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 423 | info_ptr->timer_resolution = 32; |
| 424 | } |
| 425 | |
| 426 | /* Clear the reserved fields */ |
| 427 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 428 | info_ptr->reserved1 = 0; |
| 429 | info_ptr->reserved2 = 0; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 430 | |
| 431 | /* Current debug levels */ |
| 432 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 433 | info_ptr->debug_layer = acpi_dbg_layer; |
| 434 | info_ptr->debug_level = acpi_dbg_level; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 435 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 436 | return_ACPI_STATUS(AE_OK); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 437 | } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 438 | |
Bob Moore | 8313524 | 2006-10-03 00:00:00 -0400 | [diff] [blame] | 439 | ACPI_EXPORT_SYMBOL(acpi_get_system_info) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 440 | |
| 441 | /***************************************************************************** |
| 442 | * |
| 443 | * FUNCTION: acpi_install_initialization_handler |
| 444 | * |
| 445 | * PARAMETERS: Handler - Callback procedure |
Robert Moore | 44f6c01 | 2005-04-18 22:49:35 -0400 | [diff] [blame] | 446 | * Function - Not (currently) used, see below |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 447 | * |
| 448 | * RETURN: Status |
| 449 | * |
| 450 | * DESCRIPTION: Install an initialization handler |
| 451 | * |
| 452 | * TBD: When a second function is added, must save the Function also. |
| 453 | * |
| 454 | ****************************************************************************/ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 455 | acpi_status |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 456 | acpi_install_initialization_handler(acpi_init_handler handler, u32 function) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 457 | { |
| 458 | |
| 459 | if (!handler) { |
| 460 | return (AE_BAD_PARAMETER); |
| 461 | } |
| 462 | |
| 463 | if (acpi_gbl_init_handler) { |
| 464 | return (AE_ALREADY_EXISTS); |
| 465 | } |
| 466 | |
| 467 | acpi_gbl_init_handler = handler; |
| 468 | return AE_OK; |
| 469 | } |
| 470 | |
Bob Moore | 8313524 | 2006-10-03 00:00:00 -0400 | [diff] [blame] | 471 | ACPI_EXPORT_SYMBOL(acpi_install_initialization_handler) |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 472 | #endif /* ACPI_FUTURE_USAGE */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 473 | /***************************************************************************** |
| 474 | * |
| 475 | * FUNCTION: acpi_purge_cached_objects |
| 476 | * |
| 477 | * PARAMETERS: None |
| 478 | * |
| 479 | * RETURN: Status |
| 480 | * |
| 481 | * DESCRIPTION: Empty all caches (delete the cached objects) |
| 482 | * |
| 483 | ****************************************************************************/ |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 484 | acpi_status acpi_purge_cached_objects(void) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 485 | { |
Bob Moore | b229cf9 | 2006-04-21 17:15:00 -0400 | [diff] [blame] | 486 | ACPI_FUNCTION_TRACE(acpi_purge_cached_objects); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 487 | |
Len Brown | 4be44fc | 2005-08-05 00:44:28 -0400 | [diff] [blame] | 488 | (void)acpi_os_purge_cache(acpi_gbl_state_cache); |
| 489 | (void)acpi_os_purge_cache(acpi_gbl_operand_cache); |
| 490 | (void)acpi_os_purge_cache(acpi_gbl_ps_node_cache); |
| 491 | (void)acpi_os_purge_cache(acpi_gbl_ps_node_ext_cache); |
| 492 | return_ACPI_STATUS(AE_OK); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 493 | } |
Bob Moore | 8313524 | 2006-10-03 00:00:00 -0400 | [diff] [blame] | 494 | |
| 495 | ACPI_EXPORT_SYMBOL(acpi_purge_cached_objects) |
Bob Moore | e20a679 | 2008-04-10 19:06:38 +0400 | [diff] [blame^] | 496 | #endif |