1 /******************************************************************************
2 *
3 * Module Name: dsargs - Support for execution of dynamic arguments for static
4 * objects (regions, fields, buffer fields, etc.)
5 *
6 *****************************************************************************/
7
8 /*
9 * Copyright (C) 2000 - 2011, Intel Corp.
10 * All rights reserved.
11 *
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
14 * are met:
15 * 1. Redistributions of source code must retain the above copyright
16 * notice, this list of conditions, and the following disclaimer,
17 * without modification.
18 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
19 * substantially similar to the "NO WARRANTY" disclaimer below
20 * ("Disclaimer") and any redistribution must be conditioned upon
21 * including a substantially similar Disclaimer requirement for further
22 * binary redistribution.
23 * 3. Neither the names of the above-listed copyright holders nor the names
24 * of any contributors may be used to endorse or promote products derived
25 * from this software without specific prior written permission.
26 *
27 * Alternatively, this software may be distributed under the terms of the
28 * GNU General Public License ("GPL") version 2 as published by the Free
29 * Software Foundation.
30 *
31 * NO WARRANTY
32 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
33 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
34 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
35 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
36 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
37 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
38 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
39 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
40 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
41 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
42 * POSSIBILITY OF SUCH DAMAGES.
43 */
44
45 #define __DSARGS_C__
46
47 #include "acpi.h"
48 #include "accommon.h"
49 #include "acparser.h"
50 #include "amlcode.h"
51 #include "acdispat.h"
52 #include "acnamesp.h"
53
54 #define _COMPONENT ACPI_DISPATCHER
55 ACPI_MODULE_NAME ("dsargs")
56
57 /* Local prototypes */
58
59 static ACPI_STATUS
60 AcpiDsExecuteArguments (
61 ACPI_NAMESPACE_NODE *Node,
62 ACPI_NAMESPACE_NODE *ScopeNode,
63 UINT32 AmlLength,
64 UINT8 *AmlStart);
65
66
67 /*******************************************************************************
68 *
69 * FUNCTION: AcpiDsExecuteArguments
70 *
71 * PARAMETERS: Node - Object NS node
72 * ScopeNode - Parent NS node
73 * AmlLength - Length of executable AML
74 * AmlStart - Pointer to the AML
75 *
76 * RETURN: Status.
77 *
78 * DESCRIPTION: Late (deferred) execution of region or field arguments
79 *
80 ******************************************************************************/
81
82 static ACPI_STATUS
83 AcpiDsExecuteArguments (
84 ACPI_NAMESPACE_NODE *Node,
85 ACPI_NAMESPACE_NODE *ScopeNode,
86 UINT32 AmlLength,
87 UINT8 *AmlStart)
88 {
89 ACPI_STATUS Status;
90 ACPI_PARSE_OBJECT *Op;
91 ACPI_WALK_STATE *WalkState;
92
93
94 ACPI_FUNCTION_TRACE (DsExecuteArguments);
95
96
97 /* Allocate a new parser op to be the root of the parsed tree */
98
99 Op = AcpiPsAllocOp (AML_INT_EVAL_SUBTREE_OP);
100 if (!Op)
101 {
102 return_ACPI_STATUS (AE_NO_MEMORY);
103 }
104
105 /* Save the Node for use in AcpiPsParseAml */
106
107 Op->Common.Node = ScopeNode;
108
109 /* Create and initialize a new parser state */
110
111 WalkState = AcpiDsCreateWalkState (0, NULL, NULL, NULL);
112 if (!WalkState)
113 {
114 Status = AE_NO_MEMORY;
115 goto Cleanup;
116 }
117
118 Status = AcpiDsInitAmlWalk (WalkState, Op, NULL, AmlStart,
119 AmlLength, NULL, ACPI_IMODE_LOAD_PASS1);
120 if (ACPI_FAILURE (Status))
121 {
122 AcpiDsDeleteWalkState (WalkState);
123 goto Cleanup;
124 }
125
126 /* Mark this parse as a deferred opcode */
127
128 WalkState->ParseFlags = ACPI_PARSE_DEFERRED_OP;
129 WalkState->DeferredNode = Node;
130
131 /* Pass1: Parse the entire declaration */
132
133 Status = AcpiPsParseAml (WalkState);
134 if (ACPI_FAILURE (Status))
135 {
136 goto Cleanup;
137 }
138
139 /* Get and init the Op created above */
140
141 Op->Common.Node = Node;
142 AcpiPsDeleteParseTree (Op);
143
144 /* Evaluate the deferred arguments */
145
146 Op = AcpiPsAllocOp (AML_INT_EVAL_SUBTREE_OP);
147 if (!Op)
148 {
149 return_ACPI_STATUS (AE_NO_MEMORY);
150 }
151
152 Op->Common.Node = ScopeNode;
153
154 /* Create and initialize a new parser state */
155
156 WalkState = AcpiDsCreateWalkState (0, NULL, NULL, NULL);
157 if (!WalkState)
158 {
159 Status = AE_NO_MEMORY;
160 goto Cleanup;
161 }
162
163 /* Execute the opcode and arguments */
164
165 Status = AcpiDsInitAmlWalk (WalkState, Op, NULL, AmlStart,
166 AmlLength, NULL, ACPI_IMODE_EXECUTE);
167 if (ACPI_FAILURE (Status))
168 {
169 AcpiDsDeleteWalkState (WalkState);
170 goto Cleanup;
171 }
172
173 /* Mark this execution as a deferred opcode */
174
175 WalkState->DeferredNode = Node;
176 Status = AcpiPsParseAml (WalkState);
177
178 Cleanup:
179 AcpiPsDeleteParseTree (Op);
180 return_ACPI_STATUS (Status);
181 }
182
183
184 /*******************************************************************************
185 *
186 * FUNCTION: AcpiDsGetBufferFieldArguments
187 *
188 * PARAMETERS: ObjDesc - A valid BufferField object
189 *
190 * RETURN: Status.
191 *
192 * DESCRIPTION: Get BufferField Buffer and Index. This implements the late
193 * evaluation of these field attributes.
194 *
195 ******************************************************************************/
196
197 ACPI_STATUS
198 AcpiDsGetBufferFieldArguments (
199 ACPI_OPERAND_OBJECT *ObjDesc)
200 {
201 ACPI_OPERAND_OBJECT *ExtraDesc;
202 ACPI_NAMESPACE_NODE *Node;
203 ACPI_STATUS Status;
204
205
206 ACPI_FUNCTION_TRACE_PTR (DsGetBufferFieldArguments, ObjDesc);
207
208
209 if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID)
210 {
211 return_ACPI_STATUS (AE_OK);
212 }
213
214 /* Get the AML pointer (method object) and BufferField node */
215
216 ExtraDesc = AcpiNsGetSecondaryObject (ObjDesc);
217 Node = ObjDesc->BufferField.Node;
218
219 ACPI_DEBUG_EXEC (AcpiUtDisplayInitPathname (ACPI_TYPE_BUFFER_FIELD,
220 Node, NULL));
221
222 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[%4.4s] BufferField Arg Init\n",
223 AcpiUtGetNodeName (Node)));
224
225 /* Execute the AML code for the TermArg arguments */
226
227 Status = AcpiDsExecuteArguments (Node, Node->Parent,
228 ExtraDesc->Extra.AmlLength, ExtraDesc->Extra.AmlStart);
229 return_ACPI_STATUS (Status);
230 }
231
232
233 /*******************************************************************************
234 *
235 * FUNCTION: AcpiDsGetBankFieldArguments
236 *
237 * PARAMETERS: ObjDesc - A valid BankField object
238 *
239 * RETURN: Status.
240 *
241 * DESCRIPTION: Get BankField BankValue. This implements the late
242 * evaluation of these field attributes.
243 *
244 ******************************************************************************/
245
246 ACPI_STATUS
247 AcpiDsGetBankFieldArguments (
248 ACPI_OPERAND_OBJECT *ObjDesc)
249 {
250 ACPI_OPERAND_OBJECT *ExtraDesc;
251 ACPI_NAMESPACE_NODE *Node;
252 ACPI_STATUS Status;
253
254
255 ACPI_FUNCTION_TRACE_PTR (DsGetBankFieldArguments, ObjDesc);
256
257
258 if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID)
259 {
260 return_ACPI_STATUS (AE_OK);
261 }
262
263 /* Get the AML pointer (method object) and BankField node */
264
265 ExtraDesc = AcpiNsGetSecondaryObject (ObjDesc);
266 Node = ObjDesc->BankField.Node;
267
268 ACPI_DEBUG_EXEC (AcpiUtDisplayInitPathname (ACPI_TYPE_LOCAL_BANK_FIELD,
269 Node, NULL));
270
271 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[%4.4s] BankField Arg Init\n",
272 AcpiUtGetNodeName (Node)));
273
274 /* Execute the AML code for the TermArg arguments */
275
276 Status = AcpiDsExecuteArguments (Node, Node->Parent,
277 ExtraDesc->Extra.AmlLength, ExtraDesc->Extra.AmlStart);
278 return_ACPI_STATUS (Status);
279 }
280
281
282 /*******************************************************************************
283 *
284 * FUNCTION: AcpiDsGetBufferArguments
285 *
286 * PARAMETERS: ObjDesc - A valid Buffer object
287 *
288 * RETURN: Status.
289 *
290 * DESCRIPTION: Get Buffer length and initializer byte list. This implements
291 * the late evaluation of these attributes.
292 *
293 ******************************************************************************/
294
295 ACPI_STATUS
296 AcpiDsGetBufferArguments (
297 ACPI_OPERAND_OBJECT *ObjDesc)
298 {
299 ACPI_NAMESPACE_NODE *Node;
300 ACPI_STATUS Status;
301
302
303 ACPI_FUNCTION_TRACE_PTR (DsGetBufferArguments, ObjDesc);
304
305
306 if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID)
307 {
308 return_ACPI_STATUS (AE_OK);
309 }
310
311 /* Get the Buffer node */
312
313 Node = ObjDesc->Buffer.Node;
314 if (!Node)
315 {
316 ACPI_ERROR ((AE_INFO,
317 "No pointer back to namespace node in buffer object %p", ObjDesc));
318 return_ACPI_STATUS (AE_AML_INTERNAL);
319 }
320
321 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Buffer Arg Init\n"));
322
323 /* Execute the AML code for the TermArg arguments */
324
325 Status = AcpiDsExecuteArguments (Node, Node,
326 ObjDesc->Buffer.AmlLength, ObjDesc->Buffer.AmlStart);
327 return_ACPI_STATUS (Status);
328 }
329
330
331 /*******************************************************************************
332 *
333 * FUNCTION: AcpiDsGetPackageArguments
334 *
335 * PARAMETERS: ObjDesc - A valid Package object
336 *
337 * RETURN: Status.
338 *
339 * DESCRIPTION: Get Package length and initializer byte list. This implements
340 * the late evaluation of these attributes.
341 *
342 ******************************************************************************/
343
344 ACPI_STATUS
345 AcpiDsGetPackageArguments (
346 ACPI_OPERAND_OBJECT *ObjDesc)
347 {
348 ACPI_NAMESPACE_NODE *Node;
349 ACPI_STATUS Status;
350
351
352 ACPI_FUNCTION_TRACE_PTR (DsGetPackageArguments, ObjDesc);
353
354
355 if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID)
356 {
357 return_ACPI_STATUS (AE_OK);
358 }
359
360 /* Get the Package node */
361
362 Node = ObjDesc->Package.Node;
363 if (!Node)
364 {
365 ACPI_ERROR ((AE_INFO,
366 "No pointer back to namespace node in package %p", ObjDesc));
367 return_ACPI_STATUS (AE_AML_INTERNAL);
368 }
369
370 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Package Arg Init\n"));
371
372 /* Execute the AML code for the TermArg arguments */
373
374 Status = AcpiDsExecuteArguments (Node, Node,
375 ObjDesc->Package.AmlLength, ObjDesc->Package.AmlStart);
376 return_ACPI_STATUS (Status);
377 }
378
379
380 /*******************************************************************************
381 *
382 * FUNCTION: AcpiDsGetRegionArguments
383 *
384 * PARAMETERS: ObjDesc - A valid region object
385 *
386 * RETURN: Status.
387 *
388 * DESCRIPTION: Get region address and length. This implements the late
389 * evaluation of these region attributes.
390 *
391 ******************************************************************************/
392
393 ACPI_STATUS
394 AcpiDsGetRegionArguments (
395 ACPI_OPERAND_OBJECT *ObjDesc)
396 {
397 ACPI_NAMESPACE_NODE *Node;
398 ACPI_STATUS Status;
399 ACPI_OPERAND_OBJECT *ExtraDesc;
400
401
402 ACPI_FUNCTION_TRACE_PTR (DsGetRegionArguments, ObjDesc);
403
404
405 if (ObjDesc->Region.Flags & AOPOBJ_DATA_VALID)
406 {
407 return_ACPI_STATUS (AE_OK);
408 }
409
410 ExtraDesc = AcpiNsGetSecondaryObject (ObjDesc);
411 if (!ExtraDesc)
412 {
413 return_ACPI_STATUS (AE_NOT_EXIST);
414 }
415
416 /* Get the Region node */
417
418 Node = ObjDesc->Region.Node;
419
420 ACPI_DEBUG_EXEC (AcpiUtDisplayInitPathname (ACPI_TYPE_REGION, Node, NULL));
421
422 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[%4.4s] OpRegion Arg Init at AML %p\n",
423 AcpiUtGetNodeName (Node), ExtraDesc->Extra.AmlStart));
424
425 /* Execute the argument AML */
426
427 Status = AcpiDsExecuteArguments (Node, Node->Parent,
428 ExtraDesc->Extra.AmlLength, ExtraDesc->Extra.AmlStart);
429 return_ACPI_STATUS (Status);
430 }