1 /******************************************************************************
3 * Module Name: dsopcode - Dispatcher support for regions and fields
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2016, Intel Corp.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions, and the following disclaimer,
16 * without modification.
17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 * substantially similar to the "NO WARRANTY" disclaimer below
19 * ("Disclaimer") and any redistribution must be conditioned upon
20 * including a substantially similar Disclaimer requirement for further
21 * binary redistribution.
22 * 3. Neither the names of the above-listed copyright holders nor the names
23 * of any contributors may be used to endorse or promote products derived
24 * from this software without specific prior written permission.
26 * Alternatively, this software may be distributed under the terms of the
27 * GNU General Public License ("GPL") version 2 as published by the Free
28 * Software Foundation.
31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 * POSSIBILITY OF SUCH DAMAGES.
44 #include <acpi/acpi.h>
54 #define _COMPONENT ACPI_DISPATCHER
55 ACPI_MODULE_NAME("dsopcode")
57 /* Local prototypes */
59 acpi_ds_init_buffer_field(u16 aml_opcode
,
60 union acpi_operand_object
*obj_desc
,
61 union acpi_operand_object
*buffer_desc
,
62 union acpi_operand_object
*offset_desc
,
63 union acpi_operand_object
*length_desc
,
64 union acpi_operand_object
*result_desc
);
66 /*******************************************************************************
68 * FUNCTION: acpi_ds_initialize_region
70 * PARAMETERS: obj_handle - Region namespace node
74 * DESCRIPTION: Front end to ev_initialize_region
76 ******************************************************************************/
78 acpi_status
acpi_ds_initialize_region(acpi_handle obj_handle
)
80 union acpi_operand_object
*obj_desc
;
83 obj_desc
= acpi_ns_get_attached_object(obj_handle
);
85 /* Namespace is NOT locked */
87 status
= acpi_ev_initialize_region(obj_desc
);
91 /*******************************************************************************
93 * FUNCTION: acpi_ds_init_buffer_field
95 * PARAMETERS: aml_opcode - create_xxx_field
96 * obj_desc - buffer_field object
97 * buffer_desc - Host Buffer
98 * offset_desc - Offset into buffer
99 * length_desc - Length of field (CREATE_FIELD_OP only)
100 * result_desc - Where to store the result
104 * DESCRIPTION: Perform actual initialization of a buffer field
106 ******************************************************************************/
109 acpi_ds_init_buffer_field(u16 aml_opcode
,
110 union acpi_operand_object
*obj_desc
,
111 union acpi_operand_object
*buffer_desc
,
112 union acpi_operand_object
*offset_desc
,
113 union acpi_operand_object
*length_desc
,
114 union acpi_operand_object
*result_desc
)
122 ACPI_FUNCTION_TRACE_PTR(ds_init_buffer_field
, obj_desc
);
124 /* Host object must be a Buffer */
126 if (buffer_desc
->common
.type
!= ACPI_TYPE_BUFFER
) {
128 "Target of Create Field is not a Buffer object - %s",
129 acpi_ut_get_object_type_name(buffer_desc
)));
131 status
= AE_AML_OPERAND_TYPE
;
136 * The last parameter to all of these opcodes (result_desc) started
137 * out as a name_string, and should therefore now be a NS node
138 * after resolution in acpi_ex_resolve_operands().
140 if (ACPI_GET_DESCRIPTOR_TYPE(result_desc
) != ACPI_DESC_TYPE_NAMED
) {
142 "(%s) destination not a NS Node [%s]",
143 acpi_ps_get_opcode_name(aml_opcode
),
144 acpi_ut_get_descriptor_name(result_desc
)));
146 status
= AE_AML_OPERAND_TYPE
;
150 offset
= (u32
) offset_desc
->integer
.value
;
153 * Setup the Bit offsets and counts, according to the opcode
155 switch (aml_opcode
) {
156 case AML_CREATE_FIELD_OP
:
158 /* Offset is in bits, count is in bits */
160 field_flags
= AML_FIELD_ACCESS_BYTE
;
162 bit_count
= (u32
) length_desc
->integer
.value
;
164 /* Must have a valid (>0) bit count */
166 if (bit_count
== 0) {
168 "Attempt to CreateField of length zero"));
169 status
= AE_AML_OPERAND_VALUE
;
174 case AML_CREATE_BIT_FIELD_OP
:
176 /* Offset is in bits, Field is one bit */
180 field_flags
= AML_FIELD_ACCESS_BYTE
;
183 case AML_CREATE_BYTE_FIELD_OP
:
185 /* Offset is in bytes, field is one byte */
187 bit_offset
= 8 * offset
;
189 field_flags
= AML_FIELD_ACCESS_BYTE
;
192 case AML_CREATE_WORD_FIELD_OP
:
194 /* Offset is in bytes, field is one word */
196 bit_offset
= 8 * offset
;
198 field_flags
= AML_FIELD_ACCESS_WORD
;
201 case AML_CREATE_DWORD_FIELD_OP
:
203 /* Offset is in bytes, field is one dword */
205 bit_offset
= 8 * offset
;
207 field_flags
= AML_FIELD_ACCESS_DWORD
;
210 case AML_CREATE_QWORD_FIELD_OP
:
212 /* Offset is in bytes, field is one qword */
214 bit_offset
= 8 * offset
;
216 field_flags
= AML_FIELD_ACCESS_QWORD
;
222 "Unknown field creation opcode 0x%02X",
224 status
= AE_AML_BAD_OPCODE
;
228 /* Entire field must fit within the current length of the buffer */
230 if ((bit_offset
+ bit_count
) > (8 * (u32
) buffer_desc
->buffer
.length
)) {
232 "Field [%4.4s] at %u exceeds Buffer [%4.4s] size %u (bits)",
233 acpi_ut_get_node_name(result_desc
),
234 bit_offset
+ bit_count
,
235 acpi_ut_get_node_name(buffer_desc
->buffer
.node
),
236 8 * (u32
) buffer_desc
->buffer
.length
));
237 status
= AE_AML_BUFFER_LIMIT
;
242 * Initialize areas of the field object that are common to all fields
243 * For field_flags, use LOCK_RULE = 0 (NO_LOCK),
244 * UPDATE_RULE = 0 (UPDATE_PRESERVE)
247 acpi_ex_prep_common_field_object(obj_desc
, field_flags
, 0,
248 bit_offset
, bit_count
);
249 if (ACPI_FAILURE(status
)) {
253 obj_desc
->buffer_field
.buffer_obj
= buffer_desc
;
255 /* Reference count for buffer_desc inherits obj_desc count */
257 buffer_desc
->common
.reference_count
= (u16
)
258 (buffer_desc
->common
.reference_count
+
259 obj_desc
->common
.reference_count
);
263 /* Always delete the operands */
265 acpi_ut_remove_reference(offset_desc
);
266 acpi_ut_remove_reference(buffer_desc
);
268 if (aml_opcode
== AML_CREATE_FIELD_OP
) {
269 acpi_ut_remove_reference(length_desc
);
272 /* On failure, delete the result descriptor */
274 if (ACPI_FAILURE(status
)) {
275 acpi_ut_remove_reference(result_desc
); /* Result descriptor */
277 /* Now the address and length are valid for this buffer_field */
279 obj_desc
->buffer_field
.flags
|= AOPOBJ_DATA_VALID
;
282 return_ACPI_STATUS(status
);
285 /*******************************************************************************
287 * FUNCTION: acpi_ds_eval_buffer_field_operands
289 * PARAMETERS: walk_state - Current walk
290 * op - A valid buffer_field Op object
294 * DESCRIPTION: Get buffer_field Buffer and Index
295 * Called from acpi_ds_exec_end_op during buffer_field parse tree walk
297 ******************************************************************************/
300 acpi_ds_eval_buffer_field_operands(struct acpi_walk_state
*walk_state
,
301 union acpi_parse_object
*op
)
304 union acpi_operand_object
*obj_desc
;
305 struct acpi_namespace_node
*node
;
306 union acpi_parse_object
*next_op
;
308 ACPI_FUNCTION_TRACE_PTR(ds_eval_buffer_field_operands
, op
);
311 * This is where we evaluate the address and length fields of the
312 * create_xxx_field declaration
314 node
= op
->common
.node
;
316 /* next_op points to the op that holds the Buffer */
318 next_op
= op
->common
.value
.arg
;
320 /* Evaluate/create the address and length operands */
322 status
= acpi_ds_create_operands(walk_state
, next_op
);
323 if (ACPI_FAILURE(status
)) {
324 return_ACPI_STATUS(status
);
327 obj_desc
= acpi_ns_get_attached_object(node
);
329 return_ACPI_STATUS(AE_NOT_EXIST
);
332 /* Resolve the operands */
335 acpi_ex_resolve_operands(op
->common
.aml_opcode
, ACPI_WALK_OPERANDS
,
337 if (ACPI_FAILURE(status
)) {
338 ACPI_ERROR((AE_INFO
, "(%s) bad operand(s), status 0x%X",
339 acpi_ps_get_opcode_name(op
->common
.aml_opcode
),
342 return_ACPI_STATUS(status
);
345 /* Initialize the Buffer Field */
347 if (op
->common
.aml_opcode
== AML_CREATE_FIELD_OP
) {
349 /* NOTE: Slightly different operands for this opcode */
352 acpi_ds_init_buffer_field(op
->common
.aml_opcode
, obj_desc
,
353 walk_state
->operands
[0],
354 walk_state
->operands
[1],
355 walk_state
->operands
[2],
356 walk_state
->operands
[3]);
358 /* All other, create_xxx_field opcodes */
361 acpi_ds_init_buffer_field(op
->common
.aml_opcode
, obj_desc
,
362 walk_state
->operands
[0],
363 walk_state
->operands
[1], NULL
,
364 walk_state
->operands
[2]);
367 return_ACPI_STATUS(status
);
370 /*******************************************************************************
372 * FUNCTION: acpi_ds_eval_region_operands
374 * PARAMETERS: walk_state - Current walk
375 * op - A valid region Op object
379 * DESCRIPTION: Get region address and length
380 * Called from acpi_ds_exec_end_op during op_region parse tree walk
382 ******************************************************************************/
385 acpi_ds_eval_region_operands(struct acpi_walk_state
*walk_state
,
386 union acpi_parse_object
*op
)
389 union acpi_operand_object
*obj_desc
;
390 union acpi_operand_object
*operand_desc
;
391 struct acpi_namespace_node
*node
;
392 union acpi_parse_object
*next_op
;
394 ACPI_FUNCTION_TRACE_PTR(ds_eval_region_operands
, op
);
397 * This is where we evaluate the address and length fields of the
398 * op_region declaration
400 node
= op
->common
.node
;
402 /* next_op points to the op that holds the space_ID */
404 next_op
= op
->common
.value
.arg
;
406 /* next_op points to address op */
408 next_op
= next_op
->common
.next
;
410 /* Evaluate/create the address and length operands */
412 status
= acpi_ds_create_operands(walk_state
, next_op
);
413 if (ACPI_FAILURE(status
)) {
414 return_ACPI_STATUS(status
);
417 /* Resolve the length and address operands to numbers */
420 acpi_ex_resolve_operands(op
->common
.aml_opcode
, ACPI_WALK_OPERANDS
,
422 if (ACPI_FAILURE(status
)) {
423 return_ACPI_STATUS(status
);
426 obj_desc
= acpi_ns_get_attached_object(node
);
428 return_ACPI_STATUS(AE_NOT_EXIST
);
432 * Get the length operand and save it
435 operand_desc
= walk_state
->operands
[walk_state
->num_operands
- 1];
437 obj_desc
->region
.length
= (u32
) operand_desc
->integer
.value
;
438 acpi_ut_remove_reference(operand_desc
);
441 * Get the address and save it
442 * (at top of stack - 1)
444 operand_desc
= walk_state
->operands
[walk_state
->num_operands
- 2];
446 obj_desc
->region
.address
= (acpi_physical_address
)
447 operand_desc
->integer
.value
;
448 acpi_ut_remove_reference(operand_desc
);
450 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
, "RgnObj %p Addr %8.8X%8.8X Len %X\n",
452 ACPI_FORMAT_UINT64(obj_desc
->region
.address
),
453 obj_desc
->region
.length
));
455 /* Now the address and length are valid for this opregion */
457 obj_desc
->region
.flags
|= AOPOBJ_DATA_VALID
;
458 return_ACPI_STATUS(status
);
461 /*******************************************************************************
463 * FUNCTION: acpi_ds_eval_table_region_operands
465 * PARAMETERS: walk_state - Current walk
466 * op - A valid region Op object
470 * DESCRIPTION: Get region address and length.
471 * Called from acpi_ds_exec_end_op during data_table_region parse
474 ******************************************************************************/
477 acpi_ds_eval_table_region_operands(struct acpi_walk_state
*walk_state
,
478 union acpi_parse_object
*op
)
481 union acpi_operand_object
*obj_desc
;
482 union acpi_operand_object
**operand
;
483 struct acpi_namespace_node
*node
;
484 union acpi_parse_object
*next_op
;
485 struct acpi_table_header
*table
;
488 ACPI_FUNCTION_TRACE_PTR(ds_eval_table_region_operands
, op
);
491 * This is where we evaluate the Signature string, oem_id string,
492 * and oem_table_id string of the Data Table Region declaration
494 node
= op
->common
.node
;
496 /* next_op points to Signature string op */
498 next_op
= op
->common
.value
.arg
;
501 * Evaluate/create the Signature string, oem_id string,
502 * and oem_table_id string operands
504 status
= acpi_ds_create_operands(walk_state
, next_op
);
505 if (ACPI_FAILURE(status
)) {
506 return_ACPI_STATUS(status
);
509 operand
= &walk_state
->operands
[0];
512 * Resolve the Signature string, oem_id string,
513 * and oem_table_id string operands
516 acpi_ex_resolve_operands(op
->common
.aml_opcode
, ACPI_WALK_OPERANDS
,
518 if (ACPI_FAILURE(status
)) {
522 /* Find the ACPI table */
524 status
= acpi_tb_find_table(operand
[0]->string
.pointer
,
525 operand
[1]->string
.pointer
,
526 operand
[2]->string
.pointer
, &table_index
);
527 if (ACPI_FAILURE(status
)) {
528 if (status
== AE_NOT_FOUND
) {
530 "ACPI Table [%4.4s] OEM:(%s, %s) not found in RSDT/XSDT",
531 operand
[0]->string
.pointer
,
532 operand
[1]->string
.pointer
,
533 operand
[2]->string
.pointer
));
538 status
= acpi_get_table_by_index(table_index
, &table
);
539 if (ACPI_FAILURE(status
)) {
543 obj_desc
= acpi_ns_get_attached_object(node
);
545 status
= AE_NOT_EXIST
;
549 obj_desc
->region
.address
= ACPI_PTR_TO_PHYSADDR(table
);
550 obj_desc
->region
.length
= table
->length
;
552 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
, "RgnObj %p Addr %8.8X%8.8X Len %X\n",
554 ACPI_FORMAT_UINT64(obj_desc
->region
.address
),
555 obj_desc
->region
.length
));
557 /* Now the address and length are valid for this opregion */
559 obj_desc
->region
.flags
|= AOPOBJ_DATA_VALID
;
562 acpi_ut_remove_reference(operand
[0]);
563 acpi_ut_remove_reference(operand
[1]);
564 acpi_ut_remove_reference(operand
[2]);
566 return_ACPI_STATUS(status
);
569 /*******************************************************************************
571 * FUNCTION: acpi_ds_eval_data_object_operands
573 * PARAMETERS: walk_state - Current walk
574 * op - A valid data_object Op object
575 * obj_desc - data_object
579 * DESCRIPTION: Get the operands and complete the following data object types:
582 ******************************************************************************/
585 acpi_ds_eval_data_object_operands(struct acpi_walk_state
*walk_state
,
586 union acpi_parse_object
*op
,
587 union acpi_operand_object
*obj_desc
)
590 union acpi_operand_object
*arg_desc
;
593 ACPI_FUNCTION_TRACE(ds_eval_data_object_operands
);
595 /* The first operand (for all of these data objects) is the length */
598 * Set proper index into operand stack for acpi_ds_obj_stack_push
599 * invoked inside acpi_ds_create_operand.
601 walk_state
->operand_index
= walk_state
->num_operands
;
603 status
= acpi_ds_create_operand(walk_state
, op
->common
.value
.arg
, 1);
604 if (ACPI_FAILURE(status
)) {
605 return_ACPI_STATUS(status
);
608 status
= acpi_ex_resolve_operands(walk_state
->opcode
,
610 operands
[walk_state
->num_operands
-
612 if (ACPI_FAILURE(status
)) {
613 return_ACPI_STATUS(status
);
616 /* Extract length operand */
618 arg_desc
= walk_state
->operands
[walk_state
->num_operands
- 1];
619 length
= (u32
) arg_desc
->integer
.value
;
621 /* Cleanup for length operand */
623 status
= acpi_ds_obj_stack_pop(1, walk_state
);
624 if (ACPI_FAILURE(status
)) {
625 return_ACPI_STATUS(status
);
628 acpi_ut_remove_reference(arg_desc
);
631 * Create the actual data object
633 switch (op
->common
.aml_opcode
) {
637 acpi_ds_build_internal_buffer_obj(walk_state
, op
, length
,
642 case AML_VAR_PACKAGE_OP
:
645 acpi_ds_build_internal_package_obj(walk_state
, op
, length
,
651 return_ACPI_STATUS(AE_AML_BAD_OPCODE
);
654 if (ACPI_SUCCESS(status
)) {
656 * Return the object in the walk_state, unless the parent is a package -
657 * in this case, the return object will be stored in the parse tree
660 if ((!op
->common
.parent
) ||
661 ((op
->common
.parent
->common
.aml_opcode
!= AML_PACKAGE_OP
) &&
662 (op
->common
.parent
->common
.aml_opcode
!=
664 && (op
->common
.parent
->common
.aml_opcode
!=
666 walk_state
->result_obj
= obj_desc
;
670 return_ACPI_STATUS(status
);
673 /*******************************************************************************
675 * FUNCTION: acpi_ds_eval_bank_field_operands
677 * PARAMETERS: walk_state - Current walk
678 * op - A valid bank_field Op object
682 * DESCRIPTION: Get bank_field bank_value
683 * Called from acpi_ds_exec_end_op during bank_field parse tree walk
685 ******************************************************************************/
688 acpi_ds_eval_bank_field_operands(struct acpi_walk_state
*walk_state
,
689 union acpi_parse_object
*op
)
692 union acpi_operand_object
*obj_desc
;
693 union acpi_operand_object
*operand_desc
;
694 struct acpi_namespace_node
*node
;
695 union acpi_parse_object
*next_op
;
696 union acpi_parse_object
*arg
;
698 ACPI_FUNCTION_TRACE_PTR(ds_eval_bank_field_operands
, op
);
701 * This is where we evaluate the bank_value field of the
702 * bank_field declaration
705 /* next_op points to the op that holds the Region */
707 next_op
= op
->common
.value
.arg
;
709 /* next_op points to the op that holds the Bank Register */
711 next_op
= next_op
->common
.next
;
713 /* next_op points to the op that holds the Bank Value */
715 next_op
= next_op
->common
.next
;
718 * Set proper index into operand stack for acpi_ds_obj_stack_push
719 * invoked inside acpi_ds_create_operand.
721 * We use walk_state->Operands[0] to store the evaluated bank_value
723 walk_state
->operand_index
= 0;
725 status
= acpi_ds_create_operand(walk_state
, next_op
, 0);
726 if (ACPI_FAILURE(status
)) {
727 return_ACPI_STATUS(status
);
730 status
= acpi_ex_resolve_to_value(&walk_state
->operands
[0], walk_state
);
731 if (ACPI_FAILURE(status
)) {
732 return_ACPI_STATUS(status
);
735 ACPI_DUMP_OPERANDS(ACPI_WALK_OPERANDS
,
736 acpi_ps_get_opcode_name(op
->common
.aml_opcode
), 1);
738 * Get the bank_value operand and save it
741 operand_desc
= walk_state
->operands
[0];
743 /* Arg points to the start Bank Field */
745 arg
= acpi_ps_get_arg(op
, 4);
748 /* Ignore OFFSET and ACCESSAS terms here */
750 if (arg
->common
.aml_opcode
== AML_INT_NAMEDFIELD_OP
) {
751 node
= arg
->common
.node
;
753 obj_desc
= acpi_ns_get_attached_object(node
);
755 return_ACPI_STATUS(AE_NOT_EXIST
);
758 obj_desc
->bank_field
.value
=
759 (u32
) operand_desc
->integer
.value
;
762 /* Move to next field in the list */
764 arg
= arg
->common
.next
;
767 acpi_ut_remove_reference(operand_desc
);
768 return_ACPI_STATUS(status
);