1 /****************************************************************************** 2 * 3 * Module Name: utxfinit - External interfaces for ACPICA initialization 4 * 5 *****************************************************************************/ 6 7 /* 8 * Copyright (C) 2000 - 2015, 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/acpi.h> 47 #include "accommon.h" 48 #include "acevents.h" 49 #include "acnamesp.h" 50 #include "acdebug.h" 51 #include "actables.h" 52 53 #define _COMPONENT ACPI_UTILITIES 54 ACPI_MODULE_NAME("utxfinit") 55 56 /* For acpi_exec only */ 57 void ae_do_object_overrides(void); 58 59 /******************************************************************************* 60 * 61 * FUNCTION: acpi_initialize_subsystem 62 * 63 * PARAMETERS: None 64 * 65 * RETURN: Status 66 * 67 * DESCRIPTION: Initializes all global variables. This is the first function 68 * called, so any early initialization belongs here. 69 * 70 ******************************************************************************/ 71 72 acpi_status __init acpi_initialize_subsystem(void) 73 { 74 acpi_status status; 75 76 ACPI_FUNCTION_TRACE(acpi_initialize_subsystem); 77 78 acpi_gbl_startup_flags = ACPI_SUBSYSTEM_INITIALIZE; 79 ACPI_DEBUG_EXEC(acpi_ut_init_stack_ptr_trace()); 80 81 /* Initialize the OS-Dependent layer */ 82 83 status = acpi_os_initialize(); 84 if (ACPI_FAILURE(status)) { 85 ACPI_EXCEPTION((AE_INFO, status, "During OSL initialization")); 86 return_ACPI_STATUS(status); 87 } 88 89 /* Initialize all globals used by the subsystem */ 90 91 status = acpi_ut_init_globals(); 92 if (ACPI_FAILURE(status)) { 93 ACPI_EXCEPTION((AE_INFO, status, 94 "During initialization of globals")); 95 return_ACPI_STATUS(status); 96 } 97 98 /* Create the default mutex objects */ 99 100 status = acpi_ut_mutex_initialize(); 101 if (ACPI_FAILURE(status)) { 102 ACPI_EXCEPTION((AE_INFO, status, 103 "During Global Mutex creation")); 104 return_ACPI_STATUS(status); 105 } 106 107 /* 108 * Initialize the namespace manager and 109 * the root of the namespace tree 110 */ 111 status = acpi_ns_root_initialize(); 112 if (ACPI_FAILURE(status)) { 113 ACPI_EXCEPTION((AE_INFO, status, 114 "During Namespace initialization")); 115 return_ACPI_STATUS(status); 116 } 117 118 /* Initialize the global OSI interfaces list with the static names */ 119 120 status = acpi_ut_initialize_interfaces(); 121 if (ACPI_FAILURE(status)) { 122 ACPI_EXCEPTION((AE_INFO, status, 123 "During OSI interfaces initialization")); 124 return_ACPI_STATUS(status); 125 } 126 127 /* If configured, initialize the AML debugger */ 128 129 #ifdef ACPI_DEBUGGER 130 status = acpi_db_initialize(); 131 if (ACPI_FAILURE(status)) { 132 ACPI_EXCEPTION((AE_INFO, status, 133 "During Debugger initialization")); 134 return_ACPI_STATUS(status); 135 } 136 #endif 137 138 return_ACPI_STATUS(AE_OK); 139 } 140 141 ACPI_EXPORT_SYMBOL_INIT(acpi_initialize_subsystem) 142 143 /******************************************************************************* 144 * 145 * FUNCTION: acpi_enable_subsystem 146 * 147 * PARAMETERS: flags - Init/enable Options 148 * 149 * RETURN: Status 150 * 151 * DESCRIPTION: Completes the subsystem initialization including hardware. 152 * Puts system into ACPI mode if it isn't already. 153 * 154 ******************************************************************************/ 155 acpi_status __init acpi_enable_subsystem(u32 flags) 156 { 157 acpi_status status = AE_OK; 158 159 ACPI_FUNCTION_TRACE(acpi_enable_subsystem); 160 161 #if (!ACPI_REDUCED_HARDWARE) 162 163 /* Enable ACPI mode */ 164 165 if (!(flags & ACPI_NO_ACPI_ENABLE)) { 166 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, 167 "[Init] Going into ACPI mode\n")); 168 169 acpi_gbl_original_mode = acpi_hw_get_mode(); 170 171 status = acpi_enable(); 172 if (ACPI_FAILURE(status)) { 173 ACPI_WARNING((AE_INFO, "AcpiEnable failed")); 174 return_ACPI_STATUS(status); 175 } 176 } 177 178 /* 179 * Obtain a permanent mapping for the FACS. This is required for the 180 * Global Lock and the Firmware Waking Vector 181 */ 182 if (!(flags & ACPI_NO_FACS_INIT)) { 183 status = acpi_tb_initialize_facs(); 184 if (ACPI_FAILURE(status)) { 185 ACPI_WARNING((AE_INFO, "Could not map the FACS table")); 186 return_ACPI_STATUS(status); 187 } 188 } 189 #endif /* !ACPI_REDUCED_HARDWARE */ 190 191 /* 192 * Install the default op_region handlers. These are installed unless 193 * other handlers have already been installed via the 194 * install_address_space_handler interface. 195 */ 196 if (!(flags & ACPI_NO_ADDRESS_SPACE_INIT)) { 197 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, 198 "[Init] Installing default address space handlers\n")); 199 200 status = acpi_ev_install_region_handlers(); 201 if (ACPI_FAILURE(status)) { 202 return_ACPI_STATUS(status); 203 } 204 } 205 #if (!ACPI_REDUCED_HARDWARE) 206 /* 207 * Initialize ACPI Event handling (Fixed and General Purpose) 208 * 209 * Note1: We must have the hardware and events initialized before we can 210 * execute any control methods safely. Any control method can require 211 * ACPI hardware support, so the hardware must be fully initialized before 212 * any method execution! 213 * 214 * Note2: Fixed events are initialized and enabled here. GPEs are 215 * initialized, but cannot be enabled until after the hardware is 216 * completely initialized (SCI and global_lock activated) and the various 217 * initialization control methods are run (_REG, _STA, _INI) on the 218 * entire namespace. 219 */ 220 if (!(flags & ACPI_NO_EVENT_INIT)) { 221 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, 222 "[Init] Initializing ACPI events\n")); 223 224 status = acpi_ev_initialize_events(); 225 if (ACPI_FAILURE(status)) { 226 return_ACPI_STATUS(status); 227 } 228 } 229 230 /* 231 * Install the SCI handler and Global Lock handler. This completes the 232 * hardware initialization. 233 */ 234 if (!(flags & ACPI_NO_HANDLER_INIT)) { 235 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, 236 "[Init] Installing SCI/GL handlers\n")); 237 238 status = acpi_ev_install_xrupt_handlers(); 239 if (ACPI_FAILURE(status)) { 240 return_ACPI_STATUS(status); 241 } 242 } 243 #endif /* !ACPI_REDUCED_HARDWARE */ 244 245 return_ACPI_STATUS(status); 246 } 247 248 ACPI_EXPORT_SYMBOL_INIT(acpi_enable_subsystem) 249 250 /******************************************************************************* 251 * 252 * FUNCTION: acpi_initialize_objects 253 * 254 * PARAMETERS: flags - Init/enable Options 255 * 256 * RETURN: Status 257 * 258 * DESCRIPTION: Completes namespace initialization by initializing device 259 * objects and executing AML code for Regions, buffers, etc. 260 * 261 ******************************************************************************/ 262 acpi_status __init acpi_initialize_objects(u32 flags) 263 { 264 acpi_status status = AE_OK; 265 266 ACPI_FUNCTION_TRACE(acpi_initialize_objects); 267 268 /* 269 * Run all _REG methods 270 * 271 * Note: Any objects accessed by the _REG methods will be automatically 272 * initialized, even if they contain executable AML (see the call to 273 * acpi_ns_initialize_objects below). 274 */ 275 if (!(flags & ACPI_NO_ADDRESS_SPACE_INIT)) { 276 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, 277 "[Init] Executing _REG OpRegion methods\n")); 278 279 status = acpi_ev_initialize_op_regions(); 280 if (ACPI_FAILURE(status)) { 281 return_ACPI_STATUS(status); 282 } 283 } 284 #ifdef ACPI_EXEC_APP 285 /* 286 * This call implements the "initialization file" option for acpi_exec. 287 * This is the precise point that we want to perform the overrides. 288 */ 289 ae_do_object_overrides(); 290 #endif 291 292 /* 293 * Execute any module-level code that was detected during the table load 294 * phase. Although illegal since ACPI 2.0, there are many machines that 295 * contain this type of code. Each block of detected executable AML code 296 * outside of any control method is wrapped with a temporary control 297 * method object and placed on a global list. The methods on this list 298 * are executed below. 299 */ 300 acpi_ns_exec_module_code_list(); 301 302 /* 303 * Initialize the objects that remain uninitialized. This runs the 304 * executable AML that may be part of the declaration of these objects: 305 * operation_regions, buffer_fields, Buffers, and Packages. 306 */ 307 if (!(flags & ACPI_NO_OBJECT_INIT)) { 308 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, 309 "[Init] Completing Initialization of ACPI Objects\n")); 310 311 status = acpi_ns_initialize_objects(); 312 if (ACPI_FAILURE(status)) { 313 return_ACPI_STATUS(status); 314 } 315 } 316 317 /* 318 * Initialize all device objects in the namespace. This runs the device 319 * _STA and _INI methods. 320 */ 321 if (!(flags & ACPI_NO_DEVICE_INIT)) { 322 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, 323 "[Init] Initializing ACPI Devices\n")); 324 325 status = acpi_ns_initialize_devices(); 326 if (ACPI_FAILURE(status)) { 327 return_ACPI_STATUS(status); 328 } 329 } 330 331 /* 332 * Empty the caches (delete the cached objects) on the assumption that 333 * the table load filled them up more than they will be at runtime -- 334 * thus wasting non-paged memory. 335 */ 336 status = acpi_purge_cached_objects(); 337 338 acpi_gbl_startup_flags |= ACPI_INITIALIZED_OK; 339 return_ACPI_STATUS(status); 340 } 341 342 ACPI_EXPORT_SYMBOL_INIT(acpi_initialize_objects) 343