nsinit.c revision 1.11 1 1.1 jruoho /******************************************************************************
2 1.1 jruoho *
3 1.1 jruoho * Module Name: nsinit - namespace initialization
4 1.1 jruoho *
5 1.1 jruoho *****************************************************************************/
6 1.1 jruoho
7 1.3 jruoho /*
8 1.10 christos * Copyright (C) 2000 - 2016, Intel Corp.
9 1.1 jruoho * All rights reserved.
10 1.1 jruoho *
11 1.3 jruoho * Redistribution and use in source and binary forms, with or without
12 1.3 jruoho * modification, are permitted provided that the following conditions
13 1.3 jruoho * are met:
14 1.3 jruoho * 1. Redistributions of source code must retain the above copyright
15 1.3 jruoho * notice, this list of conditions, and the following disclaimer,
16 1.3 jruoho * without modification.
17 1.3 jruoho * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 1.3 jruoho * substantially similar to the "NO WARRANTY" disclaimer below
19 1.3 jruoho * ("Disclaimer") and any redistribution must be conditioned upon
20 1.3 jruoho * including a substantially similar Disclaimer requirement for further
21 1.3 jruoho * binary redistribution.
22 1.3 jruoho * 3. Neither the names of the above-listed copyright holders nor the names
23 1.3 jruoho * of any contributors may be used to endorse or promote products derived
24 1.3 jruoho * from this software without specific prior written permission.
25 1.3 jruoho *
26 1.3 jruoho * Alternatively, this software may be distributed under the terms of the
27 1.3 jruoho * GNU General Public License ("GPL") version 2 as published by the Free
28 1.3 jruoho * Software Foundation.
29 1.3 jruoho *
30 1.3 jruoho * NO WARRANTY
31 1.3 jruoho * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 1.3 jruoho * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 1.3 jruoho * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 1.3 jruoho * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 1.3 jruoho * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 1.3 jruoho * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 1.3 jruoho * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 1.3 jruoho * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 1.3 jruoho * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 1.3 jruoho * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 1.3 jruoho * POSSIBILITY OF SUCH DAMAGES.
42 1.3 jruoho */
43 1.1 jruoho
44 1.1 jruoho #include "acpi.h"
45 1.1 jruoho #include "accommon.h"
46 1.1 jruoho #include "acnamesp.h"
47 1.1 jruoho #include "acdispat.h"
48 1.1 jruoho #include "acinterp.h"
49 1.11 christos #include "acevents.h"
50 1.1 jruoho
51 1.1 jruoho #define _COMPONENT ACPI_NAMESPACE
52 1.1 jruoho ACPI_MODULE_NAME ("nsinit")
53 1.1 jruoho
54 1.1 jruoho /* Local prototypes */
55 1.1 jruoho
56 1.1 jruoho static ACPI_STATUS
57 1.1 jruoho AcpiNsInitOneObject (
58 1.1 jruoho ACPI_HANDLE ObjHandle,
59 1.1 jruoho UINT32 Level,
60 1.1 jruoho void *Context,
61 1.1 jruoho void **ReturnValue);
62 1.1 jruoho
63 1.1 jruoho static ACPI_STATUS
64 1.1 jruoho AcpiNsInitOneDevice (
65 1.1 jruoho ACPI_HANDLE ObjHandle,
66 1.1 jruoho UINT32 NestingLevel,
67 1.1 jruoho void *Context,
68 1.1 jruoho void **ReturnValue);
69 1.1 jruoho
70 1.1 jruoho static ACPI_STATUS
71 1.1 jruoho AcpiNsFindIniMethods (
72 1.1 jruoho ACPI_HANDLE ObjHandle,
73 1.1 jruoho UINT32 NestingLevel,
74 1.1 jruoho void *Context,
75 1.1 jruoho void **ReturnValue);
76 1.1 jruoho
77 1.1 jruoho
78 1.1 jruoho /*******************************************************************************
79 1.1 jruoho *
80 1.1 jruoho * FUNCTION: AcpiNsInitializeObjects
81 1.1 jruoho *
82 1.1 jruoho * PARAMETERS: None
83 1.1 jruoho *
84 1.1 jruoho * RETURN: Status
85 1.1 jruoho *
86 1.1 jruoho * DESCRIPTION: Walk the entire namespace and perform any necessary
87 1.1 jruoho * initialization on the objects found therein
88 1.1 jruoho *
89 1.1 jruoho ******************************************************************************/
90 1.1 jruoho
91 1.1 jruoho ACPI_STATUS
92 1.1 jruoho AcpiNsInitializeObjects (
93 1.1 jruoho void)
94 1.1 jruoho {
95 1.1 jruoho ACPI_STATUS Status;
96 1.1 jruoho ACPI_INIT_WALK_INFO Info;
97 1.1 jruoho
98 1.1 jruoho
99 1.1 jruoho ACPI_FUNCTION_TRACE (NsInitializeObjects);
100 1.1 jruoho
101 1.1 jruoho
102 1.11 christos ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
103 1.11 christos "[Init] Completing Initialization of ACPI Objects\n"));
104 1.1 jruoho ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
105 1.1 jruoho "**** Starting initialization of namespace objects ****\n"));
106 1.1 jruoho ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT,
107 1.4 christos "Completing Region/Field/Buffer/Package initialization:\n"));
108 1.1 jruoho
109 1.1 jruoho /* Set all init info to zero */
110 1.1 jruoho
111 1.9 christos memset (&Info, 0, sizeof (ACPI_INIT_WALK_INFO));
112 1.1 jruoho
113 1.1 jruoho /* Walk entire namespace from the supplied root */
114 1.1 jruoho
115 1.1 jruoho Status = AcpiWalkNamespace (ACPI_TYPE_ANY, ACPI_ROOT_OBJECT,
116 1.10 christos ACPI_UINT32_MAX, AcpiNsInitOneObject, NULL,
117 1.10 christos &Info, NULL);
118 1.1 jruoho if (ACPI_FAILURE (Status))
119 1.1 jruoho {
120 1.1 jruoho ACPI_EXCEPTION ((AE_INFO, Status, "During WalkNamespace"));
121 1.1 jruoho }
122 1.1 jruoho
123 1.1 jruoho ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT,
124 1.4 christos " Initialized %u/%u Regions %u/%u Fields %u/%u "
125 1.1 jruoho "Buffers %u/%u Packages (%u nodes)\n",
126 1.1 jruoho Info.OpRegionInit, Info.OpRegionCount,
127 1.1 jruoho Info.FieldInit, Info.FieldCount,
128 1.1 jruoho Info.BufferInit, Info.BufferCount,
129 1.1 jruoho Info.PackageInit, Info.PackageCount, Info.ObjectCount));
130 1.1 jruoho
131 1.1 jruoho ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
132 1.6 christos "%u Control Methods found\n%u Op Regions found\n",
133 1.6 christos Info.MethodCount, Info.OpRegionCount));
134 1.1 jruoho
135 1.1 jruoho return_ACPI_STATUS (AE_OK);
136 1.1 jruoho }
137 1.1 jruoho
138 1.1 jruoho
139 1.1 jruoho /*******************************************************************************
140 1.1 jruoho *
141 1.1 jruoho * FUNCTION: AcpiNsInitializeDevices
142 1.1 jruoho *
143 1.1 jruoho * PARAMETERS: None
144 1.1 jruoho *
145 1.1 jruoho * RETURN: ACPI_STATUS
146 1.1 jruoho *
147 1.1 jruoho * DESCRIPTION: Walk the entire namespace and initialize all ACPI devices.
148 1.1 jruoho * This means running _INI on all present devices.
149 1.1 jruoho *
150 1.1 jruoho * Note: We install PCI config space handler on region access,
151 1.1 jruoho * not here.
152 1.1 jruoho *
153 1.1 jruoho ******************************************************************************/
154 1.1 jruoho
155 1.1 jruoho ACPI_STATUS
156 1.1 jruoho AcpiNsInitializeDevices (
157 1.11 christos UINT32 Flags)
158 1.1 jruoho {
159 1.11 christos ACPI_STATUS Status = AE_OK;
160 1.1 jruoho ACPI_DEVICE_WALK_INFO Info;
161 1.11 christos ACPI_HANDLE Handle;
162 1.1 jruoho
163 1.1 jruoho
164 1.1 jruoho ACPI_FUNCTION_TRACE (NsInitializeDevices);
165 1.1 jruoho
166 1.1 jruoho
167 1.11 christos if (!(Flags & ACPI_NO_DEVICE_INIT))
168 1.11 christos {
169 1.11 christos ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
170 1.11 christos "[Init] Initializing ACPI Devices\n"));
171 1.1 jruoho
172 1.11 christos /* Init counters */
173 1.1 jruoho
174 1.11 christos Info.DeviceCount = 0;
175 1.11 christos Info.Num_STA = 0;
176 1.11 christos Info.Num_INI = 0;
177 1.1 jruoho
178 1.11 christos ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT,
179 1.11 christos "Initializing Device/Processor/Thermal objects "
180 1.11 christos "and executing _INI/_STA methods:\n"));
181 1.1 jruoho
182 1.11 christos /* Tree analysis: find all subtrees that contain _INI methods */
183 1.1 jruoho
184 1.11 christos Status = AcpiNsWalkNamespace (ACPI_TYPE_ANY, ACPI_ROOT_OBJECT,
185 1.11 christos ACPI_UINT32_MAX, FALSE, AcpiNsFindIniMethods, NULL, &Info, NULL);
186 1.11 christos if (ACPI_FAILURE (Status))
187 1.11 christos {
188 1.11 christos goto ErrorExit;
189 1.11 christos }
190 1.1 jruoho
191 1.11 christos /* Allocate the evaluation information block */
192 1.1 jruoho
193 1.11 christos Info.EvaluateInfo = ACPI_ALLOCATE_ZEROED (sizeof (ACPI_EVALUATE_INFO));
194 1.11 christos if (!Info.EvaluateInfo)
195 1.11 christos {
196 1.11 christos Status = AE_NO_MEMORY;
197 1.11 christos goto ErrorExit;
198 1.11 christos }
199 1.1 jruoho
200 1.11 christos /*
201 1.11 christos * Execute the "global" _INI method that may appear at the root.
202 1.11 christos * This support is provided for Windows compatibility (Vista+) and
203 1.11 christos * is not part of the ACPI specification.
204 1.11 christos */
205 1.11 christos Info.EvaluateInfo->PrefixNode = AcpiGbl_RootNode;
206 1.11 christos Info.EvaluateInfo->RelativePathname = METHOD_NAME__INI;
207 1.11 christos Info.EvaluateInfo->Parameters = NULL;
208 1.11 christos Info.EvaluateInfo->Flags = ACPI_IGNORE_RETURN_VALUE;
209 1.1 jruoho
210 1.11 christos Status = AcpiNsEvaluate (Info.EvaluateInfo);
211 1.11 christos if (ACPI_SUCCESS (Status))
212 1.11 christos {
213 1.11 christos Info.Num_INI++;
214 1.11 christos }
215 1.1 jruoho
216 1.11 christos /*
217 1.11 christos * Execute \_SB._INI.
218 1.11 christos * There appears to be a strict order requirement for \_SB._INI,
219 1.11 christos * which should be evaluated before any _REG evaluations.
220 1.11 christos */
221 1.11 christos Status = AcpiGetHandle (NULL, "\\_SB", &Handle);
222 1.11 christos if (ACPI_SUCCESS (Status))
223 1.11 christos {
224 1.11 christos memset (Info.EvaluateInfo, 0, sizeof (ACPI_EVALUATE_INFO));
225 1.11 christos Info.EvaluateInfo->PrefixNode = Handle;
226 1.11 christos Info.EvaluateInfo->RelativePathname = METHOD_NAME__INI;
227 1.11 christos Info.EvaluateInfo->Parameters = NULL;
228 1.11 christos Info.EvaluateInfo->Flags = ACPI_IGNORE_RETURN_VALUE;
229 1.11 christos
230 1.11 christos Status = AcpiNsEvaluate (Info.EvaluateInfo);
231 1.11 christos if (ACPI_SUCCESS (Status))
232 1.11 christos {
233 1.11 christos Info.Num_INI++;
234 1.11 christos }
235 1.11 christos }
236 1.11 christos }
237 1.1 jruoho
238 1.1 jruoho /*
239 1.11 christos * Run all _REG methods
240 1.11 christos *
241 1.11 christos * Note: Any objects accessed by the _REG methods will be automatically
242 1.11 christos * initialized, even if they contain executable AML (see the call to
243 1.11 christos * AcpiNsInitializeObjects below).
244 1.11 christos *
245 1.11 christos * Note: According to the ACPI specification, we actually needn't execute
246 1.11 christos * _REG for SystemMemory/SystemIo operation regions, but for PCI_Config
247 1.11 christos * operation regions, it is required to evaluate _REG for those on a PCI
248 1.11 christos * root bus that doesn't contain _BBN object. So this code is kept here
249 1.11 christos * in order not to break things.
250 1.1 jruoho */
251 1.11 christos if (!(Flags & ACPI_NO_ADDRESS_SPACE_INIT))
252 1.1 jruoho {
253 1.11 christos ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
254 1.11 christos "[Init] Executing _REG OpRegion methods\n"));
255 1.11 christos
256 1.11 christos Status = AcpiEvInitializeOpRegions ();
257 1.11 christos if (ACPI_FAILURE (Status))
258 1.11 christos {
259 1.11 christos goto ErrorExit;
260 1.11 christos }
261 1.1 jruoho }
262 1.1 jruoho
263 1.11 christos if (!(Flags & ACPI_NO_DEVICE_INIT))
264 1.1 jruoho {
265 1.11 christos /* Walk namespace to execute all _INIs on present devices */
266 1.11 christos
267 1.11 christos Status = AcpiNsWalkNamespace (ACPI_TYPE_ANY, ACPI_ROOT_OBJECT,
268 1.11 christos ACPI_UINT32_MAX, FALSE, AcpiNsInitOneDevice, NULL, &Info, NULL);
269 1.11 christos
270 1.11 christos /*
271 1.11 christos * Any _OSI requests should be completed by now. If the BIOS has
272 1.11 christos * requested any Windows OSI strings, we will always truncate
273 1.11 christos * I/O addresses to 16 bits -- for Windows compatibility.
274 1.11 christos */
275 1.11 christos if (AcpiGbl_OsiData >= ACPI_OSI_WIN_2000)
276 1.11 christos {
277 1.11 christos AcpiGbl_TruncateIoAddresses = TRUE;
278 1.11 christos }
279 1.11 christos
280 1.11 christos ACPI_FREE (Info.EvaluateInfo);
281 1.11 christos if (ACPI_FAILURE (Status))
282 1.11 christos {
283 1.11 christos goto ErrorExit;
284 1.11 christos }
285 1.11 christos
286 1.11 christos ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT,
287 1.11 christos " Executed %u _INI methods requiring %u _STA executions "
288 1.11 christos "(examined %u objects)\n",
289 1.11 christos Info.Num_INI, Info.Num_STA, Info.DeviceCount));
290 1.1 jruoho }
291 1.1 jruoho
292 1.1 jruoho return_ACPI_STATUS (Status);
293 1.1 jruoho
294 1.1 jruoho
295 1.1 jruoho ErrorExit:
296 1.1 jruoho ACPI_EXCEPTION ((AE_INFO, Status, "During device initialization"));
297 1.1 jruoho return_ACPI_STATUS (Status);
298 1.1 jruoho }
299 1.1 jruoho
300 1.1 jruoho
301 1.1 jruoho /*******************************************************************************
302 1.1 jruoho *
303 1.1 jruoho * FUNCTION: AcpiNsInitOneObject
304 1.1 jruoho *
305 1.1 jruoho * PARAMETERS: ObjHandle - Node
306 1.1 jruoho * Level - Current nesting level
307 1.1 jruoho * Context - Points to a init info struct
308 1.1 jruoho * ReturnValue - Not used
309 1.1 jruoho *
310 1.1 jruoho * RETURN: Status
311 1.1 jruoho *
312 1.4 christos * DESCRIPTION: Callback from AcpiWalkNamespace. Invoked for every object
313 1.1 jruoho * within the namespace.
314 1.1 jruoho *
315 1.1 jruoho * Currently, the only objects that require initialization are:
316 1.1 jruoho * 1) Methods
317 1.1 jruoho * 2) Op Regions
318 1.1 jruoho *
319 1.1 jruoho ******************************************************************************/
320 1.1 jruoho
321 1.1 jruoho static ACPI_STATUS
322 1.1 jruoho AcpiNsInitOneObject (
323 1.1 jruoho ACPI_HANDLE ObjHandle,
324 1.1 jruoho UINT32 Level,
325 1.1 jruoho void *Context,
326 1.1 jruoho void **ReturnValue)
327 1.1 jruoho {
328 1.1 jruoho ACPI_OBJECT_TYPE Type;
329 1.1 jruoho ACPI_STATUS Status = AE_OK;
330 1.1 jruoho ACPI_INIT_WALK_INFO *Info = (ACPI_INIT_WALK_INFO *) Context;
331 1.1 jruoho ACPI_NAMESPACE_NODE *Node = (ACPI_NAMESPACE_NODE *) ObjHandle;
332 1.1 jruoho ACPI_OPERAND_OBJECT *ObjDesc;
333 1.1 jruoho
334 1.1 jruoho
335 1.1 jruoho ACPI_FUNCTION_NAME (NsInitOneObject);
336 1.1 jruoho
337 1.1 jruoho
338 1.1 jruoho Info->ObjectCount++;
339 1.1 jruoho
340 1.1 jruoho /* And even then, we are only interested in a few object types */
341 1.1 jruoho
342 1.1 jruoho Type = AcpiNsGetType (ObjHandle);
343 1.1 jruoho ObjDesc = AcpiNsGetAttachedObject (Node);
344 1.1 jruoho if (!ObjDesc)
345 1.1 jruoho {
346 1.1 jruoho return (AE_OK);
347 1.1 jruoho }
348 1.1 jruoho
349 1.1 jruoho /* Increment counters for object types we are looking for */
350 1.1 jruoho
351 1.1 jruoho switch (Type)
352 1.1 jruoho {
353 1.1 jruoho case ACPI_TYPE_REGION:
354 1.4 christos
355 1.1 jruoho Info->OpRegionCount++;
356 1.1 jruoho break;
357 1.1 jruoho
358 1.1 jruoho case ACPI_TYPE_BUFFER_FIELD:
359 1.4 christos
360 1.1 jruoho Info->FieldCount++;
361 1.1 jruoho break;
362 1.1 jruoho
363 1.1 jruoho case ACPI_TYPE_LOCAL_BANK_FIELD:
364 1.4 christos
365 1.1 jruoho Info->FieldCount++;
366 1.1 jruoho break;
367 1.1 jruoho
368 1.1 jruoho case ACPI_TYPE_BUFFER:
369 1.4 christos
370 1.1 jruoho Info->BufferCount++;
371 1.1 jruoho break;
372 1.1 jruoho
373 1.1 jruoho case ACPI_TYPE_PACKAGE:
374 1.4 christos
375 1.1 jruoho Info->PackageCount++;
376 1.1 jruoho break;
377 1.1 jruoho
378 1.1 jruoho default:
379 1.1 jruoho
380 1.1 jruoho /* No init required, just exit now */
381 1.4 christos
382 1.1 jruoho return (AE_OK);
383 1.1 jruoho }
384 1.1 jruoho
385 1.1 jruoho /* If the object is already initialized, nothing else to do */
386 1.1 jruoho
387 1.1 jruoho if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID)
388 1.1 jruoho {
389 1.1 jruoho return (AE_OK);
390 1.1 jruoho }
391 1.1 jruoho
392 1.1 jruoho /* Must lock the interpreter before executing AML code */
393 1.1 jruoho
394 1.1 jruoho AcpiExEnterInterpreter ();
395 1.1 jruoho
396 1.1 jruoho /*
397 1.1 jruoho * Each of these types can contain executable AML code within the
398 1.1 jruoho * declaration.
399 1.1 jruoho */
400 1.1 jruoho switch (Type)
401 1.1 jruoho {
402 1.1 jruoho case ACPI_TYPE_REGION:
403 1.1 jruoho
404 1.1 jruoho Info->OpRegionInit++;
405 1.1 jruoho Status = AcpiDsGetRegionArguments (ObjDesc);
406 1.1 jruoho break;
407 1.1 jruoho
408 1.1 jruoho case ACPI_TYPE_BUFFER_FIELD:
409 1.1 jruoho
410 1.1 jruoho Info->FieldInit++;
411 1.1 jruoho Status = AcpiDsGetBufferFieldArguments (ObjDesc);
412 1.1 jruoho break;
413 1.1 jruoho
414 1.1 jruoho case ACPI_TYPE_LOCAL_BANK_FIELD:
415 1.1 jruoho
416 1.1 jruoho Info->FieldInit++;
417 1.1 jruoho Status = AcpiDsGetBankFieldArguments (ObjDesc);
418 1.1 jruoho break;
419 1.1 jruoho
420 1.1 jruoho case ACPI_TYPE_BUFFER:
421 1.1 jruoho
422 1.1 jruoho Info->BufferInit++;
423 1.1 jruoho Status = AcpiDsGetBufferArguments (ObjDesc);
424 1.1 jruoho break;
425 1.1 jruoho
426 1.1 jruoho case ACPI_TYPE_PACKAGE:
427 1.1 jruoho
428 1.1 jruoho Info->PackageInit++;
429 1.1 jruoho Status = AcpiDsGetPackageArguments (ObjDesc);
430 1.1 jruoho break;
431 1.1 jruoho
432 1.1 jruoho default:
433 1.4 christos
434 1.1 jruoho /* No other types can get here */
435 1.4 christos
436 1.1 jruoho break;
437 1.1 jruoho }
438 1.1 jruoho
439 1.1 jruoho if (ACPI_FAILURE (Status))
440 1.1 jruoho {
441 1.1 jruoho ACPI_EXCEPTION ((AE_INFO, Status,
442 1.1 jruoho "Could not execute arguments for [%4.4s] (%s)",
443 1.1 jruoho AcpiUtGetNodeName (Node), AcpiUtGetTypeName (Type)));
444 1.1 jruoho }
445 1.1 jruoho
446 1.1 jruoho /*
447 1.1 jruoho * We ignore errors from above, and always return OK, since we don't want
448 1.1 jruoho * to abort the walk on any single error.
449 1.1 jruoho */
450 1.1 jruoho AcpiExExitInterpreter ();
451 1.1 jruoho return (AE_OK);
452 1.1 jruoho }
453 1.1 jruoho
454 1.1 jruoho
455 1.1 jruoho /*******************************************************************************
456 1.1 jruoho *
457 1.1 jruoho * FUNCTION: AcpiNsFindIniMethods
458 1.1 jruoho *
459 1.1 jruoho * PARAMETERS: ACPI_WALK_CALLBACK
460 1.1 jruoho *
461 1.1 jruoho * RETURN: ACPI_STATUS
462 1.1 jruoho *
463 1.1 jruoho * DESCRIPTION: Called during namespace walk. Finds objects named _INI under
464 1.1 jruoho * device/processor/thermal objects, and marks the entire subtree
465 1.1 jruoho * with a SUBTREE_HAS_INI flag. This flag is used during the
466 1.1 jruoho * subsequent device initialization walk to avoid entire subtrees
467 1.1 jruoho * that do not contain an _INI.
468 1.1 jruoho *
469 1.1 jruoho ******************************************************************************/
470 1.1 jruoho
471 1.1 jruoho static ACPI_STATUS
472 1.1 jruoho AcpiNsFindIniMethods (
473 1.1 jruoho ACPI_HANDLE ObjHandle,
474 1.1 jruoho UINT32 NestingLevel,
475 1.1 jruoho void *Context,
476 1.1 jruoho void **ReturnValue)
477 1.1 jruoho {
478 1.1 jruoho ACPI_DEVICE_WALK_INFO *Info = ACPI_CAST_PTR (ACPI_DEVICE_WALK_INFO, Context);
479 1.1 jruoho ACPI_NAMESPACE_NODE *Node;
480 1.1 jruoho ACPI_NAMESPACE_NODE *ParentNode;
481 1.1 jruoho
482 1.1 jruoho
483 1.1 jruoho /* Keep count of device/processor/thermal objects */
484 1.1 jruoho
485 1.1 jruoho Node = ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, ObjHandle);
486 1.1 jruoho if ((Node->Type == ACPI_TYPE_DEVICE) ||
487 1.1 jruoho (Node->Type == ACPI_TYPE_PROCESSOR) ||
488 1.1 jruoho (Node->Type == ACPI_TYPE_THERMAL))
489 1.1 jruoho {
490 1.1 jruoho Info->DeviceCount++;
491 1.1 jruoho return (AE_OK);
492 1.1 jruoho }
493 1.1 jruoho
494 1.1 jruoho /* We are only looking for methods named _INI */
495 1.1 jruoho
496 1.1 jruoho if (!ACPI_COMPARE_NAME (Node->Name.Ascii, METHOD_NAME__INI))
497 1.1 jruoho {
498 1.1 jruoho return (AE_OK);
499 1.1 jruoho }
500 1.1 jruoho
501 1.1 jruoho /*
502 1.1 jruoho * The only _INI methods that we care about are those that are
503 1.1 jruoho * present under Device, Processor, and Thermal objects.
504 1.1 jruoho */
505 1.1 jruoho ParentNode = Node->Parent;
506 1.1 jruoho switch (ParentNode->Type)
507 1.1 jruoho {
508 1.1 jruoho case ACPI_TYPE_DEVICE:
509 1.1 jruoho case ACPI_TYPE_PROCESSOR:
510 1.1 jruoho case ACPI_TYPE_THERMAL:
511 1.1 jruoho
512 1.1 jruoho /* Mark parent and bubble up the INI present flag to the root */
513 1.1 jruoho
514 1.1 jruoho while (ParentNode)
515 1.1 jruoho {
516 1.1 jruoho ParentNode->Flags |= ANOBJ_SUBTREE_HAS_INI;
517 1.1 jruoho ParentNode = ParentNode->Parent;
518 1.1 jruoho }
519 1.1 jruoho break;
520 1.1 jruoho
521 1.1 jruoho default:
522 1.4 christos
523 1.1 jruoho break;
524 1.1 jruoho }
525 1.1 jruoho
526 1.1 jruoho return (AE_OK);
527 1.1 jruoho }
528 1.1 jruoho
529 1.1 jruoho
530 1.1 jruoho /*******************************************************************************
531 1.1 jruoho *
532 1.1 jruoho * FUNCTION: AcpiNsInitOneDevice
533 1.1 jruoho *
534 1.1 jruoho * PARAMETERS: ACPI_WALK_CALLBACK
535 1.1 jruoho *
536 1.1 jruoho * RETURN: ACPI_STATUS
537 1.1 jruoho *
538 1.1 jruoho * DESCRIPTION: This is called once per device soon after ACPI is enabled
539 1.1 jruoho * to initialize each device. It determines if the device is
540 1.1 jruoho * present, and if so, calls _INI.
541 1.1 jruoho *
542 1.1 jruoho ******************************************************************************/
543 1.1 jruoho
544 1.1 jruoho static ACPI_STATUS
545 1.1 jruoho AcpiNsInitOneDevice (
546 1.1 jruoho ACPI_HANDLE ObjHandle,
547 1.1 jruoho UINT32 NestingLevel,
548 1.1 jruoho void *Context,
549 1.1 jruoho void **ReturnValue)
550 1.1 jruoho {
551 1.1 jruoho ACPI_DEVICE_WALK_INFO *WalkInfo = ACPI_CAST_PTR (ACPI_DEVICE_WALK_INFO, Context);
552 1.1 jruoho ACPI_EVALUATE_INFO *Info = WalkInfo->EvaluateInfo;
553 1.1 jruoho UINT32 Flags;
554 1.1 jruoho ACPI_STATUS Status;
555 1.1 jruoho ACPI_NAMESPACE_NODE *DeviceNode;
556 1.1 jruoho
557 1.1 jruoho
558 1.1 jruoho ACPI_FUNCTION_TRACE (NsInitOneDevice);
559 1.1 jruoho
560 1.1 jruoho
561 1.1 jruoho /* We are interested in Devices, Processors and ThermalZones only */
562 1.1 jruoho
563 1.1 jruoho DeviceNode = ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, ObjHandle);
564 1.1 jruoho if ((DeviceNode->Type != ACPI_TYPE_DEVICE) &&
565 1.1 jruoho (DeviceNode->Type != ACPI_TYPE_PROCESSOR) &&
566 1.1 jruoho (DeviceNode->Type != ACPI_TYPE_THERMAL))
567 1.1 jruoho {
568 1.1 jruoho return_ACPI_STATUS (AE_OK);
569 1.1 jruoho }
570 1.1 jruoho
571 1.1 jruoho /*
572 1.1 jruoho * Because of an earlier namespace analysis, all subtrees that contain an
573 1.1 jruoho * _INI method are tagged.
574 1.1 jruoho *
575 1.1 jruoho * If this device subtree does not contain any _INI methods, we
576 1.1 jruoho * can exit now and stop traversing this entire subtree.
577 1.1 jruoho */
578 1.1 jruoho if (!(DeviceNode->Flags & ANOBJ_SUBTREE_HAS_INI))
579 1.1 jruoho {
580 1.1 jruoho return_ACPI_STATUS (AE_CTRL_DEPTH);
581 1.1 jruoho }
582 1.1 jruoho
583 1.1 jruoho /*
584 1.1 jruoho * Run _STA to determine if this device is present and functioning. We
585 1.1 jruoho * must know this information for two important reasons (from ACPI spec):
586 1.1 jruoho *
587 1.1 jruoho * 1) We can only run _INI if the device is present.
588 1.1 jruoho * 2) We must abort the device tree walk on this subtree if the device is
589 1.1 jruoho * not present and is not functional (we will not examine the children)
590 1.1 jruoho *
591 1.1 jruoho * The _STA method is not required to be present under the device, we
592 1.1 jruoho * assume the device is present if _STA does not exist.
593 1.1 jruoho */
594 1.1 jruoho ACPI_DEBUG_EXEC (AcpiUtDisplayInitPathname (
595 1.1 jruoho ACPI_TYPE_METHOD, DeviceNode, METHOD_NAME__STA));
596 1.1 jruoho
597 1.1 jruoho Status = AcpiUtExecute_STA (DeviceNode, &Flags);
598 1.1 jruoho if (ACPI_FAILURE (Status))
599 1.1 jruoho {
600 1.1 jruoho /* Ignore error and move on to next device */
601 1.1 jruoho
602 1.1 jruoho return_ACPI_STATUS (AE_OK);
603 1.1 jruoho }
604 1.1 jruoho
605 1.1 jruoho /*
606 1.1 jruoho * Flags == -1 means that _STA was not found. In this case, we assume that
607 1.1 jruoho * the device is both present and functional.
608 1.1 jruoho *
609 1.1 jruoho * From the ACPI spec, description of _STA:
610 1.1 jruoho *
611 1.1 jruoho * "If a device object (including the processor object) does not have an
612 1.1 jruoho * _STA object, then OSPM assumes that all of the above bits are set (in
613 1.1 jruoho * other words, the device is present, ..., and functioning)"
614 1.1 jruoho */
615 1.1 jruoho if (Flags != ACPI_UINT32_MAX)
616 1.1 jruoho {
617 1.1 jruoho WalkInfo->Num_STA++;
618 1.1 jruoho }
619 1.1 jruoho
620 1.1 jruoho /*
621 1.1 jruoho * Examine the PRESENT and FUNCTIONING status bits
622 1.1 jruoho *
623 1.1 jruoho * Note: ACPI spec does not seem to specify behavior for the present but
624 1.1 jruoho * not functioning case, so we assume functioning if present.
625 1.1 jruoho */
626 1.1 jruoho if (!(Flags & ACPI_STA_DEVICE_PRESENT))
627 1.1 jruoho {
628 1.1 jruoho /* Device is not present, we must examine the Functioning bit */
629 1.1 jruoho
630 1.1 jruoho if (Flags & ACPI_STA_DEVICE_FUNCTIONING)
631 1.1 jruoho {
632 1.1 jruoho /*
633 1.1 jruoho * Device is not present but is "functioning". In this case,
634 1.1 jruoho * we will not run _INI, but we continue to examine the children
635 1.1 jruoho * of this device.
636 1.1 jruoho *
637 1.1 jruoho * From the ACPI spec, description of _STA: (Note - no mention
638 1.1 jruoho * of whether to run _INI or not on the device in question)
639 1.1 jruoho *
640 1.1 jruoho * "_STA may return bit 0 clear (not present) with bit 3 set
641 1.1 jruoho * (device is functional). This case is used to indicate a valid
642 1.1 jruoho * device for which no device driver should be loaded (for example,
643 1.1 jruoho * a bridge device.) Children of this device may be present and
644 1.1 jruoho * valid. OSPM should continue enumeration below a device whose
645 1.1 jruoho * _STA returns this bit combination"
646 1.1 jruoho */
647 1.1 jruoho return_ACPI_STATUS (AE_OK);
648 1.1 jruoho }
649 1.1 jruoho else
650 1.1 jruoho {
651 1.1 jruoho /*
652 1.1 jruoho * Device is not present and is not functioning. We must abort the
653 1.1 jruoho * walk of this subtree immediately -- don't look at the children
654 1.1 jruoho * of such a device.
655 1.1 jruoho *
656 1.1 jruoho * From the ACPI spec, description of _INI:
657 1.1 jruoho *
658 1.1 jruoho * "If the _STA method indicates that the device is not present,
659 1.1 jruoho * OSPM will not run the _INI and will not examine the children
660 1.1 jruoho * of the device for _INI methods"
661 1.1 jruoho */
662 1.1 jruoho return_ACPI_STATUS (AE_CTRL_DEPTH);
663 1.1 jruoho }
664 1.1 jruoho }
665 1.1 jruoho
666 1.1 jruoho /*
667 1.1 jruoho * The device is present or is assumed present if no _STA exists.
668 1.1 jruoho * Run the _INI if it exists (not required to exist)
669 1.1 jruoho *
670 1.1 jruoho * Note: We know there is an _INI within this subtree, but it may not be
671 1.1 jruoho * under this particular device, it may be lower in the branch.
672 1.1 jruoho */
673 1.11 christos if (!ACPI_COMPARE_NAME (DeviceNode->Name.Ascii, "_SB_") ||
674 1.11 christos DeviceNode->Parent != AcpiGbl_RootNode)
675 1.11 christos {
676 1.11 christos ACPI_DEBUG_EXEC (AcpiUtDisplayInitPathname (
677 1.11 christos ACPI_TYPE_METHOD, DeviceNode, METHOD_NAME__INI));
678 1.1 jruoho
679 1.11 christos memset (Info, 0, sizeof (ACPI_EVALUATE_INFO));
680 1.11 christos Info->PrefixNode = DeviceNode;
681 1.11 christos Info->RelativePathname = METHOD_NAME__INI;
682 1.11 christos Info->Parameters = NULL;
683 1.11 christos Info->Flags = ACPI_IGNORE_RETURN_VALUE;
684 1.1 jruoho
685 1.11 christos Status = AcpiNsEvaluate (Info);
686 1.11 christos if (ACPI_SUCCESS (Status))
687 1.11 christos {
688 1.11 christos WalkInfo->Num_INI++;
689 1.11 christos }
690 1.1 jruoho
691 1.1 jruoho #ifdef ACPI_DEBUG_OUTPUT
692 1.11 christos else if (Status != AE_NOT_FOUND)
693 1.11 christos {
694 1.11 christos /* Ignore error and move on to next device */
695 1.1 jruoho
696 1.11 christos char *ScopeName = AcpiNsGetNormalizedPathname (DeviceNode, TRUE);
697 1.1 jruoho
698 1.11 christos ACPI_EXCEPTION ((AE_INFO, Status, "during %s._INI execution",
699 1.11 christos ScopeName));
700 1.11 christos ACPI_FREE (ScopeName);
701 1.11 christos }
702 1.11 christos #endif
703 1.1 jruoho }
704 1.1 jruoho
705 1.1 jruoho /* Ignore errors from above */
706 1.1 jruoho
707 1.1 jruoho Status = AE_OK;
708 1.1 jruoho
709 1.1 jruoho /*
710 1.1 jruoho * The _INI method has been run if present; call the Global Initialization
711 1.1 jruoho * Handler for this device.
712 1.1 jruoho */
713 1.1 jruoho if (AcpiGbl_InitHandler)
714 1.1 jruoho {
715 1.1 jruoho Status = AcpiGbl_InitHandler (DeviceNode, ACPI_INIT_DEVICE_INI);
716 1.1 jruoho }
717 1.1 jruoho
718 1.1 jruoho return_ACPI_STATUS (Status);
719 1.1 jruoho }
720