xref: /linux/drivers/acpi/acpica/utxfinit.c (revision 8ca4fc323d2e4ab9dabbdd57633af40b0c7e6af9)
1 // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
2 /******************************************************************************
3  *
4  * Module Name: utxfinit - External interfaces for ACPICA initialization
5  *
6  * Copyright (C) 2000 - 2022, Intel Corp.
7  *
8  *****************************************************************************/
9 
10 #define EXPORT_ACPI_INTERFACES
11 
12 #include <acpi/acpi.h>
13 #include "accommon.h"
14 #include "acevents.h"
15 #include "acnamesp.h"
16 #include "acdebug.h"
17 #include "actables.h"
18 
19 #define _COMPONENT          ACPI_UTILITIES
20 ACPI_MODULE_NAME("utxfinit")
21 
22 /* For acpi_exec only */
23 void ae_do_object_overrides(void);
24 
25 /*******************************************************************************
26  *
27  * FUNCTION:    acpi_initialize_subsystem
28  *
29  * PARAMETERS:  None
30  *
31  * RETURN:      Status
32  *
33  * DESCRIPTION: Initializes all global variables. This is the first function
34  *              called, so any early initialization belongs here.
35  *
36  ******************************************************************************/
37 
38 acpi_status ACPI_INIT_FUNCTION acpi_initialize_subsystem(void)
39 {
40 	acpi_status status;
41 
42 	ACPI_FUNCTION_TRACE(acpi_initialize_subsystem);
43 
44 	acpi_gbl_startup_flags = ACPI_SUBSYSTEM_INITIALIZE;
45 	ACPI_DEBUG_EXEC(acpi_ut_init_stack_ptr_trace());
46 
47 	/* Initialize the OS-Dependent layer */
48 
49 	status = acpi_os_initialize();
50 	if (ACPI_FAILURE(status)) {
51 		ACPI_EXCEPTION((AE_INFO, status, "During OSL initialization"));
52 		return_ACPI_STATUS(status);
53 	}
54 
55 	/* Initialize all globals used by the subsystem */
56 
57 	status = acpi_ut_init_globals();
58 	if (ACPI_FAILURE(status)) {
59 		ACPI_EXCEPTION((AE_INFO, status,
60 				"During initialization of globals"));
61 		return_ACPI_STATUS(status);
62 	}
63 
64 	/* Create the default mutex objects */
65 
66 	status = acpi_ut_mutex_initialize();
67 	if (ACPI_FAILURE(status)) {
68 		ACPI_EXCEPTION((AE_INFO, status,
69 				"During Global Mutex creation"));
70 		return_ACPI_STATUS(status);
71 	}
72 
73 	/*
74 	 * Initialize the namespace manager and
75 	 * the root of the namespace tree
76 	 */
77 	status = acpi_ns_root_initialize();
78 	if (ACPI_FAILURE(status)) {
79 		ACPI_EXCEPTION((AE_INFO, status,
80 				"During Namespace initialization"));
81 		return_ACPI_STATUS(status);
82 	}
83 
84 	/* Initialize the global OSI interfaces list with the static names */
85 
86 	status = acpi_ut_initialize_interfaces();
87 	if (ACPI_FAILURE(status)) {
88 		ACPI_EXCEPTION((AE_INFO, status,
89 				"During OSI interfaces initialization"));
90 		return_ACPI_STATUS(status);
91 	}
92 
93 	return_ACPI_STATUS(AE_OK);
94 }
95 
96 ACPI_EXPORT_SYMBOL_INIT(acpi_initialize_subsystem)
97 
98 /*******************************************************************************
99  *
100  * FUNCTION:    acpi_enable_subsystem
101  *
102  * PARAMETERS:  flags               - Init/enable Options
103  *
104  * RETURN:      Status
105  *
106  * DESCRIPTION: Completes the subsystem initialization including hardware.
107  *              Puts system into ACPI mode if it isn't already.
108  *
109  ******************************************************************************/
110 acpi_status ACPI_INIT_FUNCTION acpi_enable_subsystem(u32 flags)
111 {
112 	acpi_status status = AE_OK;
113 
114 	ACPI_FUNCTION_TRACE(acpi_enable_subsystem);
115 
116 	/*
117 	 * The early initialization phase is complete. The namespace is loaded,
118 	 * and we can now support address spaces other than Memory, I/O, and
119 	 * PCI_Config.
120 	 */
121 	acpi_gbl_early_initialization = FALSE;
122 
123 #if (!ACPI_REDUCED_HARDWARE)
124 
125 	/* Enable ACPI mode */
126 
127 	if (!(flags & ACPI_NO_ACPI_ENABLE)) {
128 		ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
129 				  "[Init] Going into ACPI mode\n"));
130 
131 		acpi_gbl_original_mode = acpi_hw_get_mode();
132 
133 		status = acpi_enable();
134 		if (ACPI_FAILURE(status)) {
135 			ACPI_WARNING((AE_INFO, "AcpiEnable failed"));
136 			return_ACPI_STATUS(status);
137 		}
138 	}
139 
140 	/*
141 	 * Obtain a permanent mapping for the FACS. This is required for the
142 	 * Global Lock and the Firmware Waking Vector
143 	 */
144 	if (!(flags & ACPI_NO_FACS_INIT)) {
145 		status = acpi_tb_initialize_facs();
146 		if (ACPI_FAILURE(status)) {
147 			ACPI_WARNING((AE_INFO, "Could not map the FACS table"));
148 			return_ACPI_STATUS(status);
149 		}
150 	}
151 
152 	/*
153 	 * Initialize ACPI Event handling (Fixed and General Purpose)
154 	 *
155 	 * Note1: We must have the hardware and events initialized before we can
156 	 * execute any control methods safely. Any control method can require
157 	 * ACPI hardware support, so the hardware must be fully initialized before
158 	 * any method execution!
159 	 *
160 	 * Note2: Fixed events are initialized and enabled here. GPEs are
161 	 * initialized, but cannot be enabled until after the hardware is
162 	 * completely initialized (SCI and global_lock activated) and the various
163 	 * initialization control methods are run (_REG, _STA, _INI) on the
164 	 * entire namespace.
165 	 */
166 	if (!(flags & ACPI_NO_EVENT_INIT)) {
167 		ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
168 				  "[Init] Initializing ACPI events\n"));
169 
170 		status = acpi_ev_initialize_events();
171 		if (ACPI_FAILURE(status)) {
172 			return_ACPI_STATUS(status);
173 		}
174 	}
175 
176 	/*
177 	 * Install the SCI handler and Global Lock handler. This completes the
178 	 * hardware initialization.
179 	 */
180 	if (!(flags & ACPI_NO_HANDLER_INIT)) {
181 		ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
182 				  "[Init] Installing SCI/GL handlers\n"));
183 
184 		status = acpi_ev_install_xrupt_handlers();
185 		if (ACPI_FAILURE(status)) {
186 			return_ACPI_STATUS(status);
187 		}
188 	}
189 #endif				/* !ACPI_REDUCED_HARDWARE */
190 
191 	return_ACPI_STATUS(status);
192 }
193 
194 ACPI_EXPORT_SYMBOL_INIT(acpi_enable_subsystem)
195 
196 /*******************************************************************************
197  *
198  * FUNCTION:    acpi_initialize_objects
199  *
200  * PARAMETERS:  flags               - Init/enable Options
201  *
202  * RETURN:      Status
203  *
204  * DESCRIPTION: Completes namespace initialization by initializing device
205  *              objects and executing AML code for Regions, buffers, etc.
206  *
207  ******************************************************************************/
208 acpi_status ACPI_INIT_FUNCTION acpi_initialize_objects(u32 flags)
209 {
210 	acpi_status status = AE_OK;
211 
212 	ACPI_FUNCTION_TRACE(acpi_initialize_objects);
213 
214 #ifdef ACPI_OBSOLETE_BEHAVIOR
215 	/*
216 	 * 05/2019: Removed, initialization now happens at both object
217 	 * creation and table load time
218 	 */
219 
220 	/*
221 	 * Initialize the objects that remain uninitialized. This
222 	 * runs the executable AML that may be part of the
223 	 * declaration of these objects: operation_regions, buffer_fields,
224 	 * bank_fields, Buffers, and Packages.
225 	 */
226 	if (!(flags & ACPI_NO_OBJECT_INIT)) {
227 		status = acpi_ns_initialize_objects();
228 		if (ACPI_FAILURE(status)) {
229 			return_ACPI_STATUS(status);
230 		}
231 	}
232 #endif
233 
234 	/*
235 	 * Initialize all device/region objects in the namespace. This runs
236 	 * the device _STA and _INI methods and region _REG methods.
237 	 */
238 	if (!(flags & (ACPI_NO_DEVICE_INIT | ACPI_NO_ADDRESS_SPACE_INIT))) {
239 		status = acpi_ns_initialize_devices(flags);
240 		if (ACPI_FAILURE(status)) {
241 			return_ACPI_STATUS(status);
242 		}
243 	}
244 
245 	/*
246 	 * Empty the caches (delete the cached objects) on the assumption that
247 	 * the table load filled them up more than they will be at runtime --
248 	 * thus wasting non-paged memory.
249 	 */
250 	status = acpi_purge_cached_objects();
251 
252 	acpi_gbl_startup_flags |= ACPI_INITIALIZED_OK;
253 	return_ACPI_STATUS(status);
254 }
255 
256 ACPI_EXPORT_SYMBOL_INIT(acpi_initialize_objects)
257