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