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