1 /******************************************************************************
3 * Module Name: nsinit - namespace initialization
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2006, R. Byron Moore
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
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.
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.
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.
44 #include <acpi/acpi.h>
45 #include <acpi/acnamesp.h>
46 #include <acpi/acdispat.h>
47 #include <acpi/acinterp.h>
49 #define _COMPONENT ACPI_NAMESPACE
50 ACPI_MODULE_NAME("nsinit")
52 /* Local prototypes */
54 acpi_ns_init_one_object(acpi_handle obj_handle,
55 u32 level, void *context, void **return_value);
58 acpi_ns_init_one_device(acpi_handle obj_handle,
59 u32 nesting_level, void *context, void **return_value);
61 /*******************************************************************************
63 * FUNCTION: acpi_ns_initialize_objects
69 * DESCRIPTION: Walk the entire namespace and perform any necessary
70 * initialization on the objects found therein
72 ******************************************************************************/
74 acpi_status acpi_ns_initialize_objects(void)
77 struct acpi_init_walk_info info;
79 ACPI_FUNCTION_TRACE("ns_initialize_objects");
81 ACPI_DEBUG_PRINT((ACPI_DB_DISPATCH,
82 "**** Starting initialization of namespace objects ****\n"));
83 ACPI_DEBUG_PRINT_RAW((ACPI_DB_INIT,
84 "Completing Region/Field/Buffer/Package initialization:"));
86 /* Set all init info to zero */
88 ACPI_MEMSET(&info, 0, sizeof(struct acpi_init_walk_info));
90 /* Walk entire namespace from the supplied root */
92 status = acpi_walk_namespace(ACPI_TYPE_ANY, ACPI_ROOT_OBJECT,
93 ACPI_UINT32_MAX, acpi_ns_init_one_object,
95 if (ACPI_FAILURE(status)) {
96 ACPI_EXCEPTION((AE_INFO, status, "During walk_namespace"));
99 ACPI_DEBUG_PRINT_RAW((ACPI_DB_INIT,
100 "\nInitialized %hd/%hd Regions %hd/%hd Fields %hd/%hd Buffers %hd/%hd Packages (%hd nodes)\n",
101 info.op_region_init, info.op_region_count,
102 info.field_init, info.field_count,
103 info.buffer_init, info.buffer_count,
104 info.package_init, info.package_count,
107 ACPI_DEBUG_PRINT((ACPI_DB_DISPATCH,
108 "%hd Control Methods found\n", info.method_count));
109 ACPI_DEBUG_PRINT((ACPI_DB_DISPATCH,
110 "%hd Op Regions found\n", info.op_region_count));
112 return_ACPI_STATUS(AE_OK);
115 /*******************************************************************************
117 * FUNCTION: acpi_ns_initialize_devices
121 * RETURN: acpi_status
123 * DESCRIPTION: Walk the entire namespace and initialize all ACPI devices.
124 * This means running _INI on all present devices.
126 * Note: We install PCI config space handler on region access,
129 ******************************************************************************/
131 acpi_status acpi_ns_initialize_devices(void)
134 struct acpi_device_walk_info info;
136 ACPI_FUNCTION_TRACE("ns_initialize_devices");
140 info.device_count = 0;
144 ACPI_DEBUG_PRINT_RAW((ACPI_DB_INIT,
145 "Executing all Device _STA and_INI methods:"));
147 status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
148 if (ACPI_FAILURE(status)) {
149 return_ACPI_STATUS(status);
152 /* Walk namespace for all objects */
154 status = acpi_ns_walk_namespace(ACPI_TYPE_ANY, ACPI_ROOT_OBJECT,
155 ACPI_UINT32_MAX, TRUE,
156 acpi_ns_init_one_device, &info, NULL);
158 (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
160 if (ACPI_FAILURE(status)) {
161 ACPI_EXCEPTION((AE_INFO, status, "During walk_namespace"));
164 ACPI_DEBUG_PRINT_RAW((ACPI_DB_INIT,
165 "\n%hd Devices found - executed %hd _STA, %hd _INI methods\n",
166 info.device_count, info.num_STA, info.num_INI));
168 return_ACPI_STATUS(status);
171 /*******************************************************************************
173 * FUNCTION: acpi_ns_init_one_object
175 * PARAMETERS: obj_handle - Node
176 * Level - Current nesting level
177 * Context - Points to a init info struct
178 * return_value - Not used
182 * DESCRIPTION: Callback from acpi_walk_namespace. Invoked for every object
183 * within the namespace.
185 * Currently, the only objects that require initialization are:
189 ******************************************************************************/
192 acpi_ns_init_one_object(acpi_handle obj_handle,
193 u32 level, void *context, void **return_value)
195 acpi_object_type type;
197 struct acpi_init_walk_info *info =
198 (struct acpi_init_walk_info *)context;
199 struct acpi_namespace_node *node =
200 (struct acpi_namespace_node *)obj_handle;
201 union acpi_operand_object *obj_desc;
203 ACPI_FUNCTION_NAME("ns_init_one_object");
205 info->object_count++;
207 /* And even then, we are only interested in a few object types */
209 type = acpi_ns_get_type(obj_handle);
210 obj_desc = acpi_ns_get_attached_object(node);
215 /* Increment counters for object types we are looking for */
218 case ACPI_TYPE_REGION:
219 info->op_region_count++;
222 case ACPI_TYPE_BUFFER_FIELD:
226 case ACPI_TYPE_BUFFER:
227 info->buffer_count++;
230 case ACPI_TYPE_PACKAGE:
231 info->package_count++;
236 /* No init required, just exit now */
241 * If the object is already initialized, nothing else to do
243 if (obj_desc->common.flags & AOPOBJ_DATA_VALID) {
248 * Must lock the interpreter before executing AML code
250 status = acpi_ex_enter_interpreter();
251 if (ACPI_FAILURE(status)) {
256 * Each of these types can contain executable AML code within the
260 case ACPI_TYPE_REGION:
262 info->op_region_init++;
263 status = acpi_ds_get_region_arguments(obj_desc);
266 case ACPI_TYPE_BUFFER_FIELD:
269 status = acpi_ds_get_buffer_field_arguments(obj_desc);
272 case ACPI_TYPE_BUFFER:
275 status = acpi_ds_get_buffer_arguments(obj_desc);
278 case ACPI_TYPE_PACKAGE:
280 info->package_init++;
281 status = acpi_ds_get_package_arguments(obj_desc);
285 /* No other types can get here */
289 if (ACPI_FAILURE(status)) {
290 ACPI_EXCEPTION((AE_INFO, status,
291 "Could not execute arguments for [%4.4s] (%s)",
292 acpi_ut_get_node_name(node),
293 acpi_ut_get_type_name(type)));
297 * Print a dot for each object unless we are going to print the entire
300 if (!(acpi_dbg_level & ACPI_LV_INIT_NAMES)) {
301 ACPI_DEBUG_PRINT_RAW((ACPI_DB_INIT, "."));
305 * We ignore errors from above, and always return OK, since we don't want
306 * to abort the walk on any single error.
308 acpi_ex_exit_interpreter();
312 /*******************************************************************************
314 * FUNCTION: acpi_ns_init_one_device
316 * PARAMETERS: acpi_walk_callback
318 * RETURN: acpi_status
320 * DESCRIPTION: This is called once per device soon after ACPI is enabled
321 * to initialize each device. It determines if the device is
322 * present, and if so, calls _INI.
324 ******************************************************************************/
327 acpi_ns_init_one_device(acpi_handle obj_handle,
328 u32 nesting_level, void *context, void **return_value)
330 struct acpi_device_walk_info *info =
331 (struct acpi_device_walk_info *)context;
332 struct acpi_parameter_info pinfo;
335 struct acpi_namespace_node *ini_node;
336 struct acpi_namespace_node *device_node;
338 ACPI_FUNCTION_TRACE("ns_init_one_device");
340 device_node = acpi_ns_map_handle_to_node(obj_handle);
342 return_ACPI_STATUS(AE_BAD_PARAMETER);
346 * We will run _STA/_INI on Devices, Processors and thermal_zones only
348 if ((device_node->type != ACPI_TYPE_DEVICE) &&
349 (device_node->type != ACPI_TYPE_PROCESSOR) &&
350 (device_node->type != ACPI_TYPE_THERMAL)) {
351 return_ACPI_STATUS(AE_OK);
354 if ((acpi_dbg_level <= ACPI_LV_ALL_EXCEPTIONS) &&
355 (!(acpi_dbg_level & ACPI_LV_INFO))) {
356 ACPI_DEBUG_PRINT_RAW((ACPI_DB_INIT, "."));
359 info->device_count++;
362 * Check if the _INI method exists for this device -
363 * if _INI does not exist, there is no need to run _STA
364 * No _INI means device requires no initialization
366 status = acpi_ns_search_node(*ACPI_CAST_PTR(u32, METHOD_NAME__INI),
367 device_node, ACPI_TYPE_METHOD, &ini_node);
368 if (ACPI_FAILURE(status)) {
369 /* No _INI method found - move on to next device */
371 return_ACPI_STATUS(AE_OK);
375 * Run _STA to determine if we can run _INI on the device -
376 * the device must be present before _INI can be run.
377 * However, _STA is not required - assume device present if no _STA
379 ACPI_DEBUG_EXEC(acpi_ut_display_init_pathname(ACPI_TYPE_METHOD,
383 pinfo.node = device_node;
384 pinfo.parameters = NULL;
385 pinfo.parameter_type = ACPI_PARAM_ARGS;
387 status = acpi_ut_execute_STA(pinfo.node, &flags);
388 if (ACPI_FAILURE(status)) {
389 /* Ignore error and move on to next device */
391 return_ACPI_STATUS(AE_OK);
394 if (flags != ACPI_UINT32_MAX) {
398 if (!(flags & ACPI_STA_DEVICE_PRESENT)) {
399 /* Don't look at children of a not present device */
401 return_ACPI_STATUS(AE_CTRL_DEPTH);
405 * The device is present and _INI exists. Run the _INI method.
406 * (We already have the _INI node from above)
408 ACPI_DEBUG_EXEC(acpi_ut_display_init_pathname(ACPI_TYPE_METHOD,
412 pinfo.node = ini_node;
413 status = acpi_ns_evaluate_by_handle(&pinfo);
414 if (ACPI_FAILURE(status)) {
415 /* Ignore error and move on to next device */
417 #ifdef ACPI_DEBUG_OUTPUT
418 char *scope_name = acpi_ns_get_external_pathname(ini_node);
420 ACPI_WARNING((AE_INFO, "%s._INI failed: %s",
421 scope_name, acpi_format_exception(status)));
423 ACPI_MEM_FREE(scope_name);
426 /* Delete any return object (especially if implicit_return is enabled) */
428 if (pinfo.return_object) {
429 acpi_ut_remove_reference(pinfo.return_object);
432 /* Count of successful INIs */
437 if (acpi_gbl_init_handler) {
438 /* External initialization handler is present, call it */
441 acpi_gbl_init_handler(pinfo.node, ACPI_INIT_DEVICE_INI);
444 return_ACPI_STATUS(AE_OK);