projects / deliverable / linux.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
blame | history | raw | HEAD
ACPICA: update Intel copyright
[deliverable/linux.git] / drivers / acpi / dispatcher / dsopcode.c
1 /******************************************************************************
2 *
3 * Module Name: dsopcode - Dispatcher Op Region support and handling of
4 * "control" opcodes
5 *
6 *****************************************************************************/
7
8 /*
9 * Copyright (C) 2000 - 2008, 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 #include <acpi/acpi.h>
46 #include <acpi/acparser.h>
47 #include <acpi/amlcode.h>
48 #include <acpi/acdispat.h>
49 #include <acpi/acinterp.h>
50 #include <acpi/acnamesp.h>
51 #include <acpi/acevents.h>
52 #include <acpi/actables.h>
53
54 #define _COMPONENT ACPI_DISPATCHER
55 ACPI_MODULE_NAME("dsopcode")
56
57 /* Local prototypes */
58 static acpi_status
59 acpi_ds_execute_arguments(struct acpi_namespace_node *node,
60 struct acpi_namespace_node *scope_node,
61 u32 aml_length, u8 * aml_start);
62
63 static acpi_status
64 acpi_ds_init_buffer_field(u16 aml_opcode,
65 union acpi_operand_object *obj_desc,
66 union acpi_operand_object *buffer_desc,
67 union acpi_operand_object *offset_desc,
68 union acpi_operand_object *length_desc,
69 union acpi_operand_object *result_desc);
70
71 /*******************************************************************************
72 *
73 * FUNCTION: acpi_ds_execute_arguments
74 *
75 * PARAMETERS: Node - Object NS node
76 * scope_node - Parent NS node
77 * aml_length - Length of executable AML
78 * aml_start - Pointer to the AML
79 *
80 * RETURN: Status.
81 *
82 * DESCRIPTION: Late (deferred) execution of region or field arguments
83 *
84 ******************************************************************************/
85
86 static acpi_status
87 acpi_ds_execute_arguments(struct acpi_namespace_node *node,
88 struct acpi_namespace_node *scope_node,
89 u32 aml_length, u8 * aml_start)
90 {
91 acpi_status status;
92 union acpi_parse_object *op;
93 struct acpi_walk_state *walk_state;
94
95 ACPI_FUNCTION_TRACE(ds_execute_arguments);
96
97 /*
98 * Allocate a new parser op to be the root of the parsed tree
99 */
100 op = acpi_ps_alloc_op(AML_INT_EVAL_SUBTREE_OP);
101 if (!op) {
102 return_ACPI_STATUS(AE_NO_MEMORY);
103 }
104
105 /* Save the Node for use in acpi_ps_parse_aml */
106
107 op->common.node = scope_node;
108
109 /* Create and initialize a new parser state */
110
111 walk_state = acpi_ds_create_walk_state(0, NULL, NULL, NULL);
112 if (!walk_state) {
113 status = AE_NO_MEMORY;
114 goto cleanup;
115 }
116
117 status = acpi_ds_init_aml_walk(walk_state, op, NULL, aml_start,
118 aml_length, NULL, ACPI_IMODE_LOAD_PASS1);
119 if (ACPI_FAILURE(status)) {
120 acpi_ds_delete_walk_state(walk_state);
121 goto cleanup;
122 }
123
124 /* Mark this parse as a deferred opcode */
125
126 walk_state->parse_flags = ACPI_PARSE_DEFERRED_OP;
127 walk_state->deferred_node = node;
128
129 /* Pass1: Parse the entire declaration */
130
131 status = acpi_ps_parse_aml(walk_state);
132 if (ACPI_FAILURE(status)) {
133 goto cleanup;
134 }
135
136 /* Get and init the Op created above */
137
138 op->common.node = node;
139 acpi_ps_delete_parse_tree(op);
140
141 /* Evaluate the deferred arguments */
142
143 op = acpi_ps_alloc_op(AML_INT_EVAL_SUBTREE_OP);
144 if (!op) {
145 return_ACPI_STATUS(AE_NO_MEMORY);
146 }
147
148 op->common.node = scope_node;
149
150 /* Create and initialize a new parser state */
151
152 walk_state = acpi_ds_create_walk_state(0, NULL, NULL, NULL);
153 if (!walk_state) {
154 status = AE_NO_MEMORY;
155 goto cleanup;
156 }
157
158 /* Execute the opcode and arguments */
159
160 status = acpi_ds_init_aml_walk(walk_state, op, NULL, aml_start,
161 aml_length, NULL, ACPI_IMODE_EXECUTE);
162 if (ACPI_FAILURE(status)) {
163 acpi_ds_delete_walk_state(walk_state);
164 goto cleanup;
165 }
166
167 /* Mark this execution as a deferred opcode */
168
169 walk_state->deferred_node = node;
170 status = acpi_ps_parse_aml(walk_state);
171
172 cleanup:
173 acpi_ps_delete_parse_tree(op);
174 return_ACPI_STATUS(status);
175 }
176
177 /*******************************************************************************
178 *
179 * FUNCTION: acpi_ds_get_buffer_field_arguments
180 *
181 * PARAMETERS: obj_desc - A valid buffer_field object
182 *
183 * RETURN: Status.
184 *
185 * DESCRIPTION: Get buffer_field Buffer and Index. This implements the late
186 * evaluation of these field attributes.
187 *
188 ******************************************************************************/
189
190 acpi_status
191 acpi_ds_get_buffer_field_arguments(union acpi_operand_object *obj_desc)
192 {
193 union acpi_operand_object *extra_desc;
194 struct acpi_namespace_node *node;
195 acpi_status status;
196
197 ACPI_FUNCTION_TRACE_PTR(ds_get_buffer_field_arguments, obj_desc);
198
199 if (obj_desc->common.flags & AOPOBJ_DATA_VALID) {
200 return_ACPI_STATUS(AE_OK);
201 }
202
203 /* Get the AML pointer (method object) and buffer_field node */
204
205 extra_desc = acpi_ns_get_secondary_object(obj_desc);
206 node = obj_desc->buffer_field.node;
207
208 ACPI_DEBUG_EXEC(acpi_ut_display_init_pathname
209 (ACPI_TYPE_BUFFER_FIELD, node, NULL));
210 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "[%4.4s] BufferField Arg Init\n",
211 acpi_ut_get_node_name(node)));
212
213 /* Execute the AML code for the term_arg arguments */
214
215 status = acpi_ds_execute_arguments(node, acpi_ns_get_parent_node(node),
216 extra_desc->extra.aml_length,
217 extra_desc->extra.aml_start);
218 return_ACPI_STATUS(status);
219 }
220
221 /*******************************************************************************
222 *
223 * FUNCTION: acpi_ds_get_bank_field_arguments
224 *
225 * PARAMETERS: obj_desc - A valid bank_field object
226 *
227 * RETURN: Status.
228 *
229 * DESCRIPTION: Get bank_field bank_value. This implements the late
230 * evaluation of these field attributes.
231 *
232 ******************************************************************************/
233
234 acpi_status
235 acpi_ds_get_bank_field_arguments(union acpi_operand_object *obj_desc)
236 {
237 union acpi_operand_object *extra_desc;
238 struct acpi_namespace_node *node;
239 acpi_status status;
240
241 ACPI_FUNCTION_TRACE_PTR(ds_get_bank_field_arguments, obj_desc);
242
243 if (obj_desc->common.flags & AOPOBJ_DATA_VALID) {
244 return_ACPI_STATUS(AE_OK);
245 }
246
247 /* Get the AML pointer (method object) and bank_field node */
248
249 extra_desc = acpi_ns_get_secondary_object(obj_desc);
250 node = obj_desc->bank_field.node;
251
252 ACPI_DEBUG_EXEC(acpi_ut_display_init_pathname
253 (ACPI_TYPE_LOCAL_BANK_FIELD, node, NULL));
254 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "[%4.4s] BankField Arg Init\n",
255 acpi_ut_get_node_name(node)));
256
257 /* Execute the AML code for the term_arg arguments */
258
259 status = acpi_ds_execute_arguments(node, acpi_ns_get_parent_node(node),
260 extra_desc->extra.aml_length,
261 extra_desc->extra.aml_start);
262 return_ACPI_STATUS(status);
263 }
264
265 /*******************************************************************************
266 *
267 * FUNCTION: acpi_ds_get_buffer_arguments
268 *
269 * PARAMETERS: obj_desc - A valid Buffer object
270 *
271 * RETURN: Status.
272 *
273 * DESCRIPTION: Get Buffer length and initializer byte list. This implements
274 * the late evaluation of these attributes.
275 *
276 ******************************************************************************/
277
278 acpi_status acpi_ds_get_buffer_arguments(union acpi_operand_object *obj_desc)
279 {
280 struct acpi_namespace_node *node;
281 acpi_status status;
282
283 ACPI_FUNCTION_TRACE_PTR(ds_get_buffer_arguments, obj_desc);
284
285 if (obj_desc->common.flags & AOPOBJ_DATA_VALID) {
286 return_ACPI_STATUS(AE_OK);
287 }
288
289 /* Get the Buffer node */
290
291 node = obj_desc->buffer.node;
292 if (!node) {
293 ACPI_ERROR((AE_INFO,
294 "No pointer back to NS node in buffer obj %p",
295 obj_desc));
296 return_ACPI_STATUS(AE_AML_INTERNAL);
297 }
298
299 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Buffer Arg Init\n"));
300
301 /* Execute the AML code for the term_arg arguments */
302
303 status = acpi_ds_execute_arguments(node, node,
304 obj_desc->buffer.aml_length,
305 obj_desc->buffer.aml_start);
306 return_ACPI_STATUS(status);
307 }
308
309 /*******************************************************************************
310 *
311 * FUNCTION: acpi_ds_get_package_arguments
312 *
313 * PARAMETERS: obj_desc - A valid Package object
314 *
315 * RETURN: Status.
316 *
317 * DESCRIPTION: Get Package length and initializer byte list. This implements
318 * the late evaluation of these attributes.
319 *
320 ******************************************************************************/
321
322 acpi_status acpi_ds_get_package_arguments(union acpi_operand_object *obj_desc)
323 {
324 struct acpi_namespace_node *node;
325 acpi_status status;
326
327 ACPI_FUNCTION_TRACE_PTR(ds_get_package_arguments, obj_desc);
328
329 if (obj_desc->common.flags & AOPOBJ_DATA_VALID) {
330 return_ACPI_STATUS(AE_OK);
331 }
332
333 /* Get the Package node */
334
335 node = obj_desc->package.node;
336 if (!node) {
337 ACPI_ERROR((AE_INFO,
338 "No pointer back to NS node in package %p",
339 obj_desc));
340 return_ACPI_STATUS(AE_AML_INTERNAL);
341 }
342
343 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Package Arg Init\n"));
344
345 /* Execute the AML code for the term_arg arguments */
346
347 status = acpi_ds_execute_arguments(node, node,
348 obj_desc->package.aml_length,
349 obj_desc->package.aml_start);
350 return_ACPI_STATUS(status);
351 }
352
353 /*****************************************************************************
354 *
355 * FUNCTION: acpi_ds_get_region_arguments
356 *
357 * PARAMETERS: obj_desc - A valid region object
358 *
359 * RETURN: Status.
360 *
361 * DESCRIPTION: Get region address and length. This implements the late
362 * evaluation of these region attributes.
363 *
364 ****************************************************************************/
365
366 acpi_status acpi_ds_get_region_arguments(union acpi_operand_object *obj_desc)
367 {
368 struct acpi_namespace_node *node;
369 acpi_status status;
370 union acpi_operand_object *extra_desc;
371
372 ACPI_FUNCTION_TRACE_PTR(ds_get_region_arguments, obj_desc);
373
374 if (obj_desc->region.flags & AOPOBJ_DATA_VALID) {
375 return_ACPI_STATUS(AE_OK);
376 }
377
378 extra_desc = acpi_ns_get_secondary_object(obj_desc);
379 if (!extra_desc) {
380 return_ACPI_STATUS(AE_NOT_EXIST);
381 }
382
383 /* Get the Region node */
384
385 node = obj_desc->region.node;
386
387 ACPI_DEBUG_EXEC(acpi_ut_display_init_pathname
388 (ACPI_TYPE_REGION, node, NULL));
389
390 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "[%4.4s] OpRegion Arg Init at AML %p\n",
391 acpi_ut_get_node_name(node),
392 extra_desc->extra.aml_start));
393
394 /* Execute the argument AML */
395
396 status = acpi_ds_execute_arguments(node, acpi_ns_get_parent_node(node),
397 extra_desc->extra.aml_length,
398 extra_desc->extra.aml_start);
399 if (ACPI_FAILURE(status)) {
400 return_ACPI_STATUS(status);
401 }
402
403 /* Validate the region address/length via the host OS */
404
405 status = acpi_os_validate_address(obj_desc->region.space_id,
406 obj_desc->region.address,
407 (acpi_size) obj_desc->region.length,
408 acpi_ut_get_node_name(node));
409
410 if (ACPI_FAILURE(status)) {
411 /*
412 * Invalid address/length. We will emit an error message and mark
413 * the region as invalid, so that it will cause an additional error if
414 * it is ever used. Then return AE_OK.
415 */
416 ACPI_EXCEPTION((AE_INFO, status,
417 "During address validation of OpRegion [%4.4s]",
418 node->name.ascii));
419 obj_desc->common.flags |= AOPOBJ_INVALID;
420 status = AE_OK;
421 }
422
423 return_ACPI_STATUS(status);
424 }
425
426 /*******************************************************************************
427 *
428 * FUNCTION: acpi_ds_initialize_region
429 *
430 * PARAMETERS: obj_handle - Region namespace node
431 *
432 * RETURN: Status
433 *
434 * DESCRIPTION: Front end to ev_initialize_region
435 *
436 ******************************************************************************/
437
438 acpi_status acpi_ds_initialize_region(acpi_handle obj_handle)
439 {
440 union acpi_operand_object *obj_desc;
441 acpi_status status;
442
443 obj_desc = acpi_ns_get_attached_object(obj_handle);
444
445 /* Namespace is NOT locked */
446
447 status = acpi_ev_initialize_region(obj_desc, FALSE);
448 return (status);
449 }
450
451 /*******************************************************************************
452 *
453 * FUNCTION: acpi_ds_init_buffer_field
454 *
455 * PARAMETERS: aml_opcode - create_xxx_field
456 * obj_desc - buffer_field object
457 * buffer_desc - Host Buffer
458 * offset_desc - Offset into buffer
459 * length_desc - Length of field (CREATE_FIELD_OP only)
460 * result_desc - Where to store the result
461 *
462 * RETURN: Status
463 *
464 * DESCRIPTION: Perform actual initialization of a buffer field
465 *
466 ******************************************************************************/
467
468 static acpi_status
469 acpi_ds_init_buffer_field(u16 aml_opcode,
470 union acpi_operand_object *obj_desc,
471 union acpi_operand_object *buffer_desc,
472 union acpi_operand_object *offset_desc,
473 union acpi_operand_object *length_desc,
474 union acpi_operand_object *result_desc)
475 {
476 u32 offset;
477 u32 bit_offset;
478 u32 bit_count;
479 u8 field_flags;
480 acpi_status status;
481
482 ACPI_FUNCTION_TRACE_PTR(ds_init_buffer_field, obj_desc);
483
484 /* Host object must be a Buffer */
485
486 if (ACPI_GET_OBJECT_TYPE(buffer_desc) != ACPI_TYPE_BUFFER) {
487 ACPI_ERROR((AE_INFO,
488 "Target of Create Field is not a Buffer object - %s",
489 acpi_ut_get_object_type_name(buffer_desc)));
490
491 status = AE_AML_OPERAND_TYPE;
492 goto cleanup;
493 }
494
495 /*
496 * The last parameter to all of these opcodes (result_desc) started
497 * out as a name_string, and should therefore now be a NS node
498 * after resolution in acpi_ex_resolve_operands().
499 */
500 if (ACPI_GET_DESCRIPTOR_TYPE(result_desc) != ACPI_DESC_TYPE_NAMED) {
501 ACPI_ERROR((AE_INFO,
502 "(%s) destination not a NS Node [%s]",
503 acpi_ps_get_opcode_name(aml_opcode),
504 acpi_ut_get_descriptor_name(result_desc)));
505
506 status = AE_AML_OPERAND_TYPE;
507 goto cleanup;
508 }
509
510 offset = (u32) offset_desc->integer.value;
511
512 /*
513 * Setup the Bit offsets and counts, according to the opcode
514 */
515 switch (aml_opcode) {
516 case AML_CREATE_FIELD_OP:
517
518 /* Offset is in bits, count is in bits */
519
520 field_flags = AML_FIELD_ACCESS_BYTE;
521 bit_offset = offset;
522 bit_count = (u32) length_desc->integer.value;
523
524 /* Must have a valid (>0) bit count */
525
526 if (bit_count == 0) {
527 ACPI_ERROR((AE_INFO,
528 "Attempt to CreateField of length zero"));
529 status = AE_AML_OPERAND_VALUE;
530 goto cleanup;
531 }
532 break;
533
534 case AML_CREATE_BIT_FIELD_OP:
535
536 /* Offset is in bits, Field is one bit */
537
538 bit_offset = offset;
539 bit_count = 1;
540 field_flags = AML_FIELD_ACCESS_BYTE;
541 break;
542
543 case AML_CREATE_BYTE_FIELD_OP:
544
545 /* Offset is in bytes, field is one byte */
546
547 bit_offset = 8 * offset;
548 bit_count = 8;
549 field_flags = AML_FIELD_ACCESS_BYTE;
550 break;
551
552 case AML_CREATE_WORD_FIELD_OP:
553
554 /* Offset is in bytes, field is one word */
555
556 bit_offset = 8 * offset;
557 bit_count = 16;
558 field_flags = AML_FIELD_ACCESS_WORD;
559 break;
560
561 case AML_CREATE_DWORD_FIELD_OP:
562
563 /* Offset is in bytes, field is one dword */
564
565 bit_offset = 8 * offset;
566 bit_count = 32;
567 field_flags = AML_FIELD_ACCESS_DWORD;
568 break;
569
570 case AML_CREATE_QWORD_FIELD_OP:
571
572 /* Offset is in bytes, field is one qword */
573
574 bit_offset = 8 * offset;
575 bit_count = 64;
576 field_flags = AML_FIELD_ACCESS_QWORD;
577 break;
578
579 default:
580
581 ACPI_ERROR((AE_INFO,
582 "Unknown field creation opcode %02x", aml_opcode));
583 status = AE_AML_BAD_OPCODE;
584 goto cleanup;
585 }
586
587 /* Entire field must fit within the current length of the buffer */
588
589 if ((bit_offset + bit_count) > (8 * (u32) buffer_desc->buffer.length)) {
590 ACPI_ERROR((AE_INFO,
591 "Field [%4.4s] at %d exceeds Buffer [%4.4s] size %d (bits)",
592 acpi_ut_get_node_name(result_desc),
593 bit_offset + bit_count,
594 acpi_ut_get_node_name(buffer_desc->buffer.node),
595 8 * (u32) buffer_desc->buffer.length));
596 status = AE_AML_BUFFER_LIMIT;
597 goto cleanup;
598 }
599
600 /*
601 * Initialize areas of the field object that are common to all fields
602 * For field_flags, use LOCK_RULE = 0 (NO_LOCK),
603 * UPDATE_RULE = 0 (UPDATE_PRESERVE)
604 */
605 status = acpi_ex_prep_common_field_object(obj_desc, field_flags, 0,
606 bit_offset, bit_count);
607 if (ACPI_FAILURE(status)) {
608 goto cleanup;
609 }
610
611 obj_desc->buffer_field.buffer_obj = buffer_desc;
612
613 /* Reference count for buffer_desc inherits obj_desc count */
614
615 buffer_desc->common.reference_count = (u16)
616 (buffer_desc->common.reference_count +
617 obj_desc->common.reference_count);
618
619 cleanup:
620
621 /* Always delete the operands */
622
623 acpi_ut_remove_reference(offset_desc);
624 acpi_ut_remove_reference(buffer_desc);
625
626 if (aml_opcode == AML_CREATE_FIELD_OP) {
627 acpi_ut_remove_reference(length_desc);
628 }
629
630 /* On failure, delete the result descriptor */
631
632 if (ACPI_FAILURE(status)) {
633 acpi_ut_remove_reference(result_desc); /* Result descriptor */
634 } else {
635 /* Now the address and length are valid for this buffer_field */
636
637 obj_desc->buffer_field.flags |= AOPOBJ_DATA_VALID;
638 }
639
640 return_ACPI_STATUS(status);
641 }
642
643 /*******************************************************************************
644 *
645 * FUNCTION: acpi_ds_eval_buffer_field_operands
646 *
647 * PARAMETERS: walk_state - Current walk
648 * Op - A valid buffer_field Op object
649 *
650 * RETURN: Status
651 *
652 * DESCRIPTION: Get buffer_field Buffer and Index
653 * Called from acpi_ds_exec_end_op during buffer_field parse tree walk
654 *
655 ******************************************************************************/
656
657 acpi_status
658 acpi_ds_eval_buffer_field_operands(struct acpi_walk_state *walk_state,
659 union acpi_parse_object *op)
660 {
661 acpi_status status;
662 union acpi_operand_object *obj_desc;
663 struct acpi_namespace_node *node;
664 union acpi_parse_object *next_op;
665
666 ACPI_FUNCTION_TRACE_PTR(ds_eval_buffer_field_operands, op);
667
668 /*
669 * This is where we evaluate the address and length fields of the
670 * create_xxx_field declaration
671 */
672 node = op->common.node;
673
674 /* next_op points to the op that holds the Buffer */
675
676 next_op = op->common.value.arg;
677
678 /* Evaluate/create the address and length operands */
679
680 status = acpi_ds_create_operands(walk_state, next_op);
681 if (ACPI_FAILURE(status)) {
682 return_ACPI_STATUS(status);
683 }
684
685 obj_desc = acpi_ns_get_attached_object(node);
686 if (!obj_desc) {
687 return_ACPI_STATUS(AE_NOT_EXIST);
688 }
689
690 /* Resolve the operands */
691
692 status = acpi_ex_resolve_operands(op->common.aml_opcode,
693 ACPI_WALK_OPERANDS, walk_state);
694
695 ACPI_DUMP_OPERANDS(ACPI_WALK_OPERANDS, ACPI_IMODE_EXECUTE,
696 acpi_ps_get_opcode_name(op->common.aml_opcode),
697 walk_state->num_operands,
698 "after AcpiExResolveOperands");
699
700 if (ACPI_FAILURE(status)) {
701 ACPI_ERROR((AE_INFO, "(%s) bad operand(s) (%X)",
702 acpi_ps_get_opcode_name(op->common.aml_opcode),
703 status));
704
705 return_ACPI_STATUS(status);
706 }
707
708 /* Initialize the Buffer Field */
709
710 if (op->common.aml_opcode == AML_CREATE_FIELD_OP) {
711
712 /* NOTE: Slightly different operands for this opcode */
713
714 status =
715 acpi_ds_init_buffer_field(op->common.aml_opcode, obj_desc,
716 walk_state->operands[0],
717 walk_state->operands[1],
718 walk_state->operands[2],
719 walk_state->operands[3]);
720 } else {
721 /* All other, create_xxx_field opcodes */
722
723 status =
724 acpi_ds_init_buffer_field(op->common.aml_opcode, obj_desc,
725 walk_state->operands[0],
726 walk_state->operands[1], NULL,
727 walk_state->operands[2]);
728 }
729
730 return_ACPI_STATUS(status);
731 }
732
733 /*******************************************************************************
734 *
735 * FUNCTION: acpi_ds_eval_region_operands
736 *
737 * PARAMETERS: walk_state - Current walk
738 * Op - A valid region Op object
739 *
740 * RETURN: Status
741 *
742 * DESCRIPTION: Get region address and length
743 * Called from acpi_ds_exec_end_op during op_region parse tree walk
744 *
745 ******************************************************************************/
746
747 acpi_status
748 acpi_ds_eval_region_operands(struct acpi_walk_state *walk_state,
749 union acpi_parse_object *op)
750 {
751 acpi_status status;
752 union acpi_operand_object *obj_desc;
753 union acpi_operand_object *operand_desc;
754 struct acpi_namespace_node *node;
755 union acpi_parse_object *next_op;
756
757 ACPI_FUNCTION_TRACE_PTR(ds_eval_region_operands, op);
758
759 /*
760 * This is where we evaluate the address and length fields of the
761 * op_region declaration
762 */
763 node = op->common.node;
764
765 /* next_op points to the op that holds the space_iD */
766
767 next_op = op->common.value.arg;
768
769 /* next_op points to address op */
770
771 next_op = next_op->common.next;
772
773 /* Evaluate/create the address and length operands */
774
775 status = acpi_ds_create_operands(walk_state, next_op);
776 if (ACPI_FAILURE(status)) {
777 return_ACPI_STATUS(status);
778 }
779
780 /* Resolve the length and address operands to numbers */
781
782 status = acpi_ex_resolve_operands(op->common.aml_opcode,
783 ACPI_WALK_OPERANDS, walk_state);
784 if (ACPI_FAILURE(status)) {
785 return_ACPI_STATUS(status);
786 }
787
788 ACPI_DUMP_OPERANDS(ACPI_WALK_OPERANDS, ACPI_IMODE_EXECUTE,
789 acpi_ps_get_opcode_name(op->common.aml_opcode),
790 1, "after AcpiExResolveOperands");
791
792 obj_desc = acpi_ns_get_attached_object(node);
793 if (!obj_desc) {
794 return_ACPI_STATUS(AE_NOT_EXIST);
795 }
796
797 /*
798 * Get the length operand and save it
799 * (at Top of stack)
800 */
801 operand_desc = walk_state->operands[walk_state->num_operands - 1];
802
803 obj_desc->region.length = (u32) operand_desc->integer.value;
804 acpi_ut_remove_reference(operand_desc);
805
806 /*
807 * Get the address and save it
808 * (at top of stack - 1)
809 */
810 operand_desc = walk_state->operands[walk_state->num_operands - 2];
811
812 obj_desc->region.address = (acpi_physical_address)
813 operand_desc->integer.value;
814 acpi_ut_remove_reference(operand_desc);
815
816 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "RgnObj %p Addr %8.8X%8.8X Len %X\n",
817 obj_desc,
818 ACPI_FORMAT_NATIVE_UINT(obj_desc->region.address),
819 obj_desc->region.length));
820
821 /* Now the address and length are valid for this opregion */
822
823 obj_desc->region.flags |= AOPOBJ_DATA_VALID;
824
825 return_ACPI_STATUS(status);
826 }
827
828 /*******************************************************************************
829 *
830 * FUNCTION: acpi_ds_eval_table_region_operands
831 *
832 * PARAMETERS: walk_state - Current walk
833 * Op - A valid region Op object
834 *
835 * RETURN: Status
836 *
837 * DESCRIPTION: Get region address and length
838 * Called from acpi_ds_exec_end_op during data_table_region parse tree walk
839 *
840 ******************************************************************************/
841
842 acpi_status
843 acpi_ds_eval_table_region_operands(struct acpi_walk_state *walk_state,
844 union acpi_parse_object *op)
845 {
846 acpi_status status;
847 union acpi_operand_object *obj_desc;
848 union acpi_operand_object **operand;
849 struct acpi_namespace_node *node;
850 union acpi_parse_object *next_op;
851 acpi_native_uint table_index;
852 struct acpi_table_header *table;
853
854 ACPI_FUNCTION_TRACE_PTR(ds_eval_table_region_operands, op);
855
856 /*
857 * This is where we evaluate the signature_string and oem_iDString
858 * and oem_table_iDString of the data_table_region declaration
859 */
860 node = op->common.node;
861
862 /* next_op points to signature_string op */
863
864 next_op = op->common.value.arg;
865
866 /*
867 * Evaluate/create the signature_string and oem_iDString
868 * and oem_table_iDString operands
869 */
870 status = acpi_ds_create_operands(walk_state, next_op);
871 if (ACPI_FAILURE(status)) {
872 return_ACPI_STATUS(status);
873 }
874
875 /*
876 * Resolve the signature_string and oem_iDString
877 * and oem_table_iDString operands
878 */
879 status = acpi_ex_resolve_operands(op->common.aml_opcode,
880 ACPI_WALK_OPERANDS, walk_state);
881 if (ACPI_FAILURE(status)) {
882 return_ACPI_STATUS(status);
883 }
884
885 ACPI_DUMP_OPERANDS(ACPI_WALK_OPERANDS, ACPI_IMODE_EXECUTE,
886 acpi_ps_get_opcode_name(op->common.aml_opcode),
887 1, "after AcpiExResolveOperands");
888
889 operand = &walk_state->operands[0];
890
891 /* Find the ACPI table */
892
893 status = acpi_tb_find_table(operand[0]->string.pointer,
894 operand[1]->string.pointer,
895 operand[2]->string.pointer, &table_index);
896 if (ACPI_FAILURE(status)) {
897 return_ACPI_STATUS(status);
898 }
899
900 acpi_ut_remove_reference(operand[0]);
901 acpi_ut_remove_reference(operand[1]);
902 acpi_ut_remove_reference(operand[2]);
903
904 status = acpi_get_table_by_index(table_index, &table);
905 if (ACPI_FAILURE(status)) {
906 return_ACPI_STATUS(status);
907 }
908
909 obj_desc = acpi_ns_get_attached_object(node);
910 if (!obj_desc) {
911 return_ACPI_STATUS(AE_NOT_EXIST);
912 }
913
914 obj_desc->region.address =
915 (acpi_physical_address) ACPI_TO_INTEGER(table);
916 obj_desc->region.length = table->length;
917
918 ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "RgnObj %p Addr %8.8X%8.8X Len %X\n",
919 obj_desc,
920 ACPI_FORMAT_NATIVE_UINT(obj_desc->region.address),
921 obj_desc->region.length));
922
923 /* Now the address and length are valid for this opregion */
924
925 obj_desc->region.flags |= AOPOBJ_DATA_VALID;
926
927 return_ACPI_STATUS(status);
928 }
929
930 /*******************************************************************************
931 *
932 * FUNCTION: acpi_ds_eval_data_object_operands
933 *
934 * PARAMETERS: walk_state - Current walk
935 * Op - A valid data_object Op object
936 * obj_desc - data_object
937 *
938 * RETURN: Status
939 *
940 * DESCRIPTION: Get the operands and complete the following data object types:
941 * Buffer, Package.
942 *
943 ******************************************************************************/
944
945 acpi_status
946 acpi_ds_eval_data_object_operands(struct acpi_walk_state *walk_state,
947 union acpi_parse_object *op,
948 union acpi_operand_object *obj_desc)
949 {
950 acpi_status status;
951 union acpi_operand_object *arg_desc;
952 u32 length;
953
954 ACPI_FUNCTION_TRACE(ds_eval_data_object_operands);
955
956 /* The first operand (for all of these data objects) is the length */
957
958 /*
959 * Set proper index into operand stack for acpi_ds_obj_stack_push
960 * invoked inside acpi_ds_create_operand.
961 */
962 walk_state->operand_index = walk_state->num_operands;
963
964 status = acpi_ds_create_operand(walk_state, op->common.value.arg, 1);
965 if (ACPI_FAILURE(status)) {
966 return_ACPI_STATUS(status);
967 }
968
969 status = acpi_ex_resolve_operands(walk_state->opcode,
970 &(walk_state->
971 operands[walk_state->num_operands -
972 1]), walk_state);
973 if (ACPI_FAILURE(status)) {
974 return_ACPI_STATUS(status);
975 }
976
977 /* Extract length operand */
978
979 arg_desc = walk_state->operands[walk_state->num_operands - 1];
980 length = (u32) arg_desc->integer.value;
981
982 /* Cleanup for length operand */
983
984 status = acpi_ds_obj_stack_pop(1, walk_state);
985 if (ACPI_FAILURE(status)) {
986 return_ACPI_STATUS(status);
987 }
988
989 acpi_ut_remove_reference(arg_desc);
990
991 /*
992 * Create the actual data object
993 */
994 switch (op->common.aml_opcode) {
995 case AML_BUFFER_OP:
996
997 status =
998 acpi_ds_build_internal_buffer_obj(walk_state, op, length,
999 &obj_desc);
1000 break;
1001
1002 case AML_PACKAGE_OP:
1003 case AML_VAR_PACKAGE_OP:
1004
1005 status =
1006 acpi_ds_build_internal_package_obj(walk_state, op, length,
1007 &obj_desc);
1008 break;
1009
1010 default:
1011 return_ACPI_STATUS(AE_AML_BAD_OPCODE);
1012 }
1013
1014 if (ACPI_SUCCESS(status)) {
1015 /*
1016 * Return the object in the walk_state, unless the parent is a package -
1017 * in this case, the return object will be stored in the parse tree
1018 * for the package.
1019 */
1020 if ((!op->common.parent) ||
1021 ((op->common.parent->common.aml_opcode != AML_PACKAGE_OP) &&
1022 (op->common.parent->common.aml_opcode !=
1023 AML_VAR_PACKAGE_OP)
1024 && (op->common.parent->common.aml_opcode != AML_NAME_OP))) {
1025 walk_state->result_obj = obj_desc;
1026 }
1027 }
1028
1029 return_ACPI_STATUS(status);
1030 }
1031
1032 /*******************************************************************************
1033 *
1034 * FUNCTION: acpi_ds_eval_bank_field_operands
1035 *
1036 * PARAMETERS: walk_state - Current walk
1037 * Op - A valid bank_field Op object
1038 *
1039 * RETURN: Status
1040 *
1041 * DESCRIPTION: Get bank_field bank_value
1042 * Called from acpi_ds_exec_end_op during bank_field parse tree walk
1043 *
1044 ******************************************************************************/
1045
1046 acpi_status
1047 acpi_ds_eval_bank_field_operands(struct acpi_walk_state *walk_state,
1048 union acpi_parse_object *op)
1049 {
1050 acpi_status status;
1051 union acpi_operand_object *obj_desc;
1052 union acpi_operand_object *operand_desc;
1053 struct acpi_namespace_node *node;
1054 union acpi_parse_object *next_op;
1055 union acpi_parse_object *arg;
1056
1057 ACPI_FUNCTION_TRACE_PTR(ds_eval_bank_field_operands, op);
1058
1059 /*
1060 * This is where we evaluate the bank_value field of the
1061 * bank_field declaration
1062 */
1063
1064 /* next_op points to the op that holds the Region */
1065
1066 next_op = op->common.value.arg;
1067
1068 /* next_op points to the op that holds the Bank Register */
1069
1070 next_op = next_op->common.next;
1071
1072 /* next_op points to the op that holds the Bank Value */
1073
1074 next_op = next_op->common.next;
1075
1076 /*
1077 * Set proper index into operand stack for acpi_ds_obj_stack_push
1078 * invoked inside acpi_ds_create_operand.
1079 *
1080 * We use walk_state->Operands[0] to store the evaluated bank_value
1081 */
1082 walk_state->operand_index = 0;
1083
1084 status = acpi_ds_create_operand(walk_state, next_op, 0);
1085 if (ACPI_FAILURE(status)) {
1086 return_ACPI_STATUS(status);
1087 }
1088
1089 status = acpi_ex_resolve_to_value(&walk_state->operands[0], walk_state);
1090 if (ACPI_FAILURE(status)) {
1091 return_ACPI_STATUS(status);
1092 }
1093
1094 ACPI_DUMP_OPERANDS(ACPI_WALK_OPERANDS, ACPI_IMODE_EXECUTE,
1095 acpi_ps_get_opcode_name(op->common.aml_opcode),
1096 1, "after AcpiExResolveOperands");
1097
1098 /*
1099 * Get the bank_value operand and save it
1100 * (at Top of stack)
1101 */
1102 operand_desc = walk_state->operands[0];
1103
1104 /* Arg points to the start Bank Field */
1105
1106 arg = acpi_ps_get_arg(op, 4);
1107 while (arg) {
1108
1109 /* Ignore OFFSET and ACCESSAS terms here */
1110
1111 if (arg->common.aml_opcode == AML_INT_NAMEDFIELD_OP) {
1112 node = arg->common.node;
1113
1114 obj_desc = acpi_ns_get_attached_object(node);
1115 if (!obj_desc) {
1116 return_ACPI_STATUS(AE_NOT_EXIST);
1117 }
1118
1119 obj_desc->bank_field.value =
1120 (u32) operand_desc->integer.value;
1121 }
1122
1123 /* Move to next field in the list */
1124
1125 arg = arg->common.next;
1126 }
1127
1128 acpi_ut_remove_reference(operand_desc);
1129 return_ACPI_STATUS(status);
1130 }
1131
1132 /*******************************************************************************
1133 *
1134 * FUNCTION: acpi_ds_exec_begin_control_op
1135 *
1136 * PARAMETERS: walk_list - The list that owns the walk stack
1137 * Op - The control Op
1138 *
1139 * RETURN: Status
1140 *
1141 * DESCRIPTION: Handles all control ops encountered during control method
1142 * execution.
1143 *
1144 ******************************************************************************/
1145
1146 acpi_status
1147 acpi_ds_exec_begin_control_op(struct acpi_walk_state *walk_state,
1148 union acpi_parse_object *op)
1149 {
1150 acpi_status status = AE_OK;
1151 union acpi_generic_state *control_state;
1152
1153 ACPI_FUNCTION_NAME(ds_exec_begin_control_op);
1154
1155 ACPI_DEBUG_PRINT((ACPI_DB_DISPATCH, "Op=%p Opcode=%2.2X State=%p\n", op,
1156 op->common.aml_opcode, walk_state));
1157
1158 switch (op->common.aml_opcode) {
1159 case AML_IF_OP:
1160 case AML_WHILE_OP:
1161
1162 /*
1163 * IF/WHILE: Create a new control state to manage these
1164 * constructs. We need to manage these as a stack, in order
1165 * to handle nesting.
1166 */
1167 control_state = acpi_ut_create_control_state();
1168 if (!control_state) {
1169 status = AE_NO_MEMORY;
1170 break;
1171 }
1172 /*
1173 * Save a pointer to the predicate for multiple executions
1174 * of a loop
1175 */
1176 control_state->control.aml_predicate_start =
1177 walk_state->parser_state.aml - 1;
1178 control_state->control.package_end =
1179 walk_state->parser_state.pkg_end;
1180 control_state->control.opcode = op->common.aml_opcode;
1181
1182 /* Push the control state on this walk's control stack */
1183
1184 acpi_ut_push_generic_state(&walk_state->control_state,
1185 control_state);
1186 break;
1187
1188 case AML_ELSE_OP:
1189
1190 /* Predicate is in the state object */
1191 /* If predicate is true, the IF was executed, ignore ELSE part */
1192
1193 if (walk_state->last_predicate) {
1194 status = AE_CTRL_TRUE;
1195 }
1196
1197 break;
1198
1199 case AML_RETURN_OP:
1200
1201 break;
1202
1203 default:
1204 break;
1205 }
1206
1207 return (status);
1208 }
1209
1210 /*******************************************************************************
1211 *
1212 * FUNCTION: acpi_ds_exec_end_control_op
1213 *
1214 * PARAMETERS: walk_list - The list that owns the walk stack
1215 * Op - The control Op
1216 *
1217 * RETURN: Status
1218 *
1219 * DESCRIPTION: Handles all control ops encountered during control method
1220 * execution.
1221 *
1222 ******************************************************************************/
1223
1224 acpi_status
1225 acpi_ds_exec_end_control_op(struct acpi_walk_state * walk_state,
1226 union acpi_parse_object * op)
1227 {
1228 acpi_status status = AE_OK;
1229 union acpi_generic_state *control_state;
1230
1231 ACPI_FUNCTION_NAME(ds_exec_end_control_op);
1232
1233 switch (op->common.aml_opcode) {
1234 case AML_IF_OP:
1235
1236 ACPI_DEBUG_PRINT((ACPI_DB_DISPATCH, "[IF_OP] Op=%p\n", op));
1237
1238 /*
1239 * Save the result of the predicate in case there is an
1240 * ELSE to come
1241 */
1242 walk_state->last_predicate =
1243 (u8) walk_state->control_state->common.value;
1244
1245 /*
1246 * Pop the control state that was created at the start
1247 * of the IF and free it
1248 */
1249 control_state =
1250 acpi_ut_pop_generic_state(&walk_state->control_state);
1251 acpi_ut_delete_generic_state(control_state);
1252 break;
1253
1254 case AML_ELSE_OP:
1255
1256 break;
1257
1258 case AML_WHILE_OP:
1259
1260 ACPI_DEBUG_PRINT((ACPI_DB_DISPATCH, "[WHILE_OP] Op=%p\n", op));
1261
1262 if (walk_state->control_state->common.value) {
1263
1264 /* Predicate was true, go back and evaluate it again! */
1265
1266 status = AE_CTRL_PENDING;
1267 }
1268
1269 ACPI_DEBUG_PRINT((ACPI_DB_DISPATCH,
1270 "[WHILE_OP] termination! Op=%p\n", op));
1271
1272 /* Pop this control state and free it */
1273
1274 control_state =
1275 acpi_ut_pop_generic_state(&walk_state->control_state);
1276
1277 walk_state->aml_last_while =
1278 control_state->control.aml_predicate_start;
1279 acpi_ut_delete_generic_state(control_state);
1280 break;
1281
1282 case AML_RETURN_OP:
1283
1284 ACPI_DEBUG_PRINT((ACPI_DB_DISPATCH,
1285 "[RETURN_OP] Op=%p Arg=%p\n", op,
1286 op->common.value.arg));
1287
1288 /*
1289 * One optional operand -- the return value
1290 * It can be either an immediate operand or a result that
1291 * has been bubbled up the tree
1292 */
1293 if (op->common.value.arg) {
1294
1295 /* Since we have a real Return(), delete any implicit return */
1296
1297 acpi_ds_clear_implicit_return(walk_state);
1298
1299 /* Return statement has an immediate operand */
1300
1301 status =
1302 acpi_ds_create_operands(walk_state,
1303 op->common.value.arg);
1304 if (ACPI_FAILURE(status)) {
1305 return (status);
1306 }
1307
1308 /*
1309 * If value being returned is a Reference (such as
1310 * an arg or local), resolve it now because it may
1311 * cease to exist at the end of the method.
1312 */
1313 status =
1314 acpi_ex_resolve_to_value(&walk_state->operands[0],
1315 walk_state);
1316 if (ACPI_FAILURE(status)) {
1317 return (status);
1318 }
1319
1320 /*
1321 * Get the return value and save as the last result
1322 * value. This is the only place where walk_state->return_desc
1323 * is set to anything other than zero!
1324 */
1325 walk_state->return_desc = walk_state->operands[0];
1326 } else if (walk_state->result_count) {
1327
1328 /* Since we have a real Return(), delete any implicit return */
1329
1330 acpi_ds_clear_implicit_return(walk_state);
1331
1332 /*
1333 * The return value has come from a previous calculation.
1334 *
1335 * If value being returned is a Reference (such as
1336 * an arg or local), resolve it now because it may
1337 * cease to exist at the end of the method.
1338 *
1339 * Allow references created by the Index operator to return unchanged.
1340 */
1341 if ((ACPI_GET_DESCRIPTOR_TYPE
1342 (walk_state->results->results.obj_desc[0]) ==
1343 ACPI_DESC_TYPE_OPERAND)
1344 &&
1345 (ACPI_GET_OBJECT_TYPE
1346 (walk_state->results->results.obj_desc[0]) ==
1347 ACPI_TYPE_LOCAL_REFERENCE)
1348 && ((walk_state->results->results.obj_desc[0])->
1349 reference.opcode != AML_INDEX_OP)) {
1350 status =
1351 acpi_ex_resolve_to_value(&walk_state->
1352 results->results.
1353 obj_desc[0],
1354 walk_state);
1355 if (ACPI_FAILURE(status)) {
1356 return (status);
1357 }
1358 }
1359
1360 walk_state->return_desc =
1361 walk_state->results->results.obj_desc[0];
1362 } else {
1363 /* No return operand */
1364
1365 if (walk_state->num_operands) {
1366 acpi_ut_remove_reference(walk_state->
1367 operands[0]);
1368 }
1369
1370 walk_state->operands[0] = NULL;
1371 walk_state->num_operands = 0;
1372 walk_state->return_desc = NULL;
1373 }
1374
1375 ACPI_DEBUG_PRINT((ACPI_DB_DISPATCH,
1376 "Completed RETURN_OP State=%p, RetVal=%p\n",
1377 walk_state, walk_state->return_desc));
1378
1379 /* End the control method execution right now */
1380
1381 status = AE_CTRL_TERMINATE;
1382 break;
1383
1384 case AML_NOOP_OP:
1385
1386 /* Just do nothing! */
1387 break;
1388
1389 case AML_BREAK_POINT_OP:
1390
1391 /* Call up to the OS service layer to handle this */
1392
1393 status =
1394 acpi_os_signal(ACPI_SIGNAL_BREAKPOINT,
1395 "Executed AML Breakpoint opcode");
1396
1397 /* If and when it returns, all done. */
1398
1399 break;
1400
1401 case AML_BREAK_OP:
1402 case AML_CONTINUE_OP: /* ACPI 2.0 */
1403
1404 /* Pop and delete control states until we find a while */
1405
1406 while (walk_state->control_state &&
1407 (walk_state->control_state->control.opcode !=
1408 AML_WHILE_OP)) {
1409 control_state =
1410 acpi_ut_pop_generic_state(&walk_state->
1411 control_state);
1412 acpi_ut_delete_generic_state(control_state);
1413 }
1414
1415 /* No while found? */
1416
1417 if (!walk_state->control_state) {
1418 return (AE_AML_NO_WHILE);
1419 }
1420
1421 /* Was: walk_state->aml_last_while = walk_state->control_state->Control.aml_predicate_start; */
1422
1423 walk_state->aml_last_while =
1424 walk_state->control_state->control.package_end;
1425
1426 /* Return status depending on opcode */
1427
1428 if (op->common.aml_opcode == AML_BREAK_OP) {
1429 status = AE_CTRL_BREAK;
1430 } else {
1431 status = AE_CTRL_CONTINUE;
1432 }
1433 break;
1434
1435 default:
1436
1437 ACPI_ERROR((AE_INFO, "Unknown control opcode=%X Op=%p",
1438 op->common.aml_opcode, op));
1439
1440 status = AE_AML_BAD_OPCODE;
1441 break;
1442 }
1443
1444 return (status);
1445 }
Linux kernel - Deliverables
This page took 0.096601 seconds and 5 git commands to generate.