1 | // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 |
2 | /****************************************************************************** |
3 | * |
4 | * Module Name: exresnte - AML Interpreter object resolution |
5 | * |
6 | * Copyright (C) 2000 - 2023, Intel Corp. |
7 | * |
8 | *****************************************************************************/ |
9 | |
10 | #include <acpi/acpi.h> |
11 | #include "accommon.h" |
12 | #include "acdispat.h" |
13 | #include "acinterp.h" |
14 | #include "acnamesp.h" |
15 | |
16 | #define _COMPONENT ACPI_EXECUTER |
17 | ACPI_MODULE_NAME("exresnte" ) |
18 | |
19 | /******************************************************************************* |
20 | * |
21 | * FUNCTION: acpi_ex_resolve_node_to_value |
22 | * |
23 | * PARAMETERS: object_ptr - Pointer to a location that contains |
24 | * a pointer to a NS node, and will receive a |
25 | * pointer to the resolved object. |
26 | * walk_state - Current state. Valid only if executing AML |
27 | * code. NULL if simply resolving an object |
28 | * |
29 | * RETURN: Status |
30 | * |
31 | * DESCRIPTION: Resolve a Namespace node to a valued object |
32 | * |
33 | * Note: for some of the data types, the pointer attached to the Node |
34 | * can be either a pointer to an actual internal object or a pointer into the |
35 | * AML stream itself. These types are currently: |
36 | * |
37 | * ACPI_TYPE_INTEGER |
38 | * ACPI_TYPE_STRING |
39 | * ACPI_TYPE_BUFFER |
40 | * ACPI_TYPE_MUTEX |
41 | * ACPI_TYPE_PACKAGE |
42 | * |
43 | ******************************************************************************/ |
44 | acpi_status |
45 | acpi_ex_resolve_node_to_value(struct acpi_namespace_node **object_ptr, |
46 | struct acpi_walk_state *walk_state) |
47 | { |
48 | acpi_status status = AE_OK; |
49 | union acpi_operand_object *source_desc; |
50 | union acpi_operand_object *obj_desc = NULL; |
51 | struct acpi_namespace_node *node; |
52 | acpi_object_type entry_type; |
53 | |
54 | ACPI_FUNCTION_TRACE(ex_resolve_node_to_value); |
55 | |
56 | /* |
57 | * The stack pointer points to a struct acpi_namespace_node (Node). Get the |
58 | * object that is attached to the Node. |
59 | */ |
60 | node = *object_ptr; |
61 | source_desc = acpi_ns_get_attached_object(node); |
62 | entry_type = acpi_ns_get_type(node: (acpi_handle)node); |
63 | |
64 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Entry=%p SourceDesc=%p [%s]\n" , |
65 | node, source_desc, |
66 | acpi_ut_get_type_name(entry_type))); |
67 | |
68 | if ((entry_type == ACPI_TYPE_LOCAL_ALIAS) || |
69 | (entry_type == ACPI_TYPE_LOCAL_METHOD_ALIAS)) { |
70 | |
71 | /* There is always exactly one level of indirection */ |
72 | |
73 | node = ACPI_CAST_PTR(struct acpi_namespace_node, node->object); |
74 | source_desc = acpi_ns_get_attached_object(node); |
75 | entry_type = acpi_ns_get_type(node: (acpi_handle)node); |
76 | *object_ptr = node; |
77 | } |
78 | |
79 | /* |
80 | * Several object types require no further processing: |
81 | * 1) Device/Thermal objects don't have a "real" subobject, return Node |
82 | * 2) Method locals and arguments have a pseudo-Node |
83 | * 3) 10/2007: Added method type to assist with Package construction. |
84 | */ |
85 | if ((entry_type == ACPI_TYPE_DEVICE) || |
86 | (entry_type == ACPI_TYPE_THERMAL) || |
87 | (entry_type == ACPI_TYPE_METHOD) || |
88 | (node->flags & (ANOBJ_METHOD_ARG | ANOBJ_METHOD_LOCAL))) { |
89 | return_ACPI_STATUS(AE_OK); |
90 | } |
91 | |
92 | if (!source_desc) { |
93 | ACPI_ERROR((AE_INFO, "No object attached to node [%4.4s] %p" , |
94 | node->name.ascii, node)); |
95 | return_ACPI_STATUS(AE_AML_UNINITIALIZED_NODE); |
96 | } |
97 | |
98 | /* |
99 | * Action is based on the type of the Node, which indicates the type |
100 | * of the attached object or pointer |
101 | */ |
102 | switch (entry_type) { |
103 | case ACPI_TYPE_PACKAGE: |
104 | |
105 | if (source_desc->common.type != ACPI_TYPE_PACKAGE) { |
106 | ACPI_ERROR((AE_INFO, "Object not a Package, type %s" , |
107 | acpi_ut_get_object_type_name(source_desc))); |
108 | return_ACPI_STATUS(AE_AML_OPERAND_TYPE); |
109 | } |
110 | |
111 | status = acpi_ds_get_package_arguments(obj_desc: source_desc); |
112 | if (ACPI_SUCCESS(status)) { |
113 | |
114 | /* Return an additional reference to the object */ |
115 | |
116 | obj_desc = source_desc; |
117 | acpi_ut_add_reference(object: obj_desc); |
118 | } |
119 | break; |
120 | |
121 | case ACPI_TYPE_BUFFER: |
122 | |
123 | if (source_desc->common.type != ACPI_TYPE_BUFFER) { |
124 | ACPI_ERROR((AE_INFO, "Object not a Buffer, type %s" , |
125 | acpi_ut_get_object_type_name(source_desc))); |
126 | return_ACPI_STATUS(AE_AML_OPERAND_TYPE); |
127 | } |
128 | |
129 | status = acpi_ds_get_buffer_arguments(obj_desc: source_desc); |
130 | if (ACPI_SUCCESS(status)) { |
131 | |
132 | /* Return an additional reference to the object */ |
133 | |
134 | obj_desc = source_desc; |
135 | acpi_ut_add_reference(object: obj_desc); |
136 | } |
137 | break; |
138 | |
139 | case ACPI_TYPE_STRING: |
140 | |
141 | if (source_desc->common.type != ACPI_TYPE_STRING) { |
142 | ACPI_ERROR((AE_INFO, "Object not a String, type %s" , |
143 | acpi_ut_get_object_type_name(source_desc))); |
144 | return_ACPI_STATUS(AE_AML_OPERAND_TYPE); |
145 | } |
146 | |
147 | /* Return an additional reference to the object */ |
148 | |
149 | obj_desc = source_desc; |
150 | acpi_ut_add_reference(object: obj_desc); |
151 | break; |
152 | |
153 | case ACPI_TYPE_INTEGER: |
154 | |
155 | if (source_desc->common.type != ACPI_TYPE_INTEGER) { |
156 | ACPI_ERROR((AE_INFO, "Object not a Integer, type %s" , |
157 | acpi_ut_get_object_type_name(source_desc))); |
158 | return_ACPI_STATUS(AE_AML_OPERAND_TYPE); |
159 | } |
160 | |
161 | /* Return an additional reference to the object */ |
162 | |
163 | obj_desc = source_desc; |
164 | acpi_ut_add_reference(object: obj_desc); |
165 | break; |
166 | |
167 | case ACPI_TYPE_BUFFER_FIELD: |
168 | case ACPI_TYPE_LOCAL_REGION_FIELD: |
169 | case ACPI_TYPE_LOCAL_BANK_FIELD: |
170 | case ACPI_TYPE_LOCAL_INDEX_FIELD: |
171 | |
172 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
173 | "FieldRead Node=%p SourceDesc=%p Type=%X\n" , |
174 | node, source_desc, entry_type)); |
175 | |
176 | status = |
177 | acpi_ex_read_data_from_field(walk_state, obj_desc: source_desc, |
178 | ret_buffer_desc: &obj_desc); |
179 | break; |
180 | |
181 | /* For these objects, just return the object attached to the Node */ |
182 | |
183 | case ACPI_TYPE_MUTEX: |
184 | case ACPI_TYPE_POWER: |
185 | case ACPI_TYPE_PROCESSOR: |
186 | case ACPI_TYPE_EVENT: |
187 | case ACPI_TYPE_REGION: |
188 | |
189 | /* Return an additional reference to the object */ |
190 | |
191 | obj_desc = source_desc; |
192 | acpi_ut_add_reference(object: obj_desc); |
193 | break; |
194 | |
195 | /* TYPE_ANY is untyped, and thus there is no object associated with it */ |
196 | |
197 | case ACPI_TYPE_ANY: |
198 | |
199 | ACPI_ERROR((AE_INFO, |
200 | "Untyped entry %p, no attached object!" , node)); |
201 | |
202 | return_ACPI_STATUS(AE_AML_OPERAND_TYPE); /* Cannot be AE_TYPE */ |
203 | |
204 | case ACPI_TYPE_LOCAL_REFERENCE: |
205 | |
206 | switch (source_desc->reference.class) { |
207 | case ACPI_REFCLASS_TABLE: /* This is a ddb_handle */ |
208 | case ACPI_REFCLASS_REFOF: |
209 | case ACPI_REFCLASS_INDEX: |
210 | |
211 | /* Return an additional reference to the object */ |
212 | |
213 | obj_desc = source_desc; |
214 | acpi_ut_add_reference(object: obj_desc); |
215 | break; |
216 | |
217 | default: |
218 | |
219 | /* No named references are allowed here */ |
220 | |
221 | ACPI_ERROR((AE_INFO, |
222 | "Unsupported Reference type 0x%X" , |
223 | source_desc->reference.class)); |
224 | |
225 | return_ACPI_STATUS(AE_AML_OPERAND_TYPE); |
226 | } |
227 | break; |
228 | |
229 | default: |
230 | |
231 | /* Default case is for unknown types */ |
232 | |
233 | ACPI_ERROR((AE_INFO, |
234 | "Node %p - Unknown object type 0x%X" , |
235 | node, entry_type)); |
236 | |
237 | return_ACPI_STATUS(AE_AML_OPERAND_TYPE); |
238 | |
239 | } /* switch (entry_type) */ |
240 | |
241 | /* Return the object descriptor */ |
242 | |
243 | *object_ptr = (void *)obj_desc; |
244 | return_ACPI_STATUS(status); |
245 | } |
246 | |